Teknik Makale

BIFF8 Font Index 4'ü Atlar: HotXLS'te Zengin Metin Run'ları

Sekiz FONT kaydı taşıyan bir BIFF8 çalışma kitabında font alanı 8 okunan bir XF kaydı vardır. Sıfırdan sayın, tablonun sonunu bir yuva geçer; yine de Excel hücreyi hiç şikâyet etmeden sekizinci fontla render eder. Değer yasaldır: [MS-XLS] §2.5.129 ilk dört FONT kaydını 0'dan 3'e numaralar, 4'ü tümüyle atlar ve sonraki her kaydı bir tabanlı konumuyla numaralar

Yani beşinci FONT kaydı ifnt 5'tir ve iyi biçimlendirilmiş bir dosyanın FONT kaydı sayısından büyük bir değere hiç ihtiyacı olmaz. Kural spesifikasyonda yazım hatası gibi okunur; insanların onu "düzeltmesinin" nedeni tam da budur ve hücre biçimleri, paylaşılan dize zengin metni ve yorum run'ları aynı FontIndex türünü taşıdığı için yollar arasında farklılaşan bir okuma bazı fontları doğru, bazılarını bir kayıt kaydırarak bağlar. BIFF8 XLUnicodeString cch ve fHigh çözümleme yazısındaki uzunluk ve kodlama tuhaflıklarıyla aynı aileden — dosya sağlamdır, okunuşu değil

[MS-XLS] §2.5.129 ne der ve gerçek bir dosyada nasıl denetlenir

[MS-XLS] §2.5.129, FontIndex'i içinde delik olan bir kayıt konumu olarak tanımlar. 4'ün altındaki değerler sıfır tabanlı, 4'ün üstündekiler bir tabanlıdır ve 4 değeri KULLANILMAMALIDIR. XF kayıtları fontları onunla gösterir, zengin bir paylaşılan dizenin FormatRun girdileri onu kullanır, §2.5.272'de anlatılan TXO biçimlendirme run'ları da öyle

Spesifikasyonun sözüne güvenmek zorunda değilsiniz. Excel'in kendisinin kaydettiği bir .xls dosyasını herhangi bir BIFF kayıt görüntüleyicisiyle dökün, FONT kayıtlarını sayın (kayıt türü $0031), sonra her XF kaydının ($00E0) başındaki font alanını tarayın. En yüksek değer kayıt sayısının içinde kalır ve 4 sayısı listede yoktur. Bir 4 ya da FONT sayısının üstünde bir değer bulursanız dosya Excel dışında bir şey tarafından yazılmıştır ve font numaralaması yakından bakmayı hak eder. Bir tanılama aracı ya da test için eşlemenin tamamı iki işleve sığar

// Kendi yardımcılarınız, hiçbir kütüphanenin parçası değil
// [MS-XLS] 2.5.129 FontIndex: 0..3 sıfır tabanlı, > 4 bir tabanlı, 4 geçersiz
function FontIndexToRecordNo(Ifnt: Word): Integer;  // 1 tabanlı FONT kaydı
begin
  if Ifnt < 4 then
    Result := Ifnt + 1
  else if Ifnt > 4 then
    Result := Ifnt
  else
    Result := -1;  // 4 olmamalı
end;

function RecordNoToFontIndex(RecordNo: Integer): Word;
begin
  if RecordNo <= 4 then
    Result := RecordNo - 1
  else
    Result := RecordNo;
end;
MS-XLS 2.5.129'a göre FontIndex eşlemesi: ifnt 0-3 sıfır tabanlı FONT kaydı konumlarıdır, ifnt 5 ve üstü bir tabanlıdır ve 4 değeri hiç oluşmaz; FontIndexToRecordNo dönüşümüyle
Beşinci FONT kaydı ifnt 5'tir; N FONT kaydı olan bir dosyada en büyük yasal ifnt N'dir ve 4 değeri hiç saklanmaz

HotXLS fontları XF kayıtlarında ve zengin metin run'larında nasıl numaralar

HotXLS her BIFF8 font referansını spesifikasyon numaralamasıyla okur ve yazar. Kayıtta font tablosu, bir şeyin gerçekten başvurduğu fontlara sıkıştırılır ve hayatta kalan her fontun konumu bir FontIndex olur: 1'den 4'e konumlar 0'dan 3'e yazılır, 5 ve üstü değişmeden çıkar. Yükleme bunu tersine çevirir; 5 ve üstü her değer bellekteki fontu bulmak için bir aşağı iner, 5'in altındakiler yerinde kalır. Aynı dönüşüm XF kayıtlarına, paylaşılan dize tablosundaki zengin metin run'larına, yorum ve metin kutusu run'larına ve klasik grafik kayıtlarındaki font referanslarına uygulanır

