---
title: "فیلد ها را در C++وارد کنید"
---


روش های مختلفی برای وارد کردن فیلد ها به یک سند وجود دارد:

- با استفاده از [DocumentBuilder](https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/)
- با استفاده از [FieldBuilder](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldbuilder/)
- استفاده از [Aspose.Words مدل شیء سند (DOM)](/words/fa/cpp/aspose-words-document-object-model/)

در این مقاله، ما به هر جهت با جزئیات بیشتری نگاه خواهیم کرد و نحوه وارد کردن زمینه های خاص با استفاده از این گزینه ها را تجزیه و تحلیل خواهیم کرد.

## وارد کردن فیلد ها به یک سند با استفاده از DocumentBuilder

در Aspose.Words روش [InsertField](https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/insertfield/) برای وارد کردن فیلد های جدید به یک سند استفاده می شود. پارامتر اول کد کامل فیلد فیلد را که باید وارد شود قبول می کند. پارامتر دوم اختیاری است و اجازه می دهد تا نتیجه فیلد فیلد به صورت دستی تنظیم شود. اگر این عرضه نشده باشد، این فیلد به طور خودکار به روز می شود. شما می توانید null یا empty را به این پارامتر منتقل کنید تا یک فیلد با یک مقدار فیلد خالی را وارد کنید. اگر در مورد نحو کد فیلد خاص مطمئن نیستید، ابتدا فیلد را در Microsoft Word ایجاد کنید و برای دیدن کد فیلد آن تغییر دهید.

{{% alert color="primary" %}}

اگر کد فیلد شما دارای پارامتر حاوی یک فضای است، باید در علامت های گفتاری قرار گیرد. در غیر این صورت، فیلد در هر دو Microsoft Word و Aspose.Words ممکن است به عنوان انتظار کار نکند زیرا پارامتر توسط هر دو به عنوان قطع شده در نظر گرفته می شود

{{% /alert %}}

مثال کد زیر نشان می دهد که چگونه یک فیلد ادغام را با استفاده از **DocumentBuilder**در یک سند وارد کنید:

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "Examples-DocsExamples-source-Programming with Documents-Working with Fields-InsertField.h" >}}

همین تکنیک برای قرار دادن فیلد هایی که در داخل فیلد های دیگر قرار دارند استفاده می شود.

مثال کد زیر نشان می دهد که چگونه فیلد های آشیانه شده در یک فیلد دیگر را با استفاده از **DocumentBuilder**وارد کنید:

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "cpp-Programming-Documents-Fields-InsertNestedFields-InsertNestedFields.cpp" >}}

### محل را در سطح میدان مشخص کنید

شناسه زبان یک مخفف عددی استاندارد بین المللی برای زبان در یک کشور یا منطقه جغرافیایی است. با Aspose.Words می توانید محلی را در سطح فیلد با استفاده از ویژگی [LocaleId](https://reference.aspose.com/words/cpp/aspose.words.fields/field/get_localeid/) مشخص کنید که محلی فیلد ID را بدست می آورد یا تنظیم می کند.

مثال کد زیر نشان می دهد که چگونه از این گزینه استفاده کنید:

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "cpp-Programming-Documents-Fields-SpecifylocaleAtFieldlevel-SpecifylocaleAtFieldlevel.cpp" >}}

### فیلد غیر تایپ شده / خالی را وارد کنید

اگر می خواهید فیلد های غیر تایپ شده/خالی ({}) را درست مانند Microsoft Word allows وارد کنید، می توانید از روش [InsertField](https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/insertfield) با پارامتر [FieldType.FieldNone](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldtype/) استفاده کنید. برای قرار دادن یک فیلد در یک سند ورد، می توانید کلید ترکیبی "Ctrl + F9" را فشار دهید.

مثال کد زیر نشان می دهد که چگونه یک فیلد خالی را در سند وارد کنید:

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "cpp-Programming-Documents-Fields-InsertFieldNone-InsertFieldNone.cpp" >}}

## وارد کردن فیلد ها به یک سند با استفاده از FieldBuilder

روش جایگزین برای وارد کردن فیلد ها در Aspose.Words کلاس [FieldBuilder](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldbuilder/) است. این رابط کاربری روان را برای مشخص کردن سوئیچ های میدان و مقادیر استدلال به عنوان متن، گره ها یا حتی زمینه های آشیانه ای فراهم می کند.

مثال کد زیر نشان می دهد که چگونه یک فیلد را با استفاده از **FieldBuilder**در یک سند وارد کنید:

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "cpp-Programming-Documents-Fields-InsertFieldUsingFieldBuilder-InsertFieldUsingFieldBuilder.cpp" >}}

## وارد کردن فیلد ها با استفاده از DOM

شما همچنین می توانید انواع مختلفی از زمینه ها را با استفاده از [Aspose.Words مدل شیء سند (DOM)](/words/fa/cpp/aspose-words-document-object-model/). در این بخش به چند مثال می پردازیم.

