הכניסו שדות

ישנן מספר דרכים שונות להכניס שדות למסמך:

במאמר זה, נבחן כל דרך בפירוט רב יותר לנתח כיצד להכניס שדות מסוימים באמצעות אפשרויות אלה.

הכנסת שדות לתוך מסמך באמצעות DocumentBuilder

In In In Aspose.Words The The [InsertField](https://reference.aspose.com/words/java/com.aspose.words/DocumentBuilder#insertField(int,boolean)שיטה משמשת להכניס שדות חדשים למסמך. הפרמטר הראשון מקבל את קוד השדה המלא של השדה להיות מוכנס. הפרמטר השני הוא אופציונלי ומאפשר את תוצאת השדה להיות מוגדר באופן ידני. אם זה לא מסופק אז השדה עודכן באופן אוטומטי. אתה יכול לעבור אפס או ריק לפרמטר זה כדי להוסיף שדה עם ערך שדה ריק. אם אתה לא בטוח לגבי syntax קוד שדה מסוים, ליצור את השדה Microsoft Word קודם כל לעבור לראות את קוד השדה שלו.

הדוגמה הבאה של הקוד מראה כיצד להכניס שדה מיזוג למסמך באמצעות שימוש DocumentBuilder:

אותה טכניקה משמשת כדי להכניס שדות מקונן בתחומים אחרים.

הדוגמה הבאה של הקוד ממחישה כיצד להכניס שדות הקן בתוך שדה אחר באמצעות שימוש DocumentBuilder:

המונחים: Field Level

מזהה שפה הוא קיצור בינלאומי סטנדרטי לשפה במדינה או באזור גיאוגרפי. עם Aspose.Words, באפשרותך לציין את המקומיים ברמת השדה באמצעות LocaleId רכוש, אשר מקבל או מגדיר את מזהה המקומי של השדה.

דוגמה לקוד הבא מראה כיצד להשתמש באפשרות זו:

המונחים: Untyped / Empty Field

אם אתה רוצה להוסיף שדות לא מטיפוס / mpty ({}בדיוק כמו Microsoft Word מאפשר, אתה יכול להשתמש InsertField שיטה עם FieldType.FieldNone פרמטר כדי להכניס שדה לתוך מסמך Word, אתה יכול ללחוץ על “Ctrl + F9” שילוב מפתח.

הדוגמה הבאה של הקוד מראה כיצד להכניס שדה ריק לתוך המסמך:

הכנס COMPARE שדה

The The The COMPARE השדה משווה שני ערכים ומחזיר את הערך המספרי 1 אם ההשוואה היא true 0 אם ההשוואה היא false.

דוגמה לקוד הבא מראה כיצד להוסיף COMPARE שדות באמצעות DocumentBuilder:

הכנס IF שדה

The The The IF ניתן להשתמש בשדה כדי להעריך טענות באופן תנאי.

דוגמה לקוד הבא מראה כיצד להוסיף IF שדות באמצעות DocumentBuilder:

הכנסת שדות לתוך מסמך באמצעות שדה בונה

דרך חלופית להכניס שדות Aspose.Words הוא FieldBuilder מעמד. הוא מספק ממשק שוטה כדי לציין מתגי שדה וערכי טיעון כטקסט, צמתים או אפילו שדות מקונן.

הדוגמה הבאה של הקוד מראה כיצד להכניס שדה לתוך מסמך באמצעות FieldBuilder:

הכנסת שדות באמצעות DOM

ניתן גם להוסיף סוגים שונים של שדות באמצעות Aspose.Words Document Object Model (DOM). בחלק זה נבחן כמה דוגמאות.

תגית: Merge שדה לתוך מסמך באמצעות DOM

MERGEFIELD שדה במסמך Word יכול להיות מיוצג על ידי FieldMergeField מעמד. אתה יכול להשתמש FieldMergeField לבצע את הפעולות הבאות:

  • שם שדה המיזוג
  • ציין את הפורמט של שדה המיזוג
  • ציין את הטקסט כי הוא בין שדה מפריד לקצה השדה של שדה המיזוג
  • ציין את הטקסט להיות מוכנס לאחר שדה המיזוג אם השדה אינו ריק
  • ציין את הטקסט להיות מוכנס לפני שדה המיזוג אם השדה אינו ריק

דוגמה לקוד הבא מראה כיצד להוסיף MERGE שדה באמצעות DOM לפסקה במסמך:

הכנסת Mail Merge ADDRESSBLOCK שדה לתוך מסמך באמצעות DOM

The The The ADDRESSBLOCK שדה משמש כדי להוסיף Mail Merge כתובת בלוק במסמך Word ADDRESSBLOCK שדה במסמך Word יכול להיות מיוצג על ידי FieldAddressBlock מעמד. אתה יכול להשתמש FieldAddressBlock לבצע את הפעולות הבאות:

  • ציין אם לכלול את שם המדינה/אזור בשדה
  • ציין אם לעצב את הכתובת לפי המדינה / הרגולציה של המקבל כפי שהוגדר על ידי POST*CODE (Universal Postal Union 2006)
  • שם המדינה /region
  • מפרט את שם וכתובת
  • ציין את מזהה השפה המשמש כדי לעצב את הכתובת

דוגמה לקוד הבא מראה כיצד להוסיף Mail Merge ADDRESSBLOCK שדה באמצעות DOM לפסקה במסמך:

הכנסת ADVANCE שטח אל תוך מסמך מבלי להשתמש ב- DocumentBuilder

The The The ADVANCE שדה משמש כדי להתחיל טקסט לאחר מכן בתוך קו לשמאל, ימין, למעלה או למטה. ADVANCE שדה במסמך Word יכול להיות מיוצג על ידי FieldAdvance מעמד. אתה יכול להשתמש FieldAdvance שיעור ביצוע הפעולות הבאות:

  • ציין את מספר הנקודות שבאמצעותו הטקסט עוקב אחר השדה צריך לעבור אנכי מן הקצה העליון של הדף
  • ציין את מספר הנקודות שלפיו הטקסט עוקב אחר השדה צריך לעבור אופקית מן הקצה השמאלי של העמודה, המסגרת, או תיבת טקסט
  • ציין את מספר הנקודות שעל פיו יש להעביר את הטקסט, ימין, למעלה או למטה

דוגמה לקוד הבא מראה כיצד להוסיף ADVANCE שדה באמצעות DOM לפסקה במסמך:

הכנסת ASK שטח אל תוך מסמך מבלי להשתמש ב- DocumentBuilder

The The The ASK שדה משמש כדי להניע את המשתמש לטקסט כדי להקצות לסימן ספר במסמך Word. ASK שדה במסמך Word יכול להיות מיוצג על ידי FieldAsk מעמד. אתה יכול להשתמש FieldAsk שיעור ביצוע הפעולות הבאות:

  • שם הספר
  • ציין תגובה למשתמש ברירת מחדל (ערך חיוני הכלול בחלון המהיר)
  • ציין האם יש לקבל את תגובת המשתמש פעם אחת לכל Mail Merge המבצע
  • ציין את הטקסט המהיר (שם החלון המהיר)

דוגמה לקוד הבא מראה כיצד להוסיף ASK שדה באמצעות DOM לפסקה במסמך:

הכנסת AUTHOR שטח אל תוך מסמך מבלי להשתמש ב- DocumentBuilder

The The The AUTHOR שדה משמש כדי לציין את שם המחבר של המסמך מן Document תכונות. AUTHOR שדה במסמך Word יכול להיות מיוצג על ידי FieldAuthor מעמד. אתה יכול להשתמש FieldAuthor שיעור ביצוע הפעולות הבאות:

  • שם המחבר

דוגמה לקוד הבא מראה כיצד להוסיף AUTHOR שדה באמצעות DOM לפסקה במסמך:

הכנסת INCLUDETEXT שטח אל תוך מסמך מבלי להשתמש ב- DocumentBuilder

The The The INCLUDETEXT שדה מוסיף את הטקסט והגרפיקה הכלולים במסמך בשם קוד השדה. באפשרותך להוסיף את המסמך כולו או חלק מהמסמכים המוזכרים בסימן ספר. שדה זה במסמך Word מיוצג על ידי INCLUDETEXT. אתה יכול להשתמש FieldIncludeText שיעור ביצוע הפעולות הבאות:

  • שם הספר של המסמך
  • לציין את המיקום של המסמך

דוגמה לקוד הבא מראה כיצד להוסיף INCLUDETEXT שדה באמצעות DOM לפסקה במסמך:

הכנסת TOA שטח אל תוך מסמך מבלי להשתמש ב- DocumentBuilder

The The The TOA (אפשרות הרשויות*) בונה ומכניסת שולחן של רשויות. The The The TOA שדה אוסף ערכים המסומנים על ידי TA (אפשרות כניסה לרשויות) Microsoft Office Word מוסיף TOA שדה בעת לחיצה על *שולחן אינסטלציה של הרשויות * **שולחן הרשויות** הקבוצה על **References** הכרטיסיה כשאתם רואים את TOA שדה במסמך שלך, הסינמס נראה כך:

{ TOA [Switches ] }

דוגמה לקוד הבא מראה כיצד להוסיף TOA שדה באמצעות DOM לפסקה במסמך.