Uygulama kodu için görünen kısım TXLSComment ve TXLSTextBox üzerindeki TextRuns'tır. TextRuns.FontIndex[I] dosya numaralamasını okunduğu gibi, 4 atlanmış olarak döndürür. Run indeksleri 1 tabanlıdır ve CharIndex[I], I numaralı run'ın başladığı karakter uzaklığıdır. Sıfır tabanlı bir tablo yuvası yerine dosya numarasını açığa etmek burada daha iyi varsayılandır: API'nin bildirdiği, kayıt dökümünün gösterdiğiyle örtüşür. Bedeli, değeri tablo konumu saymadan önce yukarıdaki yardımcıya bir çağrıdır

var
  Book: IXLSWorkbook;
  Note: TXLSComment;
  I: Integer;
  Ifnt: Word;
begin
  Book := TXLSWorkbook.Create;
  if Book.Open('review-notes.xls') <> 1 then
    raise Exception.Create('Cannot open review-notes.xls');
  Note := Book.Sheets[1].Range['C2', 'C2'].Comment;
  if Note <> nil then
    for I := 1 to Note.TextRuns.Count do
    begin
      Ifnt := Note.TextRuns.FontIndex[I];   // dosya numaralaması, 4 atlanmış
      // kendi sağlamlık denetiminiz: 4, dosyanın 2.5.129'u çiğnediği demektir
      if Ifnt = 4 then
        raise Exception.CreateFmt('Run %d uses invalid ifnt 4', [I]);
      Writeln(Format('run %d at char %d: ifnt %d = FONT record #%d',
        [I, Note.TextRuns.CharIndex[I], Ifnt, FontIndexToRecordNo(Ifnt)]));
    end;
end;

Bir kayıttan sonra bir run için saklanan numara, okuduğunuz ya da kurduğunuzdan farklı olabilir. Kayıt, run'ları sıkıştırılan font tablosuyla birlikte yeniden numaralar; numara değişir, gösterdiği font değişmez

Sıfır tabanlı bir düzeltme neden her özel fontu kaydırır

Tuzak genelde makul görünen bir hata raporuyla başlar. Biri sekiz FONT kayıtlı bir çalışma kitabını döker, font 8'i gösteren bir XF görür, yazıcının aralık dışı bir indeks ürettiği sonucuna varır ve hem yazıcıyı hem okuyucuyu düz sıfır tabanlı aritmetiğe çevirir. Round-trip testi yine geçer; çünkü yamalı yazıcı ile yamalı okuyucu birbiriyle uyuşur. Excel uyuşmaz. O şekilde yazılan bir dosya ilk özel fontu ifnt 4 olarak saklar — Excel onu varsayılan fonta çözer — ve sonraki her özel font bir kayıt erken düşer. Excel'in kendi dosyalarını okumak ters yöne gider: her font bir kayıt geç bağlanır

Yazıcı ile okuyucunun bir tabanlı FontIndex değerlerini sıfır tabanlı saydığı sıfır tabanlı yanlış okuma: ilk özel font, Excelin varsayılan fonta çözdüğü yasak ifnt 4 olarak saklanır ve sonraki her font bir kayıt erken düşer; ikisi arasındaki round trip yine de geçer
Aynı yanlış okumayı paylaşan bir yazıcı ve okuyucu her kaydet-sonra-yeniden-aç testini geçer; oysa Excel'in açtığı her font bir kayıt kaymış düşer

İki işaret, yanlış okumayı sevkten önce ele verir. Biri, ifnt < FontCount olduğunu ileri süren bir testtir. Sınır denetimi gibi görünür; gerçekte yanlış okumayı bir gereksinim olarak yazıya geçirir. Yazılan her ifnt'yi spesifikasyon formülüyle bir FONT kaydı adına geri eşleyen bir test, kaymayı ilk koşuda yakalar

Öbür işaret, kendisiyle çelişen koddur. Eksiksiz bir BIFF8 okuyucusu ve yazıcısı 4'ü atla kuralını birkaç yerde uygular: XF çıktısı, XF girdisi, paylaşılan dize run yeniden eşlemesi, yorum run'ları, grafik font kayıtları. Bir değişiklik bunların bazılarını sıfır tabanlı numaralamaya taşıyıp gerisine dokunmadığında dokunulmamış yerler kanıttır; onlardan önce değişiklikten kuşkulanın. Kısmi bir değişiklik uzun süre saklanabilir; çünkü zengin metinde kullanılan fontlara genelde bir hücre biçimi de başvurur

