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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

فیلد COMPARE دو مقدار را مقایسه می کند و مقدار عددی 1 را اگر مقایسه درست باشد یا 0 را اگر مقایسه غلط باشد، باز می گرداند.

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

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

فیلد IF می تواند برای ارزیابی استدلال ها به صورت مشروط استفاده شود.

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

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

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

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

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

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

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

MERGEFIELD field in Word document can be represented by the FieldMergeField class. You can use FieldMergeField class to perform the following operations:

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

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

وارد کردن فیلد Mail Merge ADDRESSBLOCK به یک سند با استفاده از 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 به یک پاراگراف در یک سند اضافه کنید.

معرفی رشته ها در Java چگونه ویژگی های میدان را پیدا کنیم