Teknik Makale

Excel Dolgu Karakterleri (*) PDF Dışa Aktarım ve Baskıda

Excel'in muhasebe biçimi 44'teki bir sayfayı el yapımı bir formatlayıcıyla dışa aktarırsanız PDF, $1,234.50'yi yapışık ya da başıboş bir yıldızla $* 1,234.50 olarak basar. O boşluk, sütun genişliği ve font tarafından ölçülendirilen bir * dolgusudur; metindeki konumu — HotXLS'in TXLSXCell.GetFormattedTextFill ile döndürdüğü — tekrar sayısını hesaplamak için bir renderer'ın ihtiyaç duyduğu her şeydir

* ve _ bir Excel sayı biçiminde nasıl çalışır?

ECMA-376 Bölüm 1 §18.8.30, her iki karakteri de biçim kodu simgeleri tablosunda tanımlar. *, ondan sonraki karakteri "sütunu o anki genişliğine kadar dolduracak kadar" tekrarlar; bir bölüm tek bir yıldız taşıyabilir ve birden çok görünüyorsa sonuncusu dışındakiler yok sayılır. _, "sonraki karakterin genişliğini atlar"; dolayısıyla _) bir kapanış parantezi kadar geniş bir boşluk bırakır ve pozitif tutarlar, (1,234.50) olarak gösterilen negatiflerle hizalanır. Standardın örnekleri kısadır. 0*-, sayıdan sonra hücre kenarına dek tire dizer; bir biçimin önündeki *0 baştaki sıfırları verir; 0*x, belirli bir genişlikteki sütunda 3'ü 3xxxxxx olarak gösterir. İki karakteri birleştiren biçimler, Excel'in gömülü muhasebe biçimleridir: 41'den 44'e ID'ler. O sayılar Excel'in kendinindir: §18.8.30'daki gömülü tablo 40'tan doğrudan 45'e atlar ve HotXLS, aşağıdaki dört kodu Excel'in numaralandırmasıyla kaydeder

