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