Bir tutar sütunu 250, 730 ve 1.040 tutar. Üretilmiş bir .xls o sütuna >=100 AutoFilter'ı uygular; Excel dosyayı onarım istemi olmadan açar, başlık açılır listesi bir filtrenin ayarlı olduğunu gösterir ve tüm veri satırları kaybolur. Baytlar geçerli BIFF8'dir. Bütün sorun tek bir tür baytıdır: 100 işleneni dize olarak saklanmıştır, Excel bir string işleneni metin olarak karşılaştırır ve hiçbir sayısal hücre "100" ile yapılan metin karşılaştırmasını geçemez. İşleneni bir IEEE double olarak saklayın, aynı filtre üç satırı da elinde tutar
Bir BIFF8 AutoFilter ölçütlerini nerede saklar
Bir BIFF8 AutoFilter üç kayıt türüne yayılır ve ölçütleri içlerinde yalnızca biri taşır. AUTOFILTERINFO ($009D, [MS-XLS] §2.4.8), filtre aralığının kaç sütun kapsadığını kaydeder. FILTERMODE ($009B) gövdesiz bir işarettir ve HotXLS bunu yalnızca en az bir alanın etkin ölçütü olduğunda yazar. Ardından her etkin alan kendi AUTOFILTER kaydını alır ($009E, §2.4.6): bir alan indeksi, düşük iki biti wJoin olan bir grbit sözcüğü, tam 10'ar baytlık iki DOPER yapısı ve varsa string işleneninin karakterlerini taşıyan isteğe bağlı bir kuyruk. Alan indeksi diskte 0 tabanlıdır; oysa TXLSWorksheet.ApplyAutoFilter alanları 1'den numaralar, bu yüzden aralığınızın üçüncü sütunu hex dökümünde kayıt gövdesinin başında 02 00 olarak görünür
Her DOPER'ın ilk baytı olan vt, ardından ne tür bir işlenen geldiğini söyler:
$04, kalan 8 baytta saklanan bir IEEE 754 double'dır; Excel sayısal karşılaştırmayı bu biçimle yapar$06, uzunluğu tek bircchbaytında yaşayan bir dizedir; karakterlerin kendisi kayıt kuyruğuna itilir$08bir Bes değeridir, yani iki bayta paketlenmiş bir Boolean ya da hata kodu$0Cve$0Eişlenen taşımaz; boş olanların tümüyle eşleş ve boş olmayanların tümüyle eşleş demektir
İkinci bayt olan grbitSgn karşılaştırmayı taşır: 1'den 6'ya kadar sırasıyla <, =, <=, >, <> ve >='ye karşılık gelir. HotXLS'te bir ölçüt ayarladıktan sonra her iki bayt da incelenebilir kalır: TXLSWorksheet.AutoFilterColumns bir TXLSAutofilter döndürür, onun Find metodu 1 tabanlı alanın ögesini verir ve o öge, salt okunur DataType, grbitSgn ve Value özellikleriyle Criteria1 ve Criteria2'yi TXLSAutofilterDOPER nesneleri olarak açar. Çalışma kitabı kaydedildiğinde bayt bayt yazılacak olan tam olarak budur
'>=100' filtresi Excel'de neden hiçbir satırla eşleşmiyor?
Filtrenin hiçbir şeyle eşleşmemesinin nedeni, metin işleneninin karşılaştırmayı metin olarak zorlamasıdır. Akla gelen ilk yazım >= önekini doğru biçimde söker, işareti 6'ya ayarlar ve sonra 100 karakterlerini taşıyan bir vtString DOPER yazar; çünkü her ölçüt zaten dize olarak gelir, hem Excel'in kendi diyalogunda hem de VBA'nın AutoFilter çağrısında. Excel o kaydı kabul eder ve yazıldığı gibi değerlendirir. O karşılaştırmada 250 tutan bir sayı hücresi, "100" metninden asla "büyük ya da eşit" değildir; böylece sütun boşalır
TXLSWorksheet.ApplyAutoFilter ile TXLSAutofilter.SetFieldCriteria ölçütleri aynı kurallarla çevirir. Altı operatörden biriyle başlayan ve kalanı sayı olarak ayrışan bir dize, o operatörü işareti yapan bir vtIEEENumber DOPER olur. Sayısal bir Variant (Integer, Int64, Double, Currency ve öteki tam sayı ve kayan nokta türleri), işareti 2 olan bir sayı DOPER olur; bu bir eşitlik testidir. Boolean bir Variant Bes DOPER olur. Operatörsüz çıplak bir dize string DOPER olarak kalır, çünkü Excel de açılır listeden seçilen bir ögeyi böyle saklar
var
Wb: IXLSWorkbook;
Sh: TXLSWorksheet;
Doper: TXLSAutofilterDOPER;
begin
Wb := TXLSWorkbook.Create;
Sh := Wb.Sheets.Add;
Sh.Cells[1, 1].Value := 'Region';
Sh.Cells[1, 2].Value := 'Amount';
Sh.Cells[2, 1].Value := 'North';
Sh.Cells[2, 2].Value := 250;
// Alan 2 = A1:B100 aralığının ikinci sütunu (API'de alanlar 1 tabanlıdır)
Sh.ApplyAutoFilter('A1:B100', 2, '>=100');
Doper := Sh.AutoFilterColumns.Find(2).Criteria1;
// Beklenen: DataType = 4 (IEEE sayı), grbitSgn = 6 (>=)
// Assert kendinizin ekleyeceği bir denetimdir, kitaplığın parçası değildir
Assert((Doper.DataType = 4) and (Doper.grbitSgn = 6));
Wb.SaveAs('orders.xls');
end;
Çıplak dize kuralı, insanları yakalayan kuraldır. Delphi'de '100' ile 100, Variant parametre olarak birbirinin yerine geçebilir gibi görünür; oysa ilki metin eşleşmesi, ikincisi sayısal eşitlik üretir. Tahmin etmek daha kötü olurdu. 00100'u metin olarak tutan bir parça numarası sütunu, 100 için bir sayı DOPER alır ve kendi hücrelerinden hiçbirine denk gelmezdi. Çıplak dize sabitleri, Excel'in liste seçimi için yazdığını birebir yansıtır; bir sayı kastettiğinizde ya sayıyı geçirirsiniz ya da işareti 2 olan bir IEEE DOPER veren '=100' yazarsınız
Ondalık ayırıcılar, tarihler ve 1904 tarih sistemi
Operatörden sonraki sayı testi, Windows bölgesel ayarları ne derse desin, ondalık ayırıcı olarak her zaman nokta kullanır. '>=1.5' sayı DOPER olur; '>=1,5' ayrışmaz, string DOPER olarak kalır ve sayısal bir sütunu Alman ya da Fransız bir makinede Amerikan bir makinedekinden farklı olmayan bir güvenilirlikle boşaltır. Gruplama ayırıcıları da aynı biçimde başarısız olur; bu yüzden '>=1,000' metindir. Operatörle rakamlar arasındaki boşluk kırpılır, dolayısıyla '>= 100' sorunsuzdur. Ayırıcıyı tek bir yerde sabitlemek, bir raporun davranışının onu hangi sunucunun ürettiğine bağlı olarak değişmesini engeller ve bir dosya biçimi için doğru varsaylan budur
Tarihler, aynı tuzağın başka bir kostümüdür. '>=2026-01-01' bir sayı değildir, bu yüzden metin yazılır; oysa Excel tarih hücrelerini seri sayı olarak tutar ve sayısal karşılaştırır. Seriyi geçirin. Bir Delphi TDateTime, 1 Mart 1900 ve sonrasındaki her tarih için Excel 1900 sisteminin serisiyle aynı tam sayı kısmına sahiptir. 1904 tarih sistemine geçirilmiş bir çalışma kitabı 1 Ocak 1904'ten sayar; serileri 1462 daha düşük koşar ve IXLSWorkbook.Date1904, dosyanın hangi sistemi kullandığını söyler. O farkın ayrıntıları 1900 ve 1904 tarih serilerinin sayı biçimleriyle etkileşimi yazısında
var
Fmt: TFormatSettings;
Serial: Integer;
begin
Fmt := TFormatSettings.Create;
Fmt.DecimalSeparator := '.';
// Kesirli eşik: her zaman nokta ile biçimlendir, asla yerel ayar ile değil
Sh.ApplyAutoFilter('A1:D500', 3, '>' + FloatToStr(1499.5, Fmt));
// Tarihler: Excel'in hücrede sakladığı seri sayıyla karşılaştırın
Serial := Trunc(EncodeDate(2026, 1, 1));
if Wb.Date1904 then
Dec(Serial, 1462);
Sh.AutoFilterColumns.SetFieldCriteria(4, '>=' + IntToStr(Serial),
xlAnd, Unassigned);
end;
Sayısal bir Variant, dize birleştirmeye göre daha basit olurdu; ama Variant sayı her zaman eşitlik demektir. Başka her karşılaştırma operatör artı metin olarak yol almak zorundadır, dolayısıyla biçimlendirme adımı atlanamaz
AND ve OR iki koşulu nasıl birleştirir?
AUTOFILTER grbit'inin wJoin bitleri AND için 0, OR için 1'dir ve bunları ters çevirmek kolaydır ve pahalıya patlar. Yer değiştirirseniz "en az 100 ve 500 altı" gibi bir aralık filtresi "en az 100 ya da 500 altı" olarak kaydedilir; bu her sayıyla eşleşir ve filtre hiç uygulanmamış gibi görünür. HotXLS xlAnd için 0, xlOr için 1 yazar ve eşitlik ölçütleri söz konusu olduğunda wJoin'in yanındaki fSimple1 ve fSimple2 bitlerini de ayarlar; o bitler, işareti 2 olan bir DOPER'ı işaretler
Herkese açık sabitler kendi başına bir taşıma tuzağı taşır. HotXLS'te xlAnd 0, xlOr 1'dir; Excel otomasyonu ise onları 1 ve 2 olarak numaralar. XlAutoFilterOperator düz bir Byte olarak bildirilir, dolayısıyla literal sayılarla çevrilmiş bir VBA makrosu uyarısız derlenir. COM'da AND anlamına gelen literal 1 artık OR demektir. OR anlamına gelen literal 2, xlBottom10Items ile çakışır ve HotXLS iki DOPER'ı kurarken xlOr dışındaki her operatör değerini AND saydığı için o ölçüt AND ile birleştirilir. İki literal de ters döner. Adlandırılmış sabitler bütün sorunu önler:
// Tutar 100 (dahil) ile 500 (hariç) arasında
Sh.ApplyAutoFilter('A1:D500', 3, '>=100', xlAnd, '<500');
with Sh.AutoFilterColumns.Find(3) do
begin
// Kendinizin ekleyeceği denetimler: yazılacak olanı doğrulayın
Assert(Operator = xlAnd); // diskte wJoin = 0
Assert(Criteria2.DataType = 4); // IEEE sayı
Assert(Criteria2.grbitSgn = 1); // 1 = küçüktür
end;
Boolean'lar, boşluklar ve 255 karakter üst sınırı
Bir Boolean ölçütü Bes değeri olarak saklanır ([MS-XLS] §2.5.10) ve Bes, değer baytı bBoolErr'ü önce, fError bayrağını sonra koyar. Bunları ters sırada yazarsanız TRUE için bir filtre 1'i hata bayrağına koyar ve Excel ölçütü bir hata kodu olarak okur. Asıl sinir bozucu olan, aynı ters çevirmeyi yapan bir okuyucunun kendi dosyalarını kusursuz biçimde gidiş dönüşlü işlemesidir. Yalnızca kendi yazdığını okuyan bir kitaplık burada uyum hakkında hiçbir şey kanıtlamaz; dosyayı Excel'de açıp filtre diyalogunu denetlemek kanıtlar. HotXLS bBoolErr'ü önce, fError'u 0 olarak yazar; dolayısıyla True geçmek DataType'sı 8, Value'su 1 olan bir DOPER üretir
Boşluk testleri işlenen gerektirmez. Tek başına '=' geçmek tüm boşluklarla eşleş DOPER'ını ($0C), tek başına '<>' ise tüm boş olmayanlarla eşleş DOPER'ını ($0E) üretir. İkisi de tam ölçüttür; bu yüzden alan etkin sayılır ve FILTERMODE yazılır
String işlenenleri DOPER yerleşiminde katı bir üst sınıra çarpar. cch alanı tek bayttır; bir string işleneni en çok 255 karakter tutar, Excel'in kendi filtre diyaloğunun dayattığı üst sınır da aynıdır. HotXLS önce operatörü söker, sonra daha uzun olanı 255 karaktere kırpar; böylece uzunluk baytının taşıp kayıt kuyruğunun adımını şaşırtması engellenir. Uzun bir açıklama sütunundaki filtre bu yüzden geçirdiğiniz metnin bir önekiyle eşleşebilir. Harf büyüklüğüne dokunulmaz: Excel filtreyi uygularken filtre metnini büyük küçük harf gözetmeksizin eşleştirir ve saklanan ölçütü yeniden yazmak yalnızca kullanıcının verisini değiştirirdi. BIFF8'de kuyruk her dizeyi tek baytlık bir bayrak ve ardından gelen UTF-16 kod birimleri olarak saklar ve bildirilen kayıt boyutu tam olarak o baytları saymalıdır; aynı kayıt tutma disiplini BIFF kayıt uzunluğu bildirimlerinin bir Delphi XLS yazıcısında nasıl kaydığı makalesinde ele alınıyor
Birden çok sütunu filtrelemek ve kaydedilen dosyayı denetlemek
Her ApplyAutoFilter çağrısı tüm filtre aralığını yeniden tanımlar; bu yüzden iki çağrıdan sonra yalnızca ikincinin ölçütü hayatta kalır. Metot, herkese açık TXLSWorksheet.SetAutoFilter üzerinden gider; o da aralığı yeniden kurmadan önce her alanı temizler. Bu tek sütun için doğrudur ve ilk kez iki sütun filtrelediğinizde şaşırtır. Birkaç sütun için ApplyAutoFilter'ı aralığı ve ilk ölçütü kurmak üzere bir kez çağırın, sonra kalanlarını tek bir alana dokunup aralığı ve öteki alanları bırakan AutoFilterColumns.SetFieldCriteria ile ekleyin. Her iki yol da aralık dışındaki bir alan numarasını istisna fırlatmadan yok sayar; bu yüzden değer taşıyan denetim, ölçütleri dosyayı yeniden açtıktan sonra geri okumaktır
Sh.ApplyAutoFilter('A1:D500', 1, 'North'); // aralık + alan 1
Sh.AutoFilterColumns.SetFieldCriteria(3, '>=100', xlAnd, Unassigned);
Sh.AutoFilterColumns.SetFieldCriteria(4, True, xlAnd, Unassigned);
Wb.SaveAs('orders.xls');
Wb := TXLSWorkbook.Create;
Wb.Open('orders.xls');
with Wb.Sheets[1].AutoFilterColumns do
begin
// Dosyayı yeniden açtıktan sonra kendinizin ekleyeceği denetimler
Assert(Find(1).Active and (Find(1).Criteria1.DataType = 6)); // metin 'North'
Assert(Find(3).Criteria1.DataType = 4); // sayı 100
Assert(Find(4).Criteria1.DataType = 8); // Boolean TRUE
end;
AUTOFILTER kaydı saklanmış bir tanımdır. Klasik bir XLS çalışma sayfasında HotXLS ölçütleri, dosya açıldığında Excel değerlendirsin diye yazar; sunucu tarafında satır düzeyinde değerlendirme XLSX nesne modelinde yaşar, HotXLS veri doğrulama, AutoFilter ve Delphi'de tablolar yazısında gösterildiği gibi. Excel satırları gizlediğinde, aralığın altındaki toplamlar SUBTOTAL ve AGGREGATE'in gizlenmiş ve filtrelenmiş satırlara nasıl davrandığına bağlıdır; metin olarak saklanan sayısal bir filtre orada sıfır toplam olarak ortaya çıkar
Yukarıda anlatılan ölçüt çevirisi, Bes yerleşimi ve birleştirme bitleri, HotXLS'in kaydettiği her BIFF8 çalışma kitabına yazdığı şeydir; Delphi ve C++Builder için yerel XLSX desteği de yanındadır. Sürümler, tam özellik listesi ve deneme indirmesi HotXLS Delphi elektronik tablo bileşeni sayfasında