Yorum font çalıştırmaları neden yalnızca ikinci kaydetmede bozulur?

Yorum ve metin kutusu run'ları bir kaydı atlatıp sonrakinde bozulabilir; iki yazıcı alışkanlığı buluştuğunda. İlk alışkanlık asimetrik budamadır: ilk N-1 FONT kaydını koşulsuz yerinde tut ve yalnızca hiçbir XF başvurmuyorsa sonuncuyu düşür. İkincisi, TXO biçimlendirme run'larını ([MS-XLS] §2.4.329) yeniden numaralamadan bayt bayt geri yazmaktır. Her alışkanlık tek kayıtlık bir testi kendi başına geçer. Birlikte, bir nesil bekleyen bir font kaybını kurarlar

Nedeni Excel'in yazdığındadır. Excel'in yazdığı .xls dosyaları çoğunlukla başvurulmayan bir son fontla biter; Çince yerel ayarlı bir sistemde bu 9 pt DengXian'dır. İlk kayıtta, yalnızca bir yorum run'ının kullandığı font bu yüzden hiçbir zaman sonuncu değildir ve görünürde hiçbir şey oynamaz. Ne var ki o kayıt sondaki fontu düşürür ve yalnızca yorumun kullandığı fontu son konuma yükseltir. İkinci kayıt, XF başvurusu olmayan bir son font bulur ve atar. Run'ın ifnt'si artık tablonun sonunu geçer ve Excel varsayılan fonta döner. Çalışma kitabı arada bir font kazandıysa run, onun yerine yeni gelene bağlanır. Tekrar tekrar açılıp not düşülen ve yeniden kaydedilen notlar — yorumlar ve köprüler inceleme iş akışı kurmak yazısındakiler gibi — bunun ilk göründüğü yerdir

İki kayıt boyunca font tablosu: Excel'in yazdığı başvurulmayan son FONT kaydı önce düşer, yalnızca yorumun kullandığı font sonuncu olur ve ikinci kayıtta TXO biçimlendirme run'ları font referansı sayılmadan geri yazılınca atılır
İlk kayıt temiz görünür; çünkü kaybı sondaki font üstlenir. Yorum fontu ancak ikincisinde yok olur; font denetimi birden çok kaydı kapsamak zorundadır

HotXLS yorum ve metin kutusu run'larını paylaşılan dize run'larıyla aynı biçimde ele alır. Font tablosu sıkıştırılmadan önce her çalışma sayfasındaki her run, 4'ü atlayan FontIndex'inden bir tablo yuvasına dönüştürülür ve referans sayılır; bu, yalnızca bir run'ın kullandığı fontu korur. Çıkışta run'lar, XF kayıtlarını yeniden numaralayan aynı yuvadan-kaydedilen-indekse tablosundan geçer. Kapanış TxOLastRun girdisi font taşımaz ve okunduğu gibi yazılır. Bu yeniden numaralama yüzünden FontIndex değerlerini kayıt öncesi ve sonrası karşılaştırmak hiçbir şey söylemez; çözüldükleri font adlarını karşılaştırın

Kopyalar, satır eklemeleri ve çalışma kitapları arasında geçen run'lar

Klasik motorda Range.Copy, CopyRange, Sheets.AddCopy ve Range.Insert ile Range.Delete'in arkasındaki hücre kaydırmaları tek bir hücre kopyalama yolundan geçer; kaydırma, bir kopyanın ardından gelen temizlemeden ibarettir. Yalnızca yorum metnini ve yazarı taşıyan bir kopya, kullanıcı yoruma hiç dokunmadan tek bir satır eklemeyle iki run'lı bir notu tek fontlu bir nota çevirirdi

HotXLS her run'ın başlangıç uzaklığını ve fontunu metinle birlikte kopyalar. Tek çalışma kitabının içinde FontIndex olduğu gibi yeniden kullanılır. Çalışma kitapları arasında font değer olarak taşınır: 4'ü atlayan numara bir yuvaya dönüştürülür, font hedef font tablosunda özniteliklerine göre eşlenir ya da eklenir ve çıkan yuva dosya numaralamasına geri çevrilir. Sheets.AddCopy bir sayfayı başka bir çalışma kitabına kopyaladığında paylaşılan dizelerdeki zengin metin de aynı dönüşümden geçer; iki run türü birbirinden kopamaz. Font tablosu tarafı, çalışma kitapları arası kopya ve formül yeniden bağlama yazısındaki formül tarafıyla aynı değer-olarak yaklaşımı izler