Excel IDBiçim koduSembolOndalık
41_(* #,##0_);_(* (#,##0);_(* "-"_);_(@_)yok0
42_("$"* #,##0_);_("$"* (#,##0);_("$"* "-"_);_(@_)$0
43_(* #,##0.00_);_(* (#,##0.00);_(* "-"??_);_(@_)yok2
44_("$"* #,##0.00_);_("$"* (#,##0.00);_("$"* "-"??_);_(@_)$2

44'ün pozitif bölümünü, _("$"* #,##0.00_)'u soldan sağa okuyun: ( genişliğinde bir boşluk, bir dolar işareti, sütunu dolduracak kadar tekrarlanan bir boşluk, sayı ve ) genişliğinde bir boşluk. Negatif bölüm, o sondaki boşluğu gerçek parantezlerle değiştirir. Sıfır bölümü bir tire ve ardından ?? basar — tireyi ondalık noktanın sütununa yerleştiren iki hane genişliğinde boşluk. Bir değerin dört bölümden hangisini seçtiği ve boş bir bölümün ne yaptığı, Excel sayı biçimi bölümleri kurallarını izler. Dolguyu çıkarın dolar işareti hanelerin üzerine düşer. Yıldızı bassanız okuyucu biçim sözdizimine bakıyor olur

HotXLS Delphi'de Excel muhasebe biçimi 44'ün pozitif bölümünün anatomisi: parantez genişliğinde boşluklar, dolar işareti, tekrarlanan boşluk dolgusu ve sayı
tek bir yıldız, ondan sonraki karakteri sütun genişliğine kadar tekrarlatır ve muhasebe bölümündeki her boşluk bir alt çizgiden gelir

Bir formatlayıcı tekrarları neden kendisi ekleyemez?

Sayıyı bilmez. Tekrar sayısı, sütun genişliğinden geri kalan her şeyin genişliği çıkarılıp bir dolgu karakterinin genişliğine bölünerek bulunur. Her terim fonta, boyuta, zum'a ve çıktı cihazına bağlıdır. Düz bir dize döndüren bir formatlayıcı bir sayı seçmek zorundadır ve sabit herhangi bir sayı, biri sütunu yeniden boyutlandırdığında yanlış olur. HotXLS işi böler. TXLSXCell.FormattedText, dolgu karakterinin hiçbir kopyasını içermeyen görüntü metnini döndürür; GetFormattedTextFill ise aynı metni dolgu karakteriyle ve bir indeksle döndürür: tekrarların ait olduğu noktadan önceki karakter sayısı. Yöntem, biçimde dolgu yoksa ve runs olduğu gibi çizilen bir rich-text hücresinde False döndürür

Otomatik eksi işareti dolgudan önce gelir. **0 biçimi ve -5 değeriyle metin -5'tir, dolgu karakteri *'tır ve indeks 1'dir. Geniş bir hücre bu yüzden -****5 görüntüler; Excel'in o hücre için verdiği Range.Text de aynı dizgedir. Sütunu olmayan bir arayan hiç dolgu almaz. TEXT çalışma sayfası fonksiyonu öyle bir arayandır; HotXLS hesaplama motorunda A1'de 1234 iken TEXT(A1, "$* #,##0"), $1,234 olarak değerlendirilir. Aşağıdaki kod üç biçim ayarlar ve renderer'ın her biri için aldığını basar

HotXLS Delphi'de GetFormattedTextFill sözleşmesi: bir renderer'ın herhangi bir sütun genişliği için tekrarları saymasını sağlayan öndeki metin, dolgu karakteri ve bölme indeksi
hücre, tekrar sayısı yerine bölme noktasını raporlar; çünkü gerçek sütun genişliğini yalnızca çizim canvas'ı bilir
uses
  SysUtils, lxHandleX;

procedure InspectFills;
const
  Formats: array[0..2] of WideString = (
    // Excel'in gömülü biçim 44'üyle aynı kod
    '_("$"* #,##0.00_);_("$"* (#,##0.00);_("$"* "-"??_);_(@_)',
    '0*-',     // sayıdan sonraki tireler
    '**0');    // sayının önündeki yıldızlar
  Values: array[0..2] of Double = (1234.5, 42, -5);
  // Her satır şunu basmalı:
  //   [ $] dolgu " " [1,234.50 ]
  //   [42] dolgu "-" []
  //   [-] dolgu "*" [5]
var
  Book: TXLSXWorkbook;
  Sheet: TXLSXWorksheet;
  Text: WideString;
  Fill: WideChar;
  FillIndex, I: Integer;
begin
  Book := TXLSXWorkbook.Create;
  try
    Sheet := Book.Sheets.Add('Fills');
    for I := 0 to High(Formats) do
    begin
      Sheet.Cells[I + 1, 1].NumberFormat := Formats[I];
      Sheet.Cells[I + 1, 1].Value := Values[I];
      if Sheet.Cells[I + 1, 1].GetFormattedTextFill(Text, Fill, FillIndex) then
        Writeln(Format('[%s] fill "%s" [%s]', [
          Copy(Text, 1, FillIndex), string(Fill),
          Copy(Text, FillIndex + 1, MaxInt)]))
      else
        Writeln('no fill: ', string(Sheet.Cells[I + 1, 1].FormattedText));
    end;
    Sheet.SaveAsPDF('fills.pdf');   // PDF dışa aktarımı dolguyu sütun bazında dizer
  finally
    Book.Free;
  end;
end;

Her satır öndeki metni, dolgu karakterini ve arkadaki metni köşeli parantezle gösterir. Boşluklara dikkat: ilk satırda öndeki metin bir boşluk ve bir dolar işaretidir, arkadaki metin bir boşlukla biter; ikisi de _ çiftlerinin ürünüdür. SaveAsPDF aynı üç parçadan çalışır ve tekrar sayısını gerçek sütun genişliğinden hesaplar. fills.pdf'de dolar işareti ilk hücrenin sol dolgusunda oturmalı ve 42'nin ardından gelen tireler ikincinin sağ kenarına dek uzanmalı. O dosyanın sayfa kurulumu, kenar boşlukları ve fontları sıradan çalışma sayfası PDF dışa aktarımı ayarlarıyla yönetilir

Karakterin artan kesrini hangi taraf alır?

General ve sola hizalı hücrelerde dolgu ile arkadaki metin arasındaki boşluğu. Tekrar sayısı bir tam sayıdır, dolayısıyla neredeyse her zaman bir karakterin kesri artar ve §18.8.30 bunun nereye gittiğine hiç değinmez. Excel'in kendi PDF çıktısı ve Range.Text'i yatay hizalamaya bağlı aşağıdaki yerleşimi gösterir:

HotXLS Delphi'de dolgu karakterleri için artan kesir yerleşimi matrisi: general ve sol hizalamadan ortaya, sağa ve sığdırmak için küçültmeye
general ve sol hizalama boş kesri dolgu ile arkadaki metin arasına koyar; bu, dolar işaretleri sütununu sabit tutar
  • General ve sol: öndeki metin sol dolguya yapışır, arkadaki metin sağ dolguya yapışır ve artan kesir dolgu ile arkadaki metin arasına düşer (arkadaki metin yoksa satırın sonuna)
  • Orta: öndeki metin ve dolgu artanın yarısı kadar sağa kayar; sağ hizalama hepsi kadar kaydırır
  • Dolgu, justify, dağıtılmış ve sarılı metin: üç parça soldan akar, artan kesir satırın sonunda
  • Girinti her zamanki gibi kullanılabilir genişliği daraltır ve bir "shrink to fit" hücresi hiç dolgu almaz

General hizalama, el yapımı renderer'ların yanıldığı yerdir. General altındaki sayılar normalde sağa hizalanır. Dolgulu bir hücre hizalanmaz. "Sayılar sağa gider" kuralını tutarsanız artan kesir dolgunun önüne düşer ve dolar işaretini sol dolgudan bir boşluk genişliğine kadar iter. 44 biçimli tutarların sütununda dolar işaretleri sonra satırdan satıra titrer. Daha az yaygın düzenler aynı modeli izler:

  • Döndürülmüş metin: dolgu uzunluğu, döndürüldükten sonra hücrenin içine hâlâ sığan en uzun satırdan gelir
  • Rich text: tekrarlanan karakter, dolgu konumunun hemen önündeki karakterden stilini alır
  • Center across selection: dolgu bütün aralığı kaplar
  • Çok satırlı metin: yalnızca dolgu konumunu içeren satır tekrar alır

Sağdan sola sayfalar, HotXLS'in Excel'in PDF dışa aktarımından kopyalamadığı durumdur. O dışa aktarım dolguyu ve öndeki glifleri düşürür; aynı hücreler için Range.Text ise hâlâ onları içerir. HotXLS böyle hücreleri ızgaranın gösterdiği gibi, dolgu yerinde olacak şekilde dizer

Dolguyu bir VCL canvas'ında çizmek

Üzerine çizeceğiniz canvas ile ölçün. Bu, özel bir grid, bir rapor bandı ve bir küçük resim için aynı şekilde geçerlidir. VCL canvas'ı ölçeklerken bir tamsayı font boyutu seçer; dolayısıyla kesirli boyuttaki font metriklerinden hesaplanan genişlik, GDI'nin boyadığından biraz daha dar çıkar. Karakter başına hata çok küçüktür. Bir tekrar dizisi boyunca birikir. Daha dar genişlikten sayarsanız sol kısım dikdörtgenini taşar; DT_END_ELLIPSIS çizim bayrakları arasındaysa GDI sonra son ekin üzerine üç nokta koyar. Aşağıdaki rutin, General veya sol hizalamayla yaygın tek satır durumunu halleder ve gerisini sıradan TextRect yoluna gönderir:

uses
  Windows, Types, Graphics, lxHandleX;

procedure DrawFilledCell(Canvas: TCanvas; const R: TRect; Cell: TXLSXCell);
const
  Pad = 2;                                   // iç hücre dolgusu, piksel
var
  Text: WideString;
  Fill: WideChar;
  FillIndex, Avail, Used, FillWidth, Count: Integer;
  Prefix, Suffix: string;
begin
  if not Cell.GetFormattedTextFill(Text, Fill, FillIndex) then
  begin
    Canvas.TextRect(R, R.Left + Pad, R.Top + Pad, Cell.FormattedText);
    Exit;
  end;
  Prefix := Copy(Text, 1, FillIndex);
  Suffix := Copy(Text, FillIndex + 1, MaxInt);

  // Metni çizecek canvas, font ve boyutun aynısıyla ölç
  Avail := (R.Right - R.Left) - 2 * Pad;
  Used := Canvas.TextWidth(Prefix) + Canvas.TextWidth(Suffix);
  FillWidth := Canvas.TextWidth(string(Fill));
  Count := 0;
  if (FillWidth > 0) and (Used < Avail) then
    Count := (Avail - Used) div FillWidth;   // yalnızca tam karakterler

  // General / sol: öndeki metin + dolgu solda, son ek sağda,
  // artan kesir dolgu ile son ekin arasında kalır
  Canvas.TextOut(R.Left + Pad, R.Top + Pad, Prefix + StringOfChar(Fill, Count));
  Canvas.TextOut(R.Right - Pad - Canvas.TextWidth(Suffix), R.Top + Pad, Suffix);
end;

İki yarıyı ayrı çağrılarla çizmek tutarı, tamsayı bölmesi nasıl yuvarlarsa yuvarlasın sağ kenara sabitler. Ortaya veya sağa hizalı hücreler için ilk TextOut'u Avail - Used - Count * FillWidth'in yarısı veya tamamı kadar kaydırın. Döndürülmüş ve çok satırlı hücreleri başka bir yolla halletmek daha kolaydır: sayılan tekrarları metne FillIndex noktasına ekleyin ve sonucu alışılmış döndürme veya sarma kodunuzla tek bir dize olarak çizin. Bu Delphi'de özel elektronik tablo gridi gibi elle kurulu bir gridde aynı canvas, satır yüksekliklerini ve birleştirilmiş aralıkları da sürmelidir

Sabit genişlikli metinde ve CSV'de dolgu ve alt çizgi

Düz metin çıktısının pikselleri yoktur ama bir genişliği olabilir. TXLSXCell.FormattedText her _x'i sıradan bir boşluk olarak yazar; dolayısıyla 44 biçiminin pozitif bölümü her iki ucunda bir boşlukla $1,234.50 olarak geri gelir. Orantısal bir fontta boşluk genellikle bir parantezden biraz dardır; bir önizleme için yeterince yakın. Sabit genişlikli bir metin raporunda her karakter aynı ilerlemeye sahiptir; dolayısıyla boşluk birebir bir vekildir ve dolgu sayısı düz aritmetiktir: karakter cinsinden sütun genişliği eksi metnin uzunluğu. CSV farklıdır. Dosyayı okuyan bir tablo veya veritabanı bir sayı ister; o yüzden oraya hücrenin Value'sunu yazın ve doldurulmuş metni insanların okuduğu raporlara saklayın:

uses
  lxHandleX;

// Sabit genişlikli rapor sütunu: biçim 44, değer 1234.5 ve Width 14
// ' $   1,234.50 ' verir (dolar işaretinden sonra üç tekrarlanan boşluk)
function PadToWidth(Cell: TXLSXCell; Width: Integer): WideString;
var
  Text: WideString;
  Fill: WideChar;
  FillIndex, Count: Integer;
begin
  if not Cell.GetFormattedTextFill(Text, Fill, FillIndex) then
    Exit(Cell.FormattedText);
  Count := Width - Length(Text);
  if Count < 0 then
    Count := 0;                    // metin sütundan genişse: tekrar yok
  Result := Copy(Text, 1, FillIndex) + StringOfChar(Fill, Count) +
    Copy(Text, FillIndex + 1, MaxInt);
end;

Tek bir hücreyle başlayın: 44 biçimi, 1234.5 değeri ve indeks 2'de bir boşluk raporlaması gereken bir GetFormattedTextFill çağrısı. Sütunu iki kez yeniden boyutlandırın ve dolar işaretinin sol dolguda, 1,234.50'nin sağ kenarda kaldığını kontrol edin. Renderer'ınız bunu geçtikten sonra öbür hizalamalar ilk TextOut'un offset'leridir ve HotXLS Delphi Excel component'ten alınan bir SaveAsPDF sayfası, onlarla karşılaştırılacak referanstır