نمای کلی Document Builder
DocumentBuilder یک کلاس قدرتمند است که با Document مرتبط است و به شما امکان می دهد اسناد پویا را از ابتدا بسازید یا عناصر جدیدی را به یک موجود اضافه کنید.
DocumentBuilder روش هایی را برای درج متن، چک باکس ها، اشیاء اول، پاراگراف ها، فهرست ها، جداول، تصاویر و سایر عناصر محتوا ارائه می دهد. به شما امکان می دهد فونت ها، قالب بندی پاراگراف ها یا بخش ها را مشخص کنید و سایر عملیات ها را انجام دهید.
Document Builder یا Aspose.Words DOM
DocumentBuilder کلاس‌ها و روش‌های موجود در Aspose.Words Document Object Model (DOM) را تکمیل می‌کند تا متداول‌ترین وظایف ساخت سند را ساده کند. یعنی شما می توانید محتوای اسناد را هم از طریق Aspose.Words DOM که نیاز به درک خوب ساختار درختی دارد و هم با استفاده از DocumentBuilder ایجاد و تغییر دهید. DocumentBuilder یک “نما” برای ساختار پیچیده Document است که به شما امکان می دهد به سرعت و به راحتی محتوا و قالب بندی را وارد کنید.
عملیاتی که با DocumentBuilder امکان پذیر است، هنگام استفاده مستقیم از کلاس های Aspose.Words DOM نیز امکان پذیر است. با این حال، استفاده مستقیم از کلاس های Aspose.Words DOM معمولاً به خطوط کد بیشتری نسبت به استفاده از DocumentBuilder نیاز دارد.
پیمایش اسناد
پیمایش سند بر اساس مفهوم مکان نما مجازی است که با استفاده از روش های مختلف DocumentBuilder.MoveToXXX مانند MoveToDocumentStart و MoveToField می توانید به مکان دیگری در سند بروید. هنگام فراخوانی متدهای Write، Writeln، InsertBreak و موارد دیگر، این مکان‌نما مجازی مکان درج متن را نشان می‌دهد. برای اطلاعات بیشتر در مورد مکان نما مجازی، مقاله زیر “ناوبری با مکان نما” را ببینید.
مثال کد زیر نحوه پیمایش به یک نشانک را نشان می دهد:
ساخت و اصلاح سند
Aspose.Words API چندین کلاس را ارائه می دهد که مسئول قالب بندی عناصر مختلف یک سند هستند. هر یک از کلاس‌ها ویژگی‌های قالب‌بندی مربوط به یک عنصر سند خاص، مانند متن، پاراگراف، بخش و موارد دیگر را در بر می‌گیرد. به عنوان مثال، کلاس Font ویژگی های قالب بندی کاراکتر را نشان می دهد، کلاس ParagraphFormat ویژگی های قالب بندی پاراگراف و غیره را نشان می دهد. اشیاء این کلاس‌ها توسط ویژگی‌های DocumentBuilder مربوطه، که همان نام‌های کلاس‌ها هستند، برگردانده می‌شوند. بنابراین، می توانید به آنها دسترسی داشته باشید و قالب بندی مورد نظر را در طول ساخت سند تنظیم کنید.
همچنین می‌توانید با استفاده از روش Write یا هر یک از روش‌های DocumentBuilder.InsertXXX، مانند InsertField، InsertHtml و روش‌های مشابه، متن، چک باکس، شی ole، تصاویر، نشانک‌ها، فیلدهای فرم و سایر عناصر سند را در موقعیت مکان‌نما وارد کنید.
بیایید ببینیم چگونه با استفاده از DocumentBuilder یک سند ساده ایجاد کنیم.
با استفاده از DocumentBuilder یک سند ایجاد کنید
برای شروع، باید یک DocumentBuilder ایجاد کنید و آن را با یک شی Document مرتبط کنید. شما یک نمونه جدید از DocumentBuilder را با فراخوانی سازنده آن ایجاد می کنید و آن را به یک شی Document برای پیوست به سازنده ارسال می کنید.
برای درج یک متن، رشته متنی را که باید در سند وارد کنید به روش Write منتقل کنید.
مثال کد زیر نحوه ایجاد یک سند ساده با استفاده از سازنده سند را نشان می دهد.
Document Formatting را مشخص کنید
ویژگی Font قالب بندی متن را تعریف می کند. این شی شامل ویژگی های مختلف فونت (نام فونت، اندازه فونت، رنگ و غیره) است. برخی از ویژگی های مهم فونت نیز با ویژگی های DocumentBuilder نشان داده می شوند تا به شما امکان دسترسی مستقیم به آنها را بدهند. اینها خواص بولی Font.Bold، Font.Italic و Font.Underline هستند.
مثال کد زیر نحوه درج یک متن فرمت شده با استفاده از DocumentBuilder را نشان می دهد:
- Font قالب‌بندی کاراکتری را مشخص می‌کند که برای تمام متن درج شده از موقعیت فعلی در سند به بعد اعمال می‌شود.
- ParagraphFormat قالب بندی پاراگراف را برای جاری و تمام پاراگراف هایی که قرار است درج شوند مشخص می کند.
- PageSetup ویژگی های صفحه و بخش را برای بخش فعلی و کل قسمتی که درج می شود مشخص می کند.
- CellFormat و RowFormat ویژگی‌های قالب‌بندی را مشخص می‌کنند که از موقعیت فعلی سند به بعد بر روی سلول‌ها و ردیف‌های جدول اعمال می‌شود.
در این وضعیت، “جریان” به معنای موقعیت، پاراگراف، بخش، سلول یا ردیفی است که مکان نما در آن قرار دارد.