Bunun için test yazarken bilmeye değer iki uç durum vardır:

  • Kaynak ile hedefin aynı yoruma çözüldüğü yerinde bir yapıştırma run'larını korur; hiçbir şey okunmadan temizlenmez
  • Sheets.AddCopy, saklı hücre kaydı olmayan hücrelere çapalanmış yorumları da kopyalar; yalnızca saklı hücreler üzerinde dönen bir döngü bunları kaçırırdı

XLSX motorunda kopyalar yorum run'larını değer olarak klonlar ve yorumlar parçası rFont, strike, u ve vertAlign ile okunup yazılır. Bir run'ın font adı, üstü çizili, altı çizili ve üst ya da alt simge ayarı bu yüzden kaydet-yeniden aç sonrasında sağlam geri gelir

Yeniden numaralamayı atlatan bir regresyon testi

Bu makaledeki her tuzak bellek içi bir testi geçer. Sıfır tabanlı yanlış okuma eşleşen bir yazıcı ve okuyucuda yaşar, yorum fontu kaybı iki kayıt ister ve XLSX'te kaybolan yorum run'ları ancak yeniden açışta görünür. Dolayısıyla test diskten yeniden açmalı, en az iki kayıt nesli koşmalı ve ham font numaraları yerine run yapısını denetlemelidir. Excel'in kendisinin kaydettiği, C2'de ikinci run'ı dosyadaki başka hiçbir şeyin başvurmadığı bir font kullanan iki run'lı bir yorum taşıyan bir çalışma kitabından başlayın; ikinci kaydın aksi halde düşüreceği font odur

procedure CheckNoteAcrossTwoSaves(const SrcFile, Out1, Out2: string);
var
  Book: IXLSWorkbook;
  Note: TXLSComment;
  RunCount: Integer;
  SecondRunAt: Word;
begin
  // Assert çağrıları kendi test denetimlerinizdir
  Book := TXLSWorkbook.Create;
  Assert(Book.Open(SrcFile) = 1);          // Excel kaydetmiş, C2 iki run taşır
  Note := Book.Sheets[1].Range['C2', 'C2'].Comment;
  Assert(Note <> nil);
  RunCount := Note.TextRuns.Count;
  SecondRunAt := Note.TextRuns.CharIndex[2];

  Book.Sheets[1].Range['C2', 'C2'].Copy(Book.Sheets[1].Range['E5', 'E5']);
  Book.Sheets[1].Range['C1', 'C1'].Insert(xlShiftDown);   // C2, C3'e taşınır
  Assert(Book.SaveAs(Out1) = 1);

  Book := TXLSWorkbook.Create;               // ikinci nesil
  Assert(Book.Open(Out1) = 1);
  Assert(Book.SaveAs(Out2) = 1);

  Book := TXLSWorkbook.Create;               // yeniden aç, belleğe asla güvenme
  Assert(Book.Open(Out2) = 1);
  Note := Book.Sheets[1].Range['C3', 'C3'].Comment;
  Assert((Note <> nil) and (Note.TextRuns.Count = RunCount));
  Assert(Note.TextRuns.CharIndex[2] = SecondRunAt);
  Assert(Note.TextRuns.FontIndex[2] <> 4);
  Note := Book.Sheets[1].Range['E5', 'E5'].Comment;
  Assert((Note <> nil) and (Note.TextRuns.Count = RunCount));
end;

Run sayısı ve başlangıç uzaklıkları düzleşmiş notları yakalar. Fontun kendisi testin dışında bir adım daha ister: Out2'yi bir kayıt görüntüleyicide açın, her run'ın ifnt'sini FontIndexToRecordNo'dan geçirin ve düştüğü FONT kaydının kaynak dosyadakiyle aynı font adını taşıdığını doğrulayın. Excel'de kaybolan font, C3 notunun ikinci run'ında varsayılan yazı tipi olarak görünür

Klasik XLS, Delphi ve C++Builder projelerinin pek çoğunda hâlâ karşımıza çıkar ve çıktının Excel'de doğru açılması için BIFF8 dosyasındaki her font tüketicisinin §2.5.129'da uyuşması gerekir. Delphi hesap tablosu bileşeni HotXLS, 4'ü atlayan numaralamayı hücre biçimlerinde, paylaşılan dizelerde, yorumlarda, metin kutularında ve grafiklerde uygular, run'ları her kayıtta yeniden numaralar ve çalışma kitapları arasında değer olarak taşır, XLS ile XLSX'i Excel ya da OLE otomasyonu olmadan okur ve yazar