סקירה כללית של בונה מסמכים
DocumentBuilder הוא מעמד רב עוצמה המקשר עם Document ומאפשר לך לבנות מסמכים דינמיים מאפס או להוסיף אלמנטים חדשים לאחד קיים.
DocumentBuilder
בונה מסמכים או Aspose.Words DOM
DocumentBuilder
פעולות אפשריות עם DocumentBuilder אפשריות גם כאשר משתמשים בכיתות של Aspose.Words DOM ישירות. עם זאת, באמצעות Aspose.Words DOM כיתות ישירות בדרך כלל דורש יותר שורות קוד מאשר באמצעות DocumentBuilder.
ניווט במסמכים
ניווט במסמכים מבוסס על הרעיון של סמן וירטואלי, איתו ניתן לעבור למיקום אחר במסמך בשיטות שונות DocumentBuilder.MoveToXXX כגון MoveToDocumentStart ו MoveToField. סמן וירטואלי זה מציין היכן יוכנס הטקסט בעת התקשרות לשיטות Write, Writeln, InsertBreak, ואחרים.
דוגמת הקוד הבאה מראה כיצד לנווט לסימניה:
בניית מסמכים ושינוי
Aspose.Words API מספק מספר מחלקות האחראיות על עיצוב אלמנטים שונים של מסמך. כל אחת מהכיתות מכילה מאפייני עיצוב הקשורים לאלמנט מסמך ספציפי, כגון טקסט, פיסקה, קטע ואחרים. לדוגמה, המחלקה Font מייצגת מאפייני עיצוב תווים, המחלקה ParagraphFormat מייצגת מאפייני עיצוב פסקאות וכן הלאה. אובייקטים של מחלקות אלה מוחזרים על ידי המאפיינים המתאימים DocumentBuilder, שיש להם את אותם שמות כמו המחלקות. לכן, אתה יכול לגשת אליהם ולהגדיר את העיצוב הרצוי במהלך בניית המסמך.
ניתן גם להוסיף טקסט, checkbox, אובייקט אולה, תמונות, סימניות, שדות טופס ורכיבי מסמך אחרים במיקום הסמן באמצעות שיטת Write או כל אחת מהשיטות DocumentBuilder.InsertXXX, כגון InsertField, InsertHtml ושיטות דומות.
בואו נראה כיצד ליצור מסמך פשוט באמצעות DocumentBuilder.
צור מסמך באמצעות DocumentBuilder
כדי להתחיל, עליך ליצור DocumentBuilder ולשייך אותו לאובייקט Document. אתה יוצר מופע חדש של DocumentBuilder על ידי התקשרות לבנאי שלו ומעביר אותו לאובייקט Document לצורך התקשרות לבונה.
כדי להוסיף טקסט, העבר את מחרוזת הטקסט שעליך להכניס למסמך לשיטה Write.
דוגמת הקוד הבאה מראה כיצד ליצור מסמך פשוט באמצעות בונה מסמכים.
ציין עיצוב מסמך
המאפיין Font מגדיר עיצוב טקסט. אובייקט זה מכיל תכונות גופן שונות (שם גופן, גודל גופן, צבע וכן הלאה). כמה תכונות גופן חשובות מיוצגות גם על ידי DocumentBuilder מאפיינים כדי לאפשר לך לגשת אליהם ישירות. אלה הם Font.Bold, Font.Italic, ו Font.Underline תכונות בוליאניות.
דוגמת הקוד הבאה מראה כיצד להוסיף טקסט מעוצב באמצעות DocumentBuilder:
- Font מציין את עיצוב התווים שיוחל על כל הטקסט שהוכנס מהמיקום הנוכחי במסמך ואילך.
- ParagraphFormat מציין את עיצוב הפיסקה עבור הפסקאות הנוכחיות וכל הפסקאות שיוכנסו.
- PageSetup מציין את מאפייני הדף והקטע עבור הקטע הנוכחי ואת כל הקטע שיוכנס.
- CellFormat ו RowFormat ציין מאפייני עיצוב שיוחלו על תאי טבלה ושורות מהמיקום הנוכחי במסמך ואילך.
במצב זה," זרם " פירושו המיקום, הפסקה, הקטע, התא או השורה שבהם נמצא הסמן.