Mezőeredmény formázása

Mezőeredmény Formázása

Ez az útmutató bemutatja, hogyan lehet szabályozni egy mező számított eredményére alkalmazott numerikus, dátum/idő és általános formázást a Aspose.Words FOSS-ban a .NET számára, a FieldFormat class, a GeneralFormat enum és a GeneralFormatCollection használatával. Minden Field példány ezeket a formázási kapcsolókat a Format tulajdonságán keresztül teszi elérhetővé; ez az oldal mélyrehatóan bemutatja, mit kínál ez a tulajdonság.

Mező Formázásának Elérése

Minden Field — és a típusos alosztályai, mint például a FieldDate, FieldCreateDate és a FieldSymbol — egy Format tulajdonságot biztosít FieldFormat típusban, amely a mező numerikus, dátum- és idő, valamint általános formázásának típusos hozzáférésére szolgál. Olvassa el a Field.Format dokumentumot, hogy megvizsgálja vagy módosítsa a mező kódjához csatolt kapcsolókat anélkül, hogy kézzel szerkesztené a nyers mezőkód szöveget.

Numerikus és Dátum/Idő Formátum Képek

FieldFormat.NumericFormat egy írható string tulajdonság, amely a numerikus mezőeredményre alkalmazott formázást tárolja. FieldFormat.DateTimeFormat egy írható string tulajdonság, amely a dátum- és időmező eredményére alkalmazott formázást tárolja. Állítsa be bármelyik tulajdonságot, hogy megváltoztassa, hogyan jeleníti meg a megfelelő mezőtípus a számított értéket.

Általános Formátumok

FieldFormat.GeneralFormats egy GeneralFormatCollection — általános célú formátumok, amelyek numerikus, szöveges vagy bármilyen mezőeredményre alkalmazhatók. Tagjai a GeneralFormat enumból származnak, amely magában foglalja a kis- és nagybetű átalakításokat (Upper, Lower, FirstCap, Caps), római és sorszámozási formákat (UppercaseRoman, LowercaseRoman, Ordinal, OrdText), pénznem és kardinális szöveget (DollarText, BahtText, CardText), helyspecifikus számrendszereket (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), valamint a beillesztési mezőspecifikus értékek CharFormat, MergeFormat és MergeFormatInet. None törli az általános formázást.

A GeneralFormatCollection kezelése

GeneralFormatCollection megvalósítja a IEnumerable<GeneralFormat> funkciót, így GetEnumerator() segítségével foreach ciklusban iterálható. Hívja a Add(item) függvényt egy GeneralFormat érték hozzáfűzéséhez, a Remove(item) függvényt az érték minden előfordulásának eltávolításához, vagy a RemoveAt(index) függvényt az érték egy adott pozícióban történő eltávolításához. A Count jelzi, hogy jelenleg hány általános formátum van alkalmazva.

Tippek és bevált gyakorlatok

• Állítsa be a Field.Format.NumericFormat vagy a Field.Format.DateTimeFormat értékét ahelyett, hogy a formázási képet közvetlenül a mezőkód karakterláncába ágyazná — a típusos tulajdonság szinkronban tartja a mezőkódot és annak formázási kapcsolóját.
• Kombináljon több GeneralFormat értéket (például Upper és MergeFormat) úgy, hogy mindegyiket egyenként hozzáadja a GeneralFormats gyűjteményhez; a kollekció több bejegyzést is megenged.
• Miután megváltoztatott egy FieldFormat tulajdonságot, hívja a Update() függvényt a tulajdonos mezőn, hogy az új formázás megjelenjen a Result / DisplayResult -ban.
• Használja a GeneralFormat.None függvényt az általános formátumbejegyzés kifejezett törlésére, ahelyett, hogy elavult formázási értékeket hagyna a gyűjteményben.
• Ellenőrizze a(z) GeneralFormatCollection.Count értéket, mielőtt azt feltételezné, hogy egy mezőre nincs általános formázás alkalmazva — egy üres gyűjtemény és egy None-t tartalmazó gyűjtemény különböző állapotok.

Általános problémák

FAQ

Mire használják a(z) FieldFormat?

Ez a Field.Format által biztosított típusos formázási objektum, amely hozzáférést biztosít egy mező numerikus formátumához (NumericFormat), dátum/idő formátumához (DateTimeFormat) és általános formátumokhoz (GeneralFormats).

Alkalmazhat egy mezőnél több általános formátum?

Igen — GeneralFormats egy GeneralFormatCollection, és Add több GeneralFormat értéket hozzá.

Hogyan távolíthatom el egy mező összes általános formázását?

Iterálja a GeneralFormats elemet, és hívja meg a Remove(item) minden értéknél, vagy a RemoveAt(index) egy adott bejegyzéshez.

Az FieldFormat tulajdonságainak beállítása automatikusan frissíti a mező megjelenített szövegét?

Nem — hívja meg a Update() a mezőn, miután megváltoztatta a Format tulajdonságait, hogy a Result és a DisplayResult tükrözze az új formázást.

API Reference összefoglaló

Lásd még:

• Aspose.Words for .NET — Enterprise Documentation