Document Builder
DocumentBuilder הוא מעמד חזק שקושר עם Document ומאפשר לך לבנות מסמכים דינמיים מאפס או להוסיף אלמנטים חדשים לאחד קיים.
DocumentBuilder מספק שיטות כדי להוסיף טקסט, צ’קוקס, אובייקטים ole, פסקאות, רשימות, טבלאות, תמונות ואלמנטים אחרים של תוכן. זה מאפשר לך לציין גופנים, סעיף או סעיף פורמט, ולבצע פעולות אחרות.
בונה מסמכים או Aspose.Words DOM
DocumentBuilder משלים שיעורים ושיטות זמינים Aspose.Words Document Object Model ()DOMכדי לפשט את משימות בניית המסמכים הנפוצות ביותר. כלומר, אתה יכול ליצור ולשנות את התוכן של מסמכים הן דרך Aspose.Words DOMאשר דורש הבנה טובה של מבנה העץ, ושימוש ב- DocumentBuilder. The The The DocumentBuilder הוא “מסעדה” למורכב Document מבנה המאפשר לך להכניס במהירות ובקלות תוכן ופורמטיקה.
פעולות אפשריות עם DocumentBuilder ניתן גם כאשר משתמשים בכיתות של Aspose.Words DOM ישירות. עם זאת, באמצעות Aspose.Words DOM שיעורים בדרך כלל דורשים יותר שורות קוד מאשר שימוש DocumentBuilder.
מסמך ניווט
ניווט מסמכים מבוסס על הרעיון של קידוד וירטואלי, שבו אתה יכול לעבור למיקום אחר במסמך באמצעות מגוון רחב של DocumentBuilder.MoveToXXX שיטות כגון MoveToDocumentStart ו MoveToField. cursor וירטואלית זו מציינת היכן הטקסט יוכנס בעת קריאה לשיטות Write, Writeln, InsertBreak, ואחרים. ראה את המאמר הבא “Navigation with Cursor” כדי ללמוד עוד על cursor וירטואלית.
דוגמה לקוד הבא מראה כיצד לנווט לסימן ספר:
בניית מסמכים ושינוי
Aspose.Words API מספק מספר שיעורים האחראים לתבנית אלמנטים שונים של מסמך. כל אחת מהכיתות מדגימה נכסים הקשורים אלמנט מסמך ספציפי, כגון טקסט, פסקה, סעיף ואחרים. לדוגמה, Font הכיתה מייצגת תכונות עיצוב אופי, ParagraphFormat הכיתה מייצגת את התכונות של סעיף, וכן הלאה. אובייקטים של שיעורים אלה יוחזרו על ידי התואם DocumentBuilder נכסים, שיש להם את אותם השמות כמו המעמדות. לכן, אתה יכול לגשת אליהם ולהגדיר את הפורמט הרצוי במהלך בניית המסמך.
באפשרותך גם להוסיף טקסט, Checkbox, ole object, תמונות, סמנים, שדות טופס ואלמנטים אחרים של מסמכים בעמדה cursor באמצעות המיקום cursor באמצעות cursor Write שיטה או כל אחד DocumentBuilder.InsertXXX שיטות, כגון InsertField, InsertHtml, שיטות דומות.
בואו נראה איך ליצור מסמך פשוט באמצעות DocumentBuilder.
יצירת מסמך באמצעות DocumentBuilder
כדי להתחיל, אתה צריך ליצור DocumentBuilder לקשור אותו עם Document אובייקט. אתה יוצר מקרה חדש של DocumentBuilder על ידי קריאה ליוצר שלו ולהעביר אותו ל Document להתנגד להחזקה אל הבונים.
כדי להוסיף טקסט, להעביר את מחרוזת הטקסט שאתה צריך להכניס לתוך המסמך אל המסמך. Write שיטה.
הדוגמה הבאה של הקוד מראה כיצד ליצור מסמך פשוט באמצעות בונה מסמך.
המונחים Document Format
The The The Font הנכס מגדיר פורמט טקסט. אובייקט זה מכיל תכונות גופניות שונות (שם גופני, גודל גופן, צבע וכן הלאה). כמה תכונות גופניות חשובות מיוצגות גם על ידי DocumentBuilder תכונות כדי לאפשר לך לגשת אליהם ישירות. אלה הם Font.Bold, Font.Italic, ו Font.Underline תכונות בוטות
הדוגמה הבאה של הקוד מראה כיצד להוסיף טקסט מעוצב באמצעות DocumentBuilder:
-
- Font מפרט את פורמט האופי שיושם על כל הטקסט שהוכנס מהמיקום הנוכחי במסמך ואילך.
-
- ParagraphFormat מפרט את הסעיף לתבנית הנוכחית וכל הסעיפים שיש להכניס.
-
- PageSetup מפרט את הדף ואת התכונות של החלק הנוכחי ואת כל הקטע שיוכנס.
-
- CellFormat ו RowFormat ציין תכונות עיצוב שיושמו על תאים ושורה מהמיקום הנוכחי במסמך ואילך.
במצב זה, “נוכחי” פירושו העמדה, פסקה, סעיף, תא או שורה שבה הcursor הוא.