Alan Sonucu Biçimlendirme
Alan Sonucu Biçimlendirme
Bu kılavuz, Aspose.Words FOSS for .NET içinde bir alanın hesaplanmış sonucuna uygulanan sayısal, tarih/saat ve genel biçimlendirmeyi, FieldFormat sınıfı, GeneralFormat enum’ı ve GeneralFormatCollection kullanarak nasıl kontrol edeceğinizi gösterir. Her Field örneği bu biçimlendirme anahtarlarını Format özelliği aracılığıyla sunar; bu sayfa o özelliğin sunduklarına derin bir bakıştır.
Bir Alanın Biçimlendirmesine Erişme
Her Field — ve FieldDate, FieldCreateDate ve FieldSymbol gibi tiplenmiş alt sınıfları — FieldFormat tipinde bir Format özelliği sunar; bu, alanın sayısal, tarih ve saat ve genel biçimlendirmesine tipli erişim için kullanılır. Field.Format‘ı okuyarak bir alanın koduna eklenmiş anahtarları, ham alan kodu metnini elle düzenlemeden inceleyebilir veya değiştirebilirsiniz.
Sayısal ve Tarih/Saat Biçim Görselleri
FieldFormat.NumericFormat, sayısal bir alan sonucuna uygulanan biçimlendirmeyi tutan yazılabilir bir string özelliğidir. FieldFormat.DateTimeFormat, tarih ve saat alan sonucuna uygulanan biçimlendirmeyi tutan yazılabilir bir string özelliğidir. İlgili alan türünün hesaplanan değerini nasıl işlediğini değiştirmek için bu özelliklerden birini ayarlayın.
Genel Biçimler
FieldFormat.GeneralFormats bir GeneralFormatCollection döndürür — sayısal, metin veya herhangi bir alan sonucuna uygulanan genel amaçlı formatlar. Üyeleri, GeneralFormat enum’undan alınır; bu enum, büyük/küçük harf dönüşümlerini (Upper, Lower, FirstCap, Caps), Roma ve sıralı numaralandırmayı (UppercaseRoman, LowercaseRoman, Ordinal, OrdText), para birimi ve kardinal metni (DollarText, BahtText, CardText), bölgeye özgü numaralandırma sistemlerini (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) ve birleştirme alanına özgü değerler CharFormat, MergeFormat ve MergeFormatInet. None genel biçimlendirmeyi temizler.
GeneralFormatCollection’ı yönetmek
GeneralFormatCollection, IEnumerable<GeneralFormat> uygular, böylece GetEnumerator() ile bir foreach döngüsünde yineleyebilirsiniz. Add(item) çağırarak bir GeneralFormat değeri ekleyin, Remove(item) ile bir değerin tüm oluşumlarını kaldırın veya RemoveAt(index) ile belirli bir konumdaki değeri kaldırın. Count, şu anda kaç genel formatın uygulandığını rapor eder.
İpuçları ve En İyi Uygulamalar
- Biçimlendirme resmini doğrudan alan kodu dizesine gömmek yerine
Field.Format.NumericFormatveyaField.Format.DateTimeFormatayarlayın — yazılmış özellik, alan kodunu ve biçimlendirme anahtarını senkronize tutar. - Birden fazla
GeneralFormatdeğerini (örneğinUpperveMergeFormat) her birini ayrı ayrıGeneralFormats‘e ekleyerek birleştirin; koleksiyon birden fazla girişi izin verir. - Herhangi bir
FieldFormatözelliğini değiştirdikten sonra, sahip alan üzerindeUpdate()çağırın, böylece yeni biçimlendirmeResult/DisplayResult‘de yansıtılır. - Koleksiyonda eski biçimlendirme değerlerini bırakmak yerine, genel bir format girişini açıkça temizlemek için
GeneralFormat.Nonekullanın. - Bir alanın genel biçimlendirme uygulanmadığını varsaymadan önce
GeneralFormatCollection.Countkontrol edin — boş bir koleksiyon veNoneiçeren bir koleksiyon farklı durumlardır.
Yaygın Sorunlar
| Sorun | Neden | Çözüm |
|---|---|---|
NumericFormat değiştirmek görünür bir etki yaratmaz | Değişiklikten sonra alan yeniden hesaplanmadı | Herhangi bir FieldFormat özelliğini düzenledikten sonra alanda Update() çağırın |
Yinelenen genel formatlar GeneralFormats içinde görünür | Add(item), aynı GeneralFormat değeri için birden fazla kez çağrıldı | Eklenmeden önce GeneralFormatCollection.Count kontrol edin veya yineleyin, ya da önce Remove(item) çağırın |
Yanlış giriş GeneralFormats içinden kaldırıldı | RemoveAt(index), önceki bir kaldırmadan sonra kaymış bir indeksle çağrıldı | İndeksle kaldırmadan önce Count kontrol edin ve koleksiyonu yeniden yineleyin |
FAQ
FieldFormat ne için kullanılır?
Bu, Field.Format tarafından sunulan tipli biçimlendirme nesnesidir ve bir alanın sayısal biçimine (NumericFormat), tarih/saat biçimine (DateTimeFormat) ve genel biçimlere (GeneralFormats) erişim sağlar.
Bir alana birden fazla genel biçim uygulanabilir mi?
Evet — GeneralFormats bir GeneralFormatCollection‘dir ve ona birden fazla GeneralFormat değerini Add ekleyebilirsiniz.
Bir alandan tüm genel biçimlendirmeleri nasıl kaldırırım?
Her değer için GeneralFormats üzerinde yinele ve Remove(item) metodunu çağır, ya da belirli bir giriş için RemoveAt(index) kullan.
FieldFormat özelliklerini ayarlamak, alanın görüntülenen metnini otomatik olarak yeniler mi?
Hayır — Format özelliklerini değiştirdikten sonra alanda Update() metodunu çağır, böylece Result ve DisplayResult yeni biçimlendirmeyi yansıtır.
API Reference Özeti
| Sınıf/Yöntem | Açıklama |
|---|---|
FieldFormat | Bir alanın sayısal, tarih/saat ve genel biçimlendirmesine tipli erişim; Field.Format aracılığıyla sunulur |
FieldFormat.NumericFormat | Sayısal alan sonucuna uygulanan biçimlendirme resmi |
FieldFormat.DateTimeFormat | Tarih/saat alan sonucuna uygulanan biçimlendirme resmi |
FieldFormat.GeneralFormats | GeneralFormatCollection alan sonucuna uygulanan genel biçimlerden |
GeneralFormat | Genel biçimlendirme anahtarlarının (büyük/küçük harf dönüşümleri, sayı sistemleri, birleştirme alanı biçimleri) enumu |
GeneralFormatCollection | Tiplenmiş GeneralFormat değerlerinin koleksiyonu; Add, Remove, RemoveAt, Count, GetEnumerator |