---
title: "نمای کلی Document Builder در Python"
---

[DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) یک کلاس قدرتمند است که با [Document](https://reference.aspose.com/words/python-net/aspose.words/document/) مرتبط است و به شما امکان می دهد اسناد پویا را از ابتدا بسازید یا عناصر جدیدی را به یک موجود اضافه کنید.

[DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) روش هایی را برای درج متن، چک باکس ها، اشیاء اول، پاراگراف ها، فهرست ها، جداول، تصاویر و سایر عناصر محتوا ارائه می دهد. به شما امکان می دهد فونت ها، قالب بندی پاراگراف ها یا بخش ها را مشخص کنید و سایر عملیات ها را انجام دهید.

## Document Builder یا Aspose.Words DOM

[DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) کلاس‌ها و روش‌های موجود در Aspose.Words Document Object Model (DOM) را تکمیل می‌کند تا متداول‌ترین وظایف ساخت سند را ساده کند. یعنی شما می توانید محتوای اسناد را هم از طریق Aspose.Words DOM که نیاز به درک خوب ساختار درختی دارد و هم با استفاده از DocumentBuilder ایجاد و تغییر دهید. `DocumentBuilder` یک "نما" برای ساختار پیچیده **Document** است که به شما امکان می دهد به سرعت و به راحتی محتوا و قالب بندی را وارد کنید.

عملیاتی که با [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) امکان پذیر است، هنگام استفاده مستقیم از کلاس های Aspose.Words DOM نیز امکان پذیر است. با این حال، استفاده مستقیم از کلاس های Aspose.Words DOM معمولاً به خطوط کد بیشتری نسبت به استفاده از [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) نیاز دارد.

## پیمایش اسناد

پیمایش سند بر اساس مفهوم مکان نما مجازی است که با استفاده از روش های مختلف **DocumentBuilder.move_to_XXX** مانند [move_to_document_start](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/move_to_document_start/) و [move_to_field](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/move_to_field/) می توانید به مکان دیگری در سند بروید. هنگام فراخوانی متدهای [write](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/write/)، [writeln](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/writeln/)، [insert_break](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/insert_break/) و موارد دیگر، این مکان‌نما مجازی مکان درج متن را نشان می‌دهد. برای اطلاعات بیشتر در مورد مکان نما مجازی، مقاله زیر "ناوبری با مکان نما" را ببینید.

مثال کد زیر نحوه پیمایش به یک نشانک را نشان می دهد:

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Document-add_content_using_document_builder-MoveToBookmarkEnd.py" >}}

## ساخت و اصلاح سند

Aspose.Words API چندین کلاس را ارائه می دهد که مسئول قالب بندی عناصر مختلف یک سند هستند. هر یک از کلاس‌ها ویژگی‌های قالب‌بندی مربوط به یک عنصر سند خاص، مانند متن، پاراگراف، بخش و موارد دیگر را در بر می‌گیرد. به عنوان مثال، کلاس [Font](https://reference.aspose.com/words/python-net/aspose.words/font/) ویژگی های قالب بندی کاراکتر را نشان می دهد، کلاس [ParagraphFormat](https://reference.aspose.com/words/python-net/aspose.words/paragraphformat/) ویژگی های قالب بندی پاراگراف و غیره را نشان می دهد. اشیاء این کلاس‌ها توسط ویژگی‌های [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) مربوطه، که همان نام‌های کلاس‌ها هستند، برگردانده می‌شوند. بنابراین، می توانید به آنها دسترسی داشته باشید و قالب بندی مورد نظر را در طول ساخت سند تنظیم کنید.

همچنین می‌توانید با استفاده از روش `Write` یا هر یک از روش‌های **DocumentBuilder.insert_XXX**، مانند [insert_field](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/insert_field/)، [insert_html](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/insert_html/) و روش‌های مشابه، متن، چک باکس، شی ole، تصاویر، نشانک‌ها، فیلدهای فرم و سایر عناصر سند را در موقعیت مکان‌نما وارد کنید.

بیایید ببینیم چگونه با استفاده از [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) یک سند ساده ایجاد کنیم.

### با استفاده از DocumentBuilder یک سند ایجاد کنید

برای شروع، باید یک [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) ایجاد کنید و آن را با یک شی [Document](https://reference.aspose.com/words/python-net/aspose.words/document/) مرتبط کنید. شما یک نمونه جدید از [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) را با فراخوانی سازنده آن ایجاد می کنید و آن را به یک شی [Document](https://reference.aspose.com/words/python-net/aspose.words/document/) برای پیوست به سازنده ارسال می کنید.

برای درج یک متن، رشته متنی را که باید در سند وارد کنید به روش [write](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/write/) منتقل کنید.

مثال کد زیر نحوه ایجاد یک سند ساده با استفاده از سازنده سند را نشان می دهد.

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Document-add_content_using_document_builder-MoveToDocumentStartEnd.py" >}}

### Document Formatting را مشخص کنید

ویژگی [font](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/font/) قالب بندی متن را تعریف می کند. این شی شامل ویژگی های مختلف فونت (نام فونت، اندازه فونت، رنگ و غیره) است. برخی از ویژگی های مهم فونت نیز با ویژگی های [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) نشان داده می شوند تا به شما امکان دسترسی مستقیم به آنها را بدهند. اینها خواص بولی [Font.bold](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/bold/)، [Font.italic](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/italic/) و [Font.underline](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/underline/) هستند.

مثال کد زیر نحوه درج یک متن فرمت شده با استفاده از [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) را نشان می دهد:

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Document-add_content_using_document_builder-InsertParagraph.py" >}}

```

- [font](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/font/) قالب بندی کاراکتری را مشخص می کند که برای تمام متن درج شده از موقعیت فعلی در سند به بعد اعمال می شود.
- [paragraph_format](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/paragraph_format/) قالب بندی پاراگراف را برای جاری و تمام پاراگراف هایی که قرار است درج شوند مشخص می کند.
- [page_setup](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/page_setup/) ویژگی های صفحه و بخش را برای بخش فعلی و کل قسمتی که درج می شود مشخص می کند.
- [cell_format](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/cell_format/) و [row_format](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/row_format/) ویژگی‌های قالب‌بندی را مشخص می‌کنند که از موقعیت فعلی سند به بعد بر روی سلول‌ها و ردیف‌های جدول اعمال می‌شود.

در این وضعیت، "جریان" به معنای موقعیت، پاراگراف، بخش، سلول یا ردیفی است که مکان نما در آن قرار دارد.

```

```

توجه داشته باشید که ویژگی‌های [font](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/font/)، [paragraph_format](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/paragraph_format/) و [page_setup](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/page_setup/) هر زمان که به مکان دیگری در سند بروید به‌روزرسانی می‌شوند تا ویژگی‌های قالب‌بندی این مکان را منعکس کنند.

```