הוספת שדות

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

• שימוש DocumentBuilder
• שימוש FieldBuilder
• שימוש Aspose.Words מודל אובייקט מסמך (DOM)

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

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

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

אם לקוד השדה שלך יש פרמטר המכיל רווח, עליו להיות מוקף בסימני דיבור. אחרת השדה בשני Microsoft Word ו Aspose.Words לא יכול לעבוד כצפוי כמו הפרמטר מטופל על ידי שניהם כמו להיות מקוצר

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

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

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

ציין אזור ברמת השדה

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

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

הכנס שדה לא מקליד / ריק

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

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

הוספת שדות למסמך באמצעות FieldBuilder

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

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

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

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

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

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

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

לפרטים נוספים, ראה את FieldMergeField כיתה API.

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

ניתן להוריד את קובץ המדגם של דוגמה זו מ Aspose.Words GitHub.

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

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

• ציין אם לכלול את שם המדינה/האזור בשדה
• ציין אם לעצב את הכתובת בהתאם למדינה / אזור הנמען כפי שהוגדר על ידי POST * CODE (איחוד הדואר האוניברסלי 2006)
• ציין את שם המדינה/האזור שלא נכלל
• ציין את תבנית השם והכתובת
• ציין את השפה ID המשמשת לעיצוב הכתובת

לפרטים נוספים, ראה את FieldAddressBlock כיתה API.

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

ניתן להוריד את קובץ המדגם של דוגמה זו מ Aspose.Words GitHub.

הוספת שדה מראש למסמך ללא שימוש DocumentBuilder

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

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

לפרטים נוספים, ראה את FieldAdvance כיתה API.

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

ניתן להוריד את קובץ המדגם של דוגמה זו מ Aspose.Words GitHub.

הוספת שדה ASK למסמך ללא שימוש DocumentBuilder

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

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

לפרטים נוספים, ראה את FieldAsk כיתה API.

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

ניתן להוריד את קובץ המדגם של דוגמה זו מ Aspose.Words GitHub.

הוספת שדה AUTHOR למסמך ללא שימוש DocumentBuilder

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

• ציין את שם מחבר המסמך

לפרטים נוספים, ראה את FieldAuthor כיתה API.

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

ניתן להוריד את קובץ המדגם של דוגמה זו מ Aspose.Words GitHub.

הוספת שדה INCLUDETEXT למסמך ללא שימוש DocumentBuilder

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

• ציין את שם הסימנייה של המסמך הכלול
• ציין את מיקום המסמך

לפרטים נוספים, ראה את FieldIncludeText כיתה API.

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

הוספת שדה TOA למסמך ללא שימוש DocumentBuilder

השדה TOA (Table of Authorities) בונה ומכניס טבלת רשויות. השדה TOA אוסף ערכים המסומנים בשדות TA (Table of Authorities Entry). Microsoft משרד Word מוסיף את השדה TOA כאשר אתה לוחץ על Insert Table of Authorities בקבוצה Table of Authorities בכרטיסייה References. כשאתה מציג את השדה TOA במסמך שלך, התחביר נראה כך:

{ TOA [Switches ] }

לפרטים נוספים, ראה את FieldToa כיתה API.

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

/