צור טבלה
Aspose.Words מאפשר למשתמשים ליצור טבלאות במסמך מאפס ומספק מספר שיטות שונות לעשות זאת. מאמר זה מציג פרטים כיצד להוסיף טבלאות מעוצבות למסמך שלך בכל שיטה, כמו גם השוואה של כל שיטה בסוף המאמר.
ברירת מחדל שולחן סגנונות
הטבלה החדשה שנוצרה מקבלת ערכי ברירת מחדל דומים לאלה המשמשים ב Microsoft Word:
רכוש טבלה | ברירת מחדל ב Aspose.Words |
---|---|
Border Style |
Single |
Border Width |
1/2 פט |
Border Color |
Black |
Left and Right Padding |
5.4 pts |
AutoFit Mode |
AutoFit to Window |
Allow AutoFit |
True |
צור טבלה עם DocumentBuilder
ב Aspose.Words, משתמשים יכולים ליצור טבלה במסמך באמצעות DocumentBuilder. האלגוריתם הבסיסי ליצירת טבלה הוא כדלקמן:
- התחל את הטבלה עם StartTable
- הוסף תא לטבלה באמצעות InsertCell - פעולה זו מתחילה אוטומטית שורה חדשה
- לחלופין, השתמש במאפיין CellFormat כדי לציין עיצוב תאים
- הכנס את תוכן התא בשיטות DocumentBuilder המתאימות כגון Writeln, InsertImage ואחרות
- חזור על שלבים 2-4 עד להשלמת השורה
- התקשר EndRow לסיום השורה הנוכחית
- לחלופין, השתמש במאפיין RowFormat כדי לציין עיצוב שורות
- חזור על שלבים 2-7 עד להשלמת הטבלה
- התקשר EndTable לסיום בניית השולחן
פרטים חשובים:
- StartTable יכול להיקרא גם בתוך תא, ובמקרה זה הוא מתחיל ביצירת טבלה מקוננת בתוך התא.
- לאחר התקשרות InsertCell, נוצר תא חדש, וכל תוכן שתוסיף בשיטות אחרות של המחלקה DocumentBuilder יתווסף לתא הנוכחי. כדי ליצור תא חדש באותה שורה, התקשר שוב InsertCell.
- אם InsertCell נקרא מיד אחרי EndRow וסוף שורה, הטבלה תמשיך בשורה חדשה.
- שיטת EndTable לסיום הטבלה צריכה להיקרא רק פעם אחת לאחר קריאה EndRow. קריאה EndTable מעבירה את הסמן מהתא הנוכחי למצב מיד אחרי הטבלה.
ניתן לראות בבירור את תהליך יצירת הטבלה בתמונה הבאה:
דוגמת הקוד הבאה מראה כיצד ליצור טבלה פשוטה באמצעות DocumentBuilder עם עיצוב ברירת מחדל:
דוגמת הקוד הבאה מראה כיצד ליצור טבלה מעוצבת באמצעות DocumentBuilder:
דוגמת הקוד הבאה מראה כיצד להוסיף טבלה מקוננת באמצעות DocumentBuilder:
צור טבלה באמצעות DOM (מודל אובייקט מסמך)
ניתן להוסיף טבלאות ישירות לתוך DOM על ידי הוספת צומת Table חדשה במיקום מסוים.
שימו לב שמיד לאחר יצירת צומת הטבלה, הטבלה עצמה תהיה ריקה לחלוטין, כלומר היא עדיין לא מכילה שורות ותאים. כדי להוסיף שורות ותאים לטבלה, הוסף את הצמתים המתאימים Row ו Cell ל DOM.
דוגמת הקוד הבאה מראה כיצד לבנות טבלה חדשה מאפס על ידי הוספת צמתי הילד המתאימים לעץ המסמך:
צור טבלה מ HTML
Aspose.Words תומך בהכנסת תוכן למסמך ממקור HTML בשיטת InsertHtml. הקלט יכול להיות שלם HTML עמוד או רק קטע חלקי.
בשיטת InsertHtml, משתמשים יכולים להכניס טבלאות למסמך באמצעות תגי טבלה כמו <table>
, <tr>
, <td>
.
דוגמת הקוד הבאה מראה כיצד להכניס טבלה למסמך ממחרוזת המכילה תגיות HTML:
הכנס עותק של טבלה קיימת
לעתים קרובות יש צורך ליצור טבלה המבוססת על טבלה שכבר קיימת במסמך. הדרך הקלה ביותר לשכפל טבלה תוך שמירה על כל העיצוב היא לשכפל את צומת הטבלה בשיטת Clone.
ניתן להשתמש באותה טכניקה כדי להוסיף עותקים של שורה או תא קיימים לטבלה.
דוגמת הקוד הבאה מראה כיצד לשכפל טבלה באמצעות בוני צומת:
דוגמת הקוד הבאה מראה כיצד לשכפל את השורה האחרונה בטבלה ולהוסיף אותה לטבלה:
אם אתה מסתכל על יצירת טבלאות במסמך שצומחות באופן דינמי עם כל רשומה ממקור הנתונים שלך, השיטה לעיל אינה מומלצת. במקום זאת, הפלט הרצוי מושגת בקלות רבה יותר באמצעות Mail merge עם אזורים. אתה יכול ללמוד עוד על טכניקה זו ב Mail Merge עם אזורים סעיף.
השווה דרכים ליצירת טבלה
Aspose.Words מספק מספר שיטות ליצירת טבלאות חדשות במסמך. לכל שיטה יש יתרונות וחסרונות משלה, ולכן הבחירה שבה להשתמש לעתים קרובות תלוי במצב הספציפי.
בואו נסתכל מקרוב על דרכים אלה של יצירת טבלאות ולהשוות את היתרונות והחסרונות שלהם:
שיטה | יתרונות | חסרונות |
---|---|---|
DocumentBuilder |
השיטה הסטנדרטית להכנסת טבלאות ותוכן מסמכים אחר | לפעמים קשה ליצור סוגים רבים של שולחנות בו זמנית עם אותו מופע בונה |
דרך DOM | מתאים יותר עם קוד שמסביב שיוצר ומכניס צמתים ישירות לתוך DOM ללא שימוש DocumentBuilder | הטבלה נוצרת “ריק”: לפני ביצוע רוב הפעולות, עליך להתקשר EnsureMinimum כדי ליצור צמתים חסרים של ילדים |
מ HTML | ניתן ליצור טבלה חדשה מ HTML מקור באמצעות תגים כמו <table> , <tr> , <td> |
לא ניתן להחיל את כל פורמטי הטבלה Microsoft Word על HTML |
שיבוט טבלה קיימת | ניתן ליצור עותק של טבלה קיימת תוך שמירה על כל עיצוב השורות והתאים | יש להסיר את הצמתים המתאימים לפני שהטבלה מוכנה לשימוש |