### وارد کردن فیلد ادغام به یک سند با استفاده از DOM

فیلد `MERGEFIELD` در سند ورد را می توان با کلاس [FieldMergeField](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldmergefield/) نشان داد. شما می توانید از کلاس **FieldMergeField** برای انجام عملیات زیر استفاده کنید:

- نام فیلد ادغام را مشخص کنید
- قالب بندی فیلد ادغام را مشخص کنید
- متن بین جدا کننده فیلد و انتهای فیلد فیلد ادغام را مشخص کنید
- متن وارد شده پس از فیلد ادغام را مشخص کنید اگر فیلد خالی نباشد
- متن وارد شده قبل از فیلد ادغام را مشخص کنید اگر فیلد خالی نباشد

{{% alert color="primary" %}}

برای جزئیات بیشتر، به کلاس [FieldMergeField](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldmergefield/) API مراجعه کنید.

{{% /alert %}}

مثال کد زیر نشان می دهد که چگونه فیلد `MERGE` را با استفاده از DOM به یک پاراگراف در یک سند اضافه کنید:

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "cpp-Programming-Documents-Fields-InsertMergeFieldUsingDOM-InsertMergeFieldUsingDOM.cpp" >}}

{{% alert color="primary" %}}

شما می توانید فایل نمونه این مثال را از [Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-C/tree/master/Examples).

{{% /alert %}}

### وارد کردن فیلد بلوک آدرس Mail Merge به یک سند با استفاده از DOM

فیلد `ADDRESSBLOCK` برای وارد کردن یک بلوک آدرس Mail Merge در یک سند ورد استفاده می شود. `ADDRESSBLOCK` فیلد در سند ورد می تواند توسط کلاس [FieldAddressBlock](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldaddressblock/) نشان داده شود. شما می توانید از کلاس **FieldAddressBlock** برای انجام عملیات زیر استفاده کنید:

- مشخص کنید که آیا نام کشور/منطقه را در این زمینه قرار دهید یا خیر
- مشخص کنید که آیا آدرس را با توجه به کشور/منطقه گیرنده به عنوان تعریف شده توسط POST*CODE قالب بندی کنید (اتحادیه جهانی پست 2006)
- نام کشور/منطقه حذف شده را مشخص کنید
- نام و قالب آدرس را مشخص کنید
- زبان ID مورد استفاده برای قالب بندی آدرس را مشخص کنید

{{% alert color="primary" %}}

برای جزئیات بیشتر، به کلاس [FieldAddressBlock](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldaddressblock/) API مراجعه کنید.

{{% /alert %}}

مثال کد زیر نشان می دهد که چگونه فیلد Mail Merge `ADDRESSBLOCK` را با استفاده از DOM به یک پاراگراف در یک سند اضافه کنید:

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "cpp-Programming-Documents-Fields-InsertMailMergeAddressBlockFieldUsingDOM-InsertMailMergeAddressBlockFieldUsingDOM.cpp" >}}

{{% alert color="primary" %}}

شما می توانید فایل نمونه این مثال را از [Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-C/tree/master/Examples).

{{% /alert %}}

### وارد کردن فیلد Advance به یک سند بدون استفاده از DocumentBuilder

فیلد `ADVANCE` برای جبران متن بعدی در یک خط به سمت چپ، راست، بالا یا پایین استفاده می شود. فیلد `ADVANCE` در سند ورد را می توان با کلاس [FieldAdvance](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldadvance/) نشان داد. شما می توانید از کلاس FieldAdvance برای انجام عملیات زیر استفاده کنید:

- تعداد نقاطی را که متن زیر از فیلد به صورت عمودی از لبه بالای صفحه منتقل می شود مشخص کنید
- تعداد نقاطی را که متن زیر از فیلد به صورت افقی از لبه چپ ستون، قاب یا جعبه متن منتقل می شود مشخص کنید
- تعداد نقاطی را که متن زیر از فیلد باید به چپ، راست، بالا یا پایین منتقل شود مشخص کنید

{{% alert color="primary" %}}

برای جزئیات بیشتر، به کلاس [FieldAdvance](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldadvance/) API مراجعه کنید.

{{% /alert %}}

مثال کد زیر نشان می دهد که چگونه فیلد `ADVANCE` را با استفاده از DOM به یک پاراگراف در یک سند اضافه کنید:

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "cpp-Programming-Documents-Fields-InsertAdvanceFieldWithoutDocumentBuilder-InsertAdvanceFieldWithoutDocumentBuilder.cpp" >}}

{{% alert color="primary" %}}

شما می توانید فایل نمونه این مثال را از [Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-C/tree/master/Examples).

{{% /alert %}}

### وارد کردن فیلد `ASK` به یک سند بدون استفاده از DocumentBuilder

فیلد `ASK` برای درخواست از کاربر برای متن برای اختصاص به یک نشانه در سند ورد استفاده می شود. `ASK` فیلد در سند ورد می تواند توسط کلاس [FieldAsk](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldask/) نشان داده شود. شما می توانید از کلاس **FieldAsk** برای انجام عملیات زیر استفاده کنید:

- نام نشانک را مشخص کنید
- مشخص کردن پاسخ پیش فرض کاربر (ارزش اولیه موجود در پنجره prompt)
- مشخص کنید که آیا پاسخ کاربر باید یک بار در هر عملیات Mail Merge دریافت شود
- متن prompt (عنوان پنجره prompt) را مشخص کنید

{{% alert color="primary" %}}

برای جزئیات بیشتر، به کلاس [FieldAsk](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldask) API مراجعه کنید.

{{% /alert %}}

مثال کد زیر نشان می دهد که چگونه فیلد `ASK` را با استفاده از DOM به یک پاراگراف در یک سند اضافه کنید:

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "cpp-Programming-Documents-Fields-InsertASKFieldWithoutDocumentBuilder-InsertASKFieldWithoutDocumentBuilder.cpp" >}}

{{% alert color="primary" %}}

شما می توانید فایل نمونه این مثال را از [Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-C/tree/master/Examples).

{{% /alert %}}

### وارد کردن فیلد `AUTHOR` به یک سند بدون استفاده از DocumentBuilder

فیلد `AUTHOR` برای مشخص کردن نام نویسنده سند از ویژگی های `Document` استفاده می شود. فیلد `AUTHOR` در سند ورد را می توان با کلاس [FieldAuthor](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldauthor/) نشان داد. شما می توانید از کلاس **FieldAuthor** برای انجام عملیات زیر استفاده کنید:

- نام نویسنده سند را مشخص کنید

{{% alert color="primary" %}}

برای جزئیات بیشتر، به کلاس [FieldAuthor](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldauthor/) API مراجعه کنید.

{{% /alert %}}

مثال کد زیر نشان می دهد که چگونه فیلد `AUTHOR` را با استفاده از DOM به یک پاراگراف در یک سند اضافه کنید:

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "cpp-Programming-Documents-Fields-InsertAuthorField-InsertAuthorField.cpp" >}}

{{% alert color="primary" %}}

شما می توانید فایل نمونه این مثال را از [Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-C/tree/master/Examples).

{{% /alert %}}

### وارد کردن فیلد `INCLUDETEXT` به یک سند بدون استفاده از DocumentBuilder

فیلد `INCLUDETEXT` متن و گرافیک موجود در سند نامگذاری شده در کد فیلد را وارد می کند. شما می توانید کل سند یا بخشی از سند ذکر شده توسط یک نشانک را وارد کنید. این فیلد در سند ورد با INCLUDETEXT نشان داده شده است. شما می توانید از کلاس [FieldIncludeText](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldincludetext/) برای انجام عملیات زیر استفاده کنید:

- نام علامت گذاری سند همراه را مشخص کنید
- محل سند را مشخص کنید

{{% alert color="primary" %}}

برای جزئیات بیشتر، به کلاس [FieldIncludeText](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldincludetext/) API مراجعه کنید.

{{% /alert %}}

مثال کد زیر نشان می دهد که چگونه فیلد `INCLUDETEXT` را با استفاده از DOM به یک پاراگراف در یک سند اضافه کنید:

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "Examples-DocsExamples-source-Programming with Documents-Working with Fields-InsertFieldIncludeTextWithoutDocumentBuilder.h" >}}

### وارد کردن فیلد `TOA` به یک سند بدون استفاده از DocumentBuilder

میدان `TOA` (*Table of Authorities*) یک جدول از مقامات را می سازد و وارد می کند. فیلد `TOA` ورودی هایی را که با فیلد های `TA` (*Table of Authorities Entry*) مشخص شده اند جمع آوری می کند. Microsoft Office Word فیلد `TOA` را وارد می کند وقتی روی *Insert Table of Authorities* در گروه **Table of Authorities** در برگه **References** کلیک می کنید. وقتی فیلد `TOA` را در سند خود مشاهده می کنید، نحو به این شکل است:

{ `TOA` [Switches ] }

{{% alert color="primary" %}}

برای جزئیات بیشتر، به کلاس [FieldToa](https://reference.aspose.com/words/cpp/aspose.words.fields/fieldtoa/) API مراجعه کنید.

{{% /alert %}}

مثال کد زیر نشان می دهد که چگونه فیلد `TOA` را با استفاده از DOM به یک پاراگراف در یک سند اضافه کنید:

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "cpp-Programming-Documents-Fields-InsertTOAFieldWithoutDocumentBuilder-InsertTOAFieldWithoutDocumentBuilder.cpp" >}}/