Aspose.Words FOSS
.NET
מדריך למפתחים
עיצוב תוצאת השדה

עיצוב תוצאת השדה

עיצוב תוצאות השדה

המדריך הזה מראה כיצד לשלוט בעיצוב המספרי, תאריך/זמן והכללי המיושם לתוצאת החישוב של שדה ב-Aspose.Words FOSS עבור .NET, באמצעות המחלקה FieldFormat, האינום GeneralFormat, ו-GeneralFormatCollection. כל מופע של Field חושף את מתגי העיצוב האלו דרך המאפיין Format; דף זה הוא העמקון על מה שהמאפיין מציע.

גישה לעיצוב של שדה

כל Field — והמחלקות הצאצאיות המוגדרות שלו כגון FieldDate, FieldCreateDate ו-FieldSymbol — חושף מאפיין Format מסוג FieldFormat, המשמש לגישה טיפוסית לעיצוב המספרי, תאריך/זמן והכללי של השדה. קרא Field.Format כדי לבדוק או לשנות את המתגים המחוברים לקוד השדה ללא עריכה ידנית של טקסט קוד השדה הגולמי.

תמונות פורמט מספרי ותאריך/זמן

FieldFormat.NumericFormat הוא מאפיין string הניתן לכתיבה שמחזיק את העיצוב המיושם לתוצאת שדה מספרי. FieldFormat.DateTimeFormat הוא מאפיין string הניתן לכתיבה שמחזיק את העיצוב המיושם לתוצאת שדה תאריך ושעה. הגדר כל אחד מהמאפיינים כדי לשנות את האופן שבו סוג השדה המתאים מציג את ערכו המחושב.

פורמטים כלליים

FieldFormat.GeneralFormats מחזיר GeneralFormatCollection — פורמטים כלליים שניתן ליישם על תוצאה מספרית, טקסטואלית או כל שדה. החברים נלקחים מה-enum GeneralFormat, שמכיל שינויי מקרה (Upper, Lower, FirstCap, Caps), ספירה רומית וסידור סדרתי (UppercaseRoman, LowercaseRoman, Ordinal, OrdText), מטבע וטקסט סדור (DollarText, BahtText, CardText), מערכות ספירה ספציפיות לשפה (Aiueo, Arabic, ArabicAbjad, ArabicAlpha, ArabicDash, ChineseNum1–ChineseNum3, KanjiNum1–KanjiNum3, Hebrew1, Hebrew2, Ganada, Chosung, Zodiac1–Zodiac3, ThaiArabic, ThaiCardText, ThaiLetter, HindiArabic, HindiCardText, HindiLetter1, HindiLetter2, VietCardText, DBNum1–DBNum4, DBChar, SBChar, GB1–GB4, Hex, CircleNum, UppercaseAlphabetic, LowercaseAlphabetic), וכן ערכי מיזוג-שדה CharFormat, MergeFormat ו-MergeFormatInet. None מנקה פורמט כללי.

ניהול GeneralFormatCollection

GeneralFormatCollection מיישם IEnumerable<GeneralFormat>, ולכן ניתן לעבור עליו עם GetEnumerator() בלולאת foreach. קרא ל-Add(item) כדי לצרף ערך GeneralFormat, ל-Remove(item) כדי להסיר כל מופע של ערך, או ל-RemoveAt(index) כדי להסיר את הערך במיקום ספציפי. Count מדווח כמה פורמטים כלליים מוחלים כעת.

טיפים ושיטות מומלצות

  • הגדר Field.Format.NumericFormat או Field.Format.DateTimeFormat במקום לשבץ תמונת פורמט ישירות במחרוזת קוד השדה — המאפיין המוקלד משמר את קוד השדה ומתג הפורמט שלו בתיאום.
  • שילוב ערכי GeneralFormat מרובים (לדוגמה Upper ו-MergeFormat) על-ידי הוספת כל אחד ל-GeneralFormats בנפרד; האוסף מאפשר יותר מערך אחד.
  • לאחר שינוי כל מאפיין FieldFormat, קרא ל-Update() על השדה הבעלים כך שהפורמט החדש יבוא לידי ביטוי ב-Result / DisplayResult.
  • השתמש ב-GeneralFormat.None כדי למחוק במפורש ערך פורמט כללי במקום להשאיר ערכי פורמט ישנים באוסף.
  • בדוק את GeneralFormatCollection.Count לפני שאתה מניח ששדה אינו מוחל עליו עיצוב כללי — אוסף ריק ואוסף המכיל None הם מצבים שונים.

בעיות נפוצות

בעיהסיבהתיקון
שינוי NumericFormat אינו גורם לאפקט נראההשדה לא חושב מחדש לאחר השינויהפעל Update() על השדה לאחר עריכת כל מאפיין של FieldFormat
פורמטים כלליים משוכפלים מופיעים ב-GeneralFormatsAdd(item) קרא יותר מפעם אחת עבור אותה ערך של GeneralFormatבדוק GeneralFormatCollection.Count או חזור לפני ההוספה, או קרא ל-Remove(item) תחילה
הערך השגוי הוסר מ-GeneralFormatsRemoveAt(index) קרא עם אינדקס שהזז לאחר הסרה קודמתבדוק Count וחזור על האוסף שוב לפני הסרה לפי אינדקס

FAQ

למה משמש FieldFormat?

זהו אובייקט העיצוב המוגדר החשוף על-ידי Field.Format, המספק גישה לעיצוב המספרי של השדה (NumericFormat), לעיצוב תאריך/זמן (DateTimeFormat) ולעיצובים הכלליים (GeneralFormats).

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

כן — GeneralFormats הוא GeneralFormatCollection, ואתה יכול Add יותר מערך GeneralFormat אחד אליו.

איך להסיר את כל העיצוב הכללי משדה?

חזור על GeneralFormats וקרא ל-Remove(item) עבור כל ערך, או RemoveAt(index) לרשומה ספציפית.

האם הגדרת תכונות FieldFormat מרעננת אוטומטית את הטקסט המוצג של השדה?

לא — קרא ל-Update() על השדה לאחר שינוי תכונות Format שלו כדי ש-Result ו-DisplayResult ישקפו את העיצוב החדש.

API Reference סיכום

מחלקה/מתודהתיאור
FieldFormatגישה טיפוסית למספרי, תאריך/זמן ולעיצוב הכללי של שדה; נחשפת דרך Field.Format
FieldFormat.NumericFormatתמונת עיצוב מוחלת על תוצאת שדה מספרי
FieldFormat.DateTimeFormatתמונת עיצוב מוחלת על תוצאת שדה תאריך/שעה
FieldFormat.GeneralFormatsGeneralFormatCollection של פורמטים כלליים מוחלים על תוצאת השדה
GeneralFormatרשימת ערכים של מתגי עיצוב כלליים (המרות רישיות, מערכות מספור, פורמטים של שדות מיזוג)
GeneralFormatCollectionאוסף טיפוסי של ערכי GeneralFormat; Add, Remove, RemoveAt, Count, GetEnumerator

ראה גם

 עברית