המונחים: Table Format

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

Aspose.Words מספק עשיר API כדי להחזיר וליישם פורמט לשולחן. אתה יכול להשתמש Table, RowFormat, ו CellFormat חסרונות כדי להגדיר פורמט.

במאמר זה, נדבר על איך ליישם פורמט של צמתות שולחן שונות ומה טבלה מעצבת הגדרות Aspose.Words תומך.

המונחים: different nodes

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

עיצוב שולחן

כדי ליישם פורמט בטבלה אתה יכול להשתמש בנכסים הזמינים על התואם Table המונחים: Table, PreferredWidth, ו TableCollection שיעורים.

שימו לב שהשולחן חייב להיות לפחות שורה אחת לפני שניתן ליישם את תכונות השולחן. זה אומר שכאשר בונים שולחן עם DocumentBuilder, עיצוב זה חייב להיעשות לאחר הקריאה הראשונה [InsertCell](https://reference.aspose.com/words/java/com.aspose.words/documentbuilder/#insertCell()או אחרי השורה הראשונה מווספים לשולחן, או כאשר צמתים מוכנסים ישירות אל תוך הצומת. DOM.

התמונות למטה מציגות ייצוג של Table עיצוב תכונות Microsoft Word תכונותיהם המקבילות Aspose.Words.

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

דוגמה לקוד הבא מראה כיצד לבנות שולחן עם כל הגבולות המותרים (גריד):

המונחים:

פורמט Row-level** ניתן לשלוט באמצעות Row, RowFormat, ו RowCollection שיעורים.

שימו לב Row יכול להיות רק ילד של Table. במקביל, צריך להיות לפחות אחד Cell בתוך Row כך שניתן ליישם את הפורמט הזה.

התמונות למטה מציגות ייצוג של Row עיצוב תכונות Microsoft Word תכונותיהם המקבילות Aspose.Words.

הדוגמה הבאה של הקוד מראה כיצד לשנות את שורת השולחן:

פורמט רמת תאים

פורמט ברמת התאים נשלט על ידי Cell, CellFormat, ו CellCollection שיעורים.

שימו לב Cell יכול להיות רק ילד של Row. במקביל, צריך להיות לפחות אחד Paragraph בתוך Cell כך שניתן ליישם את הפורמט הזה.

בנוסף Paragraph, אתה יכול גם להוסיף Table לתוך Cell.

התמונות למטה מציגות ייצוג של Cell עיצוב תכונות Microsoft Word תכונותיהם המקבילות Aspose.Words.

הדוגמה הקודית הבאה מראה כיצד לשנות את הפורמט של תא שולחן:

לדוגמה הקוד הבא מראה כיצד להגדיר את כמות החלל (בנקודות) כדי להוסיף לשמאל / ימין / ימין / קידוד של התוכן של התא:

המונחים: Row Heights

הדרך הפשוטה ביותר לקבוע את גובה השורות היא להשתמש DocumentBuilder. שימוש מתאים RowFormat תכונות, אתה יכול להגדיר את גובה ברירת המחדל או ליישם גובה שונה עבור כל שורה בטבלה.

In In In Aspose.Words, גובה טבלאות נשלט על ידי:

• הנכס בגובה שורות - Height
• הנכס השולט בגובה לשורה נתונה - HeightRule

במקביל, ניתן לקבוע גובה שונה לכל שורה - זה מאפשר לך לשלוט באופן נרחב על הגדרות השולחן.

אפשרויות חוק לסימון גובה האובייקט ניתן להגדיר באמצעות HeightRule שדות

הדוגמה הקודית הבאה מראה כיצד ליצור שולחן המכיל תא אחד וליישם פורמט שורות:

תגית: Table and Cell Widths

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

חשוב לדעת שרכיבי השולחן מציגים כמה תכונות שונות שיכולות להשפיע על רוחב השולחן הכולל, כמו גם תאים בודדים, מחושב:

• רוחב מועדף על השולחן
• רוחב מועדף על תאים בודדים
• לאפשר התאמה אוטומטית על השולחן

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

ברוב המקרים, התא המועדף מומלץ מאשר רוחב השולחן. רוחב התא המועדף הוא יותר בקנה אחד עם מפרט פורמט DOCX, כמו גם Aspose.Words מודל

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

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

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

כיצד להשתמש Width מועדף

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

סוג רוחב המתאים וערך נקבעים באמצעות שיטות של PreferredWidth קטגוריה:

• The Auto שדה כדי לציין אוטו או “ללא רוחב מועדף”
• The FromPercent שיטה לציין רוחב אחוז
• The FromPoints שיטה לציין את רוחב הנקודות

התמונות להלן מציגות ייצוג של תכונות הגדרת רוחב* * Microsoft Word תכונותיהם המקבילות Aspose.Words.

דוגמה לאופן שבו אפשרויות אלה מוחלות על שולחן אמיתי במסמך ניתן לראות בתמונה למטה.

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

שם הסרטון: The Best Table or Cell Width

In In In Aspose.Words, רוחב שולחן ותאים נקבעים באמצעות Table.PreferredWidth רכוש ו CellFormat.PreferredWidth רכוש, עם אפשרויות זמין PreferredWidthType המונחים:

• • Auto, מה ששווה ערך ל-No המועדפת
• • Percent, אשר מתאים את האלמנט ביחס למרחב הזמין בחלון או בגודל מיכל, וחושף מחדש את הערך כאשר רוחב זמין משתנה
• • Points, אשר תואם את האלמנט של רוחב שצוין בנקודות

כברירת מחדל, ניתן לתאר שולחן כ- 100% של החלל הזמין בעמוד. במקרה זה, זה אומר שהשולחן ינסה לקחת את החלל בין שולי הדף הימני והשמאלי.

באמצעות Table.PreferredWidth הנכס יתאים את רוחבו המועדף ביחס למיכלו: דף, עמוד טקסט, או תא שולחן חיצוני אם הוא שולחן מקונן.

לדוגמה הקוד הבא מראה כיצד להגדיר את השולחן להתאמה אוטומטית ל-50% רוחב העמוד:

באמצעות CellFormat.PreferredWidth רכוש בתא נתון יתאים את רוחבו המועדף.

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

מצא סוג וערך מועדפים

אתה יכול להשתמש Type ו Value תכונות למצוא את הפרטים היפים של השולחן הרצוי או התא.

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

כיצד להגדיר Autofit

The The The AllowAutoFit הנכס מאפשר לתאים בטבלה לגדול ולהתכווץ בהתאם לקריטריון שנבחר. לדוגמה, אתה יכול להשתמש AutoFit to Window אפשרות להתאים את השולחן לרוחב הדף, ואת אוטומטי לתוכן אפשרות לאפשר לכל תא לגדול או להתכווץ בהתאם לתוכן שלו.

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

כברירת מחדל, Aspose.Words הוספת שולחן חדש באמצעות AutoFit to Window. השולחן יהיה בגודל לפי רוחב העמוד הזמין. כדי לעצב מחדש שולחן, אתה יכול לקרוא AutoFit שיטה. שיטה זו מקבלת AutoFitBehavior הערכה שמציינת איזה סוג של אוטופיט מוחל על השולחן.

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

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

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

שולחן אוטומטי לחלון

כאשר מתאים לחלון מוחל על שולחן, הפעולות הבאות מבוצעות למעשה מאחורי הקלעים:

1.1 1. The The The Table.AllowAutoFit הנכס מופעל באופן אוטומטי עמודות בגודל כדי להתאים את התוכן הזמין, באמצעות שימוש Table.PreferredWidth ערך של 100% 2. CellFormat.PreferredWidth הוסר מכל תאי השולחן

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

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

הדוגמה הבאה של הקוד מראה כיצד להתאים שולחן לרוחב העמוד:

דוגמה לאופן שבו אפשרויות אלה מוחלות על השולחן לעיל ניתן לראות בתמונה למטה.

שולחן אוטומטי לתוכן

כאשר השולחן מותקן את התוכן, השלבים הבאים מבוצעים למעשה מאחורי הקלעים:

1.1 1. The The The Table.AllowAutoFit הנכס ניתן באופן אוטומטי לשנות כל תא בהתאם לתוכן שלו

2. רוחב השולחן המועדף הוסר Table.PreferredWidth, CellFormat.PreferredWidth מוסר לכל תא שולחן

   שים לב שהאפשרות האוטומטית הזו מורידה את רוחב התאים המועדף, בדיוק כמו בתאים. Microsoft Word. אם אתה רוצה לשמור על גודל העמודה ולהגדיל או להקטין את העמודות כדי להתאים את התוכן, עליך להגדיר את הטור. Table.AllowAutoFit רכוש True על עצמו ולא באמצעות קיצור דרך אוטומטי.

3. רוחב העמודים מחושבים מחדש עבור תוכן השולחן הנוכחי - התוצאה הסופית היא שולחן שבו רוחב העמודה ורוחב השולחן כולו גדלים באופן אוטומטי כדי להתאים את התוכן כמו המשתמש לערוך את הטקסט

לדוגמה הקוד הבא מראה כיצד להתאים שולחן לתוכן שלו:

דוגמה לאופן שבו אפשרויות אלה מוחלות על השולחן לעיל ניתן לראות בתמונה למטה.

AutoFit in Table ו השתמש בעמוד קבוע Widths

אם שולחן יש מוגבלות אוטומטית ורוחב עמודה קבוע משמשים במקום, השלבים הבאים מבוצעים:

1.1 1. Table.AllowAutoFit רכוש הוא מוגבלויות כך עמודות אינן צומחות או מתכווץ לתוכן שלהם 2. רוחבו המועדף של השולחן כולו הוסר Table.PreferredWidth, CellFormat.PreferredWidth הוסר מכל תאי השולחן 3. התוצאה הסופית היא שולחן אשר רוחב העמודה נקבע על ידי CellFormat.Width רכוש, ואת העמודות שלו אינם עולים באופן אוטומטי כאשר המשתמש נכנס לטקסט או כאשר הדף הוא מחדש

שים לב שאם אין רוחב מוגדר CellFormat.Width, ערך ברירת המחדל של אינץ' אחד (72 נקודות) משמש.

הדוגמה הבאה של הקוד מראה כיצד להשבית את ההנעה ולאפשר רוחב קבוע עבור השולחן שצוין:

דוגמה לאופן שבו אפשרויות אלה מוחלות על השולחן לעיל ניתן לראות בתמונה למטה.

סדר עדיפות כאשר Calculating Cell Width

Aspose.Words מאפשר למשתמשים להגדיר את רוחב השולחן או התא באמצעות אובייקטים מרובים, כולל CellFormat - שלה Width הנכס נשאר בעיקר מגרסאות קודמות, עם זאת, הוא עדיין שימושי לפשט את רוחב התא.

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

Aspose.Words שימוש בסדר הבא לחישוב רוחב תאים:

הזמנה	רכוש	תיאור תיאור
1	AllowAutoFit נקבע	אם AutoFit ניתן: - השולחן עשוי לגדול מעבר לרוחב המועדפת כדי להתאים את התוכן - זה בדרך כלל לא מתכווץ מתחת לרוחב המועדפת כל שינוי CellFormat.Width הערך מתעלם והתא מתאים לתוכן שלו במקום
2	PreferredWidthType עם ערך Points או Percent	CellFormat.Width התעלמו
3	PreferredWidthType עם ערך Auto	הערך מהערך CellFormat.Width הוא מועתק והופך לרוחב המועדף של התא (בנקודות)

כל שינוי ברכוש הרוחב אינו מעודכנים ברוח המועדפת וחייב להיות מיושם במקום זאת ברוחב המועדף.

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

לאפשר ספיגה בין תאים

אתה יכול לקבל או להגדיר שטח נוסף בין תאי שולחן דומים לאופציה “לחיצת ים” ב Microsoft Word. ניתן לעשות זאת באמצעות AllowCellSpacing רכוש.

דוגמה לאופן שבו אפשרויות אלה מוחלות על שולחן אמיתי במסמך ניתן לראות בתמונה למטה.

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

החל גבולות ושינג

גבולות וגילוח ניתן ליישם גם על השולחן כולו באמצעות Table.SetBorder, Table.SetBorders ו Table.SetShading, או רק לתאים ספציפיים באמצעות CellFormat.Borders ו CellFormat.Shading. בנוסף, ניתן להגדיר גבולות שורות באמצעות RowFormat.Borders, עם זאת, לא ניתן ליישם את הגילוח בדרך זו.

התמונות למטה מציגות את הגדרות הגבול והצל בתוך Microsoft Word תכונותיהם המקבילות Aspose.Words.

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