فیلد ها را وارد کنید

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

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

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

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

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

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

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

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

شناسه زبان یک مخفف عددی استاندارد بین المللی برای زبان در یک کشور یا منطقه جغرافیایی است. با Aspose.Words می توانید محلی را در سطح فیلد با استفاده از ویژگی LocaleId مشخص کنید که محلی فیلد ID را بدست می آورد یا تنظیم می کند.

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

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

اگر می خواهید فیلد های غیر تایپ شده/خالی ({}) را درست مانند Microsoft Word allows وارد کنید، می توانید از روش InsertField با پارامتر FieldType.FieldNone استفاده کنید. برای قرار دادن یک فیلد در یک سند ورد، می توانید کلید ترکیبی “Ctrl + F9” را فشار دهید.

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

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

روش جایگزین برای وارد کردن فیلد ها در Aspose.Words کلاس FieldBuilder است. این رابط کاربری روان را برای مشخص کردن سوئیچ های میدان و مقادیر استدلال به عنوان متن، گره ها یا حتی زمینه های آشیانه ای فراهم می کند.

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

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

شما همچنین می توانید انواع مختلفی از زمینه ها را با استفاده از Aspose.Words مدل شیء سند (DOM). در این بخش به چند مثال می پردازیم.

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

فیلد MERGEFIELD در سند ورد را می توان با کلاس FieldMergeField نشان داد. شما می توانید از کلاس FieldMergeField برای انجام عملیات زیر استفاده کنید:

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

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

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

فیلد ADDRESSBLOCK برای وارد کردن یک بلوک آدرس mail merge در یک سند ورد استفاده می شود. ADDRESSBLOCK فیلد در سند ورد می تواند توسط کلاس FieldAddressBlock نشان داده شود. شما می توانید از کلاس FieldAddressBlock برای انجام عملیات زیر استفاده کنید:

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

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

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

فیلد ADVANCE برای جبران متن بعدی در یک خط به سمت چپ، راست، بالا یا پایین استفاده می شود. فیلد ADVANCE در سند ورد را می توان با کلاس FieldAdvance نشان داد. شما می توانید از کلاس FieldAdvance برای انجام عملیات زیر استفاده کنید:

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

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

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

فیلد ASK برای درخواست از کاربر برای متن برای اختصاص به یک نشانه در سند ورد استفاده می شود. ASK فیلد در سند ورد می تواند توسط کلاس FieldAsk نشان داده شود. شما می توانید از کلاس FieldAsk برای انجام عملیات زیر استفاده کنید:

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

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

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

فیلد AUTHOR برای مشخص کردن نام نویسنده سند از ویژگی های Document استفاده می شود. فیلد AUTHOR در سند ورد را می توان با کلاس FieldAuthor نشان داد. شما می توانید از کلاس FieldAuthor برای انجام عملیات زیر استفاده کنید:

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

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

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

فیلد INCLUDETEXT متن و گرافیک موجود در سند نامگذاری شده در کد فیلد را وارد می کند. شما می توانید کل سند یا بخشی از سند ذکر شده توسط یک نشانک را وارد کنید. این فیلد در سند ورد با INCLUDETEXT نشان داده شده است. شما می توانید از کلاس FieldIncludeText برای انجام عملیات زیر استفاده کنید:

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

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

وارد کردن فیلد 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 ] }

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

/

نمای کلی فیلدها در C++ چگونه ویژگی های میدان را پیدا کنیم