עבודה עם עמודות ושורות
לקבלת שליטה רבה יותר על אופן הפעולה של טבלאות, למד כיצד לתפעל עמודות ושורות.
מצא את אינדקס רכיבי הטבלה
עמודות, שורות ותאים מנוהלים על ידי גישה לצומת המסמך שנבחר על ידי האינדקס שלו. מציאת האינדקס של כל צומת כרוכה באיסוף כל הצמתים של סוג האלמנט מהצומת האם, ולאחר מכן שימוש בשיטת IndexOf כדי למצוא את האינדקס של הצומת הרצוי באוסף.
מצא את האינדקס של טבלה במסמך
לפעמים ייתכן שיהיה עליך לבצע שינויים בטבלה מסוימת במסמך. לשם כך, תוכל לעיין בטבלה לפי האינדקס שלה.
דוגמת הקוד הבאה מראה כיצד לאחזר את האינדקס של טבלה במסמך:
מצא את האינדקס של שורה בטבלה
באופן דומה, ייתכן שיהיה עליך לבצע שינויים בשורה מסוימת בטבלה שנבחרה. לשם כך, תוכל גם להתייחס לשורה לפי האינדקס שלה.
דוגמת הקוד הבאה מראה כיצד לאחזר את האינדקס של שורה בטבלה:
מצא את האינדקס של תא בשורה
לבסוף, ייתכן שיהיה עליך לבצע שינויים בתא מסוים, ואתה יכול לעשות זאת על ידי אינדקס התא גם כן.
דוגמת הקוד הבאה מראה כיצד לאחזר את האינדקס של תא בשורה:
עבודה עם עמודות
במודל אובייקט המסמך Aspose.Words (DOM), הצומת Table מורכבת מ Row צמתים ואז Cell צמתים. כך, במודל האובייקט Document של Aspose.Words, כמו במסמכים Word, אין מושג של עמודה.
לפי התכנון, שורות הטבלה ב Microsoft Word ו Aspose.Words הם עצמאיים לחלוטין, והמאפיינים והפעולות הבסיסיים כלולים רק בשורות ובתאים של הטבלה. זה נותן לטבלאות את היכולת לקבל כמה תכונות מעניינות:
- כל שורה בטבלה יכולה להיות מספר שונה לחלוטין של תאים
- אנכית, לתאים של כל שורה יכולים להיות רוחבים שונים
- אפשר להצטרף לטבלאות עם פורמטים שונים של שורות ומספר תאים
כל פעולות המבוצעות בעמודות הן למעשה “קיצורי דרך” המבצעים את הפעולה על ידי שינוי קולקטיבי של תאי שורה באופן שנראה כאילו הם מוחלים על עמודות. כלומר, אתה יכול לבצע פעולות על עמודות פשוט על ידי איטרציה על אותו אינדקס תא שורה בטבלה.
דוגמת הקוד הבאה מפשטת פעולות כאלה על ידי הוכחת כיתת חזית שאוספת את התאים המרכיבים" עמוד " של טבלה:
דוגמת הקוד הבאה מראה כיצד להכניס עמודה ריקה לטבלה:
דוגמת הקוד הבאה מראה כיצד להסיר עמודה מטבלה במסמך:
ציין שורות כשורות כותרת
אתה יכול לבחור לחזור על השורה הראשונה בטבלה כשורת הכותרת רק בעמוד הראשון או בכל עמוד אם הטבלה מחולקת למספר. ב Aspose.Words, אתה יכול לחזור על שורת הכותרת בכל עמוד באמצעות המאפיין HeadingFormat.
ניתן גם לסמן שורות כותרת מרובות אם שורות כאלה ממוקמות אחת אחרי השנייה בתחילת הטבלה. לשם כך, עליך להחיל את המאפיינים HeadingFormat על שורות אלה.
דוגמת הקוד הבאה מראה כיצד לבנות טבלה הכוללת שורות כותרות שחוזרות על עצמן בדפים הבאים:
שמור על טבלאות ושורות לפרוץ בין דפים
ישנם מקרים בהם אין לפצל את תוכן הטבלה בין דפים. לדוגמה, אם כותרת נמצאת מעל טבלה, תמיד יש לשמור את הכותרת והטבלה יחד באותו עמוד כדי לשמור על מראה תקין.
ישנן שתי טכניקות נפרדות שימושיות להשגת פונקציונליות זו:
Allow row break across pages, אשר מוחל על שורות טבלהKeep with next, אשר מוחל על פסקאות בתאי טבלה
כברירת מחדל, המאפיינים לעיל מושבתים.
שמור שורה לפרוץ על פני דפים
זה כרוך בהגבלת התוכן בתוך התאים של שורה מלהיות מחולק על פני דף. ב Microsoft Word, זה יכול למצוא תחת מאפייני טבלה כאפשרות"אפשר שורה לפרוץ בין דפים". ב Aspose.Words זה נמצא מתחת לאובייקט RowFormat של Row כמאפיין RowFormat.AllowBreakAcrossPages.
דוגמת הקוד הבאה מראה כיצד להשבית שבירת שורות בין דפים עבור כל שורה בטבלה:
שמור על טבלה שלא תפרוץ על פני עמודים
כדי למנוע מהטבלה להתפצל בין דפים, עלינו לציין שאנו רוצים שהתוכן הכלול בטבלה יישאר יחד.
לשם כך, Aspose.Words משתמש בשיטה, המאפשרת למשתמשים לבחור טבלה ולאפשר לפרמטר KeepWithNext להיות נכון עבור כל פסקה בתאי הטבלה. היוצא מן הכלל הוא הפסקה האחרונה בטבלה, אשר צריך להיות מוגדר שקר.
דוגמת הקוד הבאה מראה כיצד להגדיר טבלה כדי להישאר יחד באותו דף: