TXLSXConditionalFormats is the rule collection exposed by TXLSXWorksheet.ConditionalFormats and supports cell, visual, text, ranking and average rules
Collection methods
function Add(const ARange: WideString; AOp: TXLSXCfOperator; const AFormula1: WideString): Integer;
function AddDataBar(const ARange: WideString; AColor: LongWord; AMinKind: TXLSCfValueKind; const AMinValue: WideString; AMaxKind: TXLSCfValueKind; const AMaxValue: WideString): Integer;
function AddColorScale2(...): Integer;
function AddColorScale3(...): Integer;
function AddIconSet(const ARange: WideString; ASetType: TXLSIconSetType): Integer;
function AddExpression(const ARange, AFormula: WideString): Integer;
function AddTextRule(const ARange: WideString; AKind: TXLSCfKind; const AText: WideString): Integer;
function AddTop10(const ARange: WideString; ARank: Integer; ABottom, APercent: Boolean): Integer;
function AddAboveAverage(const ARange: WideString; AAbove: Boolean): Integer;
function AddSimpleRule(const ARange: WideString; AKind: TXLSCfKind): Integer;
Rule üyeleri
| Range, Op, Formula1 and Formula2 | Define a standard cell comparison rule |
| Style | Lazy differential format used by cell and expression rules |
| DataBar, ColorScale and IconSet | Visual payloads for their respective rule kinds |
| Priority and StopIfTrue | Control worksheet rule order and short-circuit behaviour |
| Text, Rank, Percent, Bottom and AboveAverage | Parameters for text, top or bottom and average rules |
| TimePeriod | Relative-date band for time-period rules |
Kural hedef aralıkları
2.384.76 itibarıyla sayfa yerel hedefler tek hücreleri, hücre dikdörtgenlerini, $B:$D gibi tüm sütunları ve $5:$8 gibi tüm satırları kabul ediyor; ters çevrilmiş uçlar normalleştiriliyor ve boşluklar, sekmeler veya satır sonları birden çok alanı ayırıyor
Mutlak ve karışık başvular özgün Range metinlerini korur; eşleştirme 1–1048576 satırlarını ve A–XFD sütunlarını kullanır, bozuk veya ızgara dışı alanları atlar ve geçerli kardeş alanları etkin tutar, yeni bir setter istisnası yükseltmez
Sayfa nitelemeli ve dış başvular hedef alan değildir; her kural kendi çalışma sayfasına aittir ve dolar işaretleri sıradan A1 başvuru konumlarında yer almalıdır
Kural araması, hücre ve aralık silme ile koşullu biçim değerlendiricisi aynı hedef geometrisini kullanır; toplama kuralları üst üste binen alanları bir kez sayar ve hedef tüm ızgarayı kapsasa bile yalnızca saklanan hücre değerlerini ziyaret eder
2.384.77 itibarıyla satır ve sütun düzenlemeleri, çalışma sayfası ızgarası içindeki tüm eksenli kural hedeflerini de dönüştürüyor; her satırı veya sütunu kapsayan bir kapsam, o eksen düzenlendiğinde eksiksiz kalıyor, diğer eksendeki düzenlemeler ise hedefi taşıyor, küçültüyor veya kaldırıyor
Aralık klonlama tam kapsama sözleşmesini korur: kural kopyalanmadan önce her hedef alanın kaynak dikdörtgenin içine sığması gerekir ve yalnızca kısmi kesişim bir kuralı kopyalamaz; tüm eksenli hedefler, hedef ızgara içinde kaldığı sürece tüm satırlık veya tüm sütunluk bir kaynaktan klonlanabilir
İç düzenlemeler, gerektiğinde hedefi bölerek ve tek bir ortak çapada eşdeğer kalan parçaları birleştirerek göreli ifade ve hücre karşılaştırma formülü alanlarını korur; kitaplık, Excel'in ekleme sırasında örtük olarak kopyalayabildiği fazladan ızgara sonu biçimlendirmesini yeniden üretmez
Örnek
var Index: Integer;
begin
Index := Sheet.ConditionalFormats.AddExpression('B2:B100', 'B2<0');
Sheet.ConditionalFormats[Index].Style.SetFillBgColor($0000FF);
Sheet.ConditionalFormats.AddColorScale3('C2:C100', $0000FF, $00FFFF, $00FF00, cfvMinOfRange, '', cfvPercentile, '50', cfvMaxOfRange, '');
end;
Koşullu sayı biçimleri
Style.SetNumFormatId, hedef hücrenin temel biçiminden bağımsız olarak diferansiyel bir sayı biçimi ayarlar; 0 kimliği açık bir Genel sıfırlamasıdır, geçersiz kılmanın yokluğu ise temel biçimi geçerli bırakır
Özel biçim kimlikleri 164 + Index şeklindedir; Index, Workbook.NumberFormats.Add sonucunun sıfır tabanlı değeridir. XLSX kaydı yalnızca koşullu kurallarca referans verilen biçimleri korur ve biçim havuzu sıkıştırıldığında kimlikleri günceller
ODS koşullu stilleri
ODS içe ve dışa aktarma, hücre karşılaştırma ve ifade kurallarının diferansiyel stillerini korur: yazı tipi rengi, adı, boyutu, kalın, italik ve altı çizgili özellikleri, düz veya saydam arka plan ve ODS sayı biçimi dönüştürücüsünün desteklediği sayı biçimleri
Açık siyah, normal yazı tipi kalınlığı, altı çizgisizlik ve saydam arka plan geçersiz kılma olarak kalır; kuralda bulunmayan öznitelikler hedef hücrenin temel biçimlendirmesini kullanmaya devam eder
Tema ve indeksli renkler çözümlenmiş renkler olarak dışa aktarılır; görünümleri korunur ama tema veya palet kimlikleri ODS üzerinden gidiş dönüş yapmaz. Yazı tipi şeması üst verisinin ODS karşılığı yoktur
ODS, muhasebe altı çizgisi yerine sıradan tek veya çift altı çizgi kullanır ve desenli dolgular bir arka plan rengiyle temsil edilir; kenarlık ve hizalama geçersiz kılmaları TXLSDxfStyle tarafından dışa açılmaz
Doğrulanmış Excel 16 ODS içe aktarması vurgu renklerini, açık sıfırlamaları, altı çizgiyi ve yüzde biçimlendirmesini korur ama koşullu yazı tipi ailesini ve boyutunu yok sayar; LibreOffice 26.2.5.2 bu adlandırılmış stil özelliklerini okur ve onun dönüştürülmüş XLSX'i bunları Excel'de korur
2.384.75 itibarıyla ODS hücre karşılaştırma ve ifade kuralları, tüm satırlar, tüm sütunlar ve geniş aralıklar dahil eksiksiz hedeflerinde kompakt yinelenen boş taşıyıcıları kullanıyor; üst üste binen kurallar sıralarını koruyor ve yalnızca taşıyıcıda bulunan dolgu, HotXLS yeniden açtığında saklanan hücreler oluşturmuyor
Ayrıca bkz.