Exportieren Sie ein Sheet in Excels Accounting-Format 44 mit einem selbstgebauten Formatter, zeigt das PDF $1,234.50 zusammengequetscht oder $* 1,234.50 mit verirrtem Sternchen. Diese Lücke ist ein *-Fill, dessen Größe von Spaltenbreite und Font abhängt, und seine Position im Text, die HotXLS aus TXLSXCell.GetFormattedTextFill zurückgibt, ist alles, was ein Renderer braucht, um die Wiederholungen zu zählen
Wie wirken * und _ in einem Excel-Zahlenformat?
ECMA-376 Part 1 §18.8.30 definiert beide Zeichen in seiner Tabelle der Formatcode-Symbole. * wiederholt das nächste Zeichen "enough times to fill the column to its current width"; ein Abschnitt darf ein Sternchen halten, und tauchen mehrere auf, werden alle außer dem letzten ignoriert. _ "skips the width of the next character", also lässt _) ein Leerzeichen so breit wie eine schließende Klammer, und positive Beträge rücken fluchtend zu Negativen, die als (1,234.50) gezeigt werden. Die Beispiele des Standards sind knapp. 0*- setzt Striche hinter eine Zahl bis zum Zellrand, *0 vor ein Format ergibt führende Nullen, und 0*x zeigt 3 als 3xxxxxx in einer Spalte ganz bestimmter Breite. Die Formate, die beide Zeichen kombinieren, sind Excels eingebaute Accounting-Formate, die IDs 41 bis 44. Diese Nummern sind Excels eigene: Die eingebaute Tabelle in §18.8.30 springt von 40 direkt auf 45, und HotXLS registriert die vier Codes unten unter Excels Nummerierung
| Excel ID | Formatcode | Symbol | Dezimalstellen |
|---|---|---|---|
| 41 | _(* #,##0_);_(* (#,##0);_(* "-"_);_(@_) | none | 0 |
| 42 | _("$"* #,##0_);_("$"* (#,##0);_("$"* "-"_);_(@_) | $ | 0 |
| 43 | _(* #,##0.00_);_(* (#,##0.00);_(* "-"??_);_(@_) | none | 2 |
| 44 | _("$"* #,##0.00_);_("$"* (#,##0.00);_("$"* "-"??_);_(@_) | $ | 2 |
Lesen Sie den positiven Abschnitt von 44, _("$"* #,##0.00_), von links nach rechts: ein Leerzeichen so breit wie (, ein Dollarzeichen, ein bis zur Spaltenbreite wiederholtes Leerzeichen, die Zahl und ein Leerzeichen so breit wie ). Der negative Abschnitt tauscht dieses nachgestellte Leerzeichen gegen echte Klammern. Der Null-Abschnitt druckt einen Strich, gefolgt von ?? — zwei ziffernbreite Leerzeichen, die den Strich in die Spalte des Dezimalpunkts rücken. Welchen der vier Abschnitte ein Wert wählt und was ein leerer Abschnitt tut, folgt den Regeln für Excel-Zahlenformat-Abschnitte. Nehmen Sie das Fill weg, landet das Dollarzeichen auf den Ziffern. Drucken Sie das Sternchen, schaut der Leser auf Formatsyntax
Warum kann ein Formatter die Wiederholungen nicht selbst einfügen?
Er kennt die Zahl nicht. Die Anzahl der Wiederholungen ist die Spaltenbreite minus der Breite von allem anderen, geteilt durch die Breite eines Fill-Zeichens. Jeder Term hängt am Font, an der Größe, am Zoom und am Ausgabegerät. Ein Formatter, der einen schlichten String zurückgibt, müsste eine Zahl wählen, und jede feste Zahl ist falsch, sobald jemand die Spalte in der Größe ändert. HotXLS teilt die Arbeit. TXLSXCell.FormattedText gibt den Anzeigetext ohne eine Kopie des Fill-Zeichens zurück, und GetFormattedTextFill gibt denselben Text plus Fill-Zeichen und einen Index zurück: die Anzahl der Zeichen vor der Stelle, an die die Wiederholungen gehören. Die Methode gibt False zurück, wenn das Format kein Fill hat, und bei einer Rich-Text-Zelle, deren Runs gezeichnet werden, wie sie sind
Das automatische Minuszeichen kommt vor das Fill. Mit dem Format **0 und dem Wert -5 ist der Text -5, das Fill-Zeichen ist * und der Index ist 1. Eine breite Zelle zeigt also -****5, denselben String, den Excels Range.Text für diese Zelle liefert. Ein Aufrufer ohne Spalte bekommt gar kein Fill. Die TEXT-Worksheet-Funktion ist so ein Aufrufer, also wertet in der HotXLS-Calculation-Engine TEXT(A1, "$* #,##0") mit 1234 in A1 zu $1,234 aus. Der Code unten setzt drei Formate und druckt, was ein Renderer für jedes empfängt
uses
SysUtils, lxHandleX;
procedure InspectFills;
const
Formats: array[0..2] of WideString = (
// derselbe Code wie Excels eingebautes Format 44
'_("$"* #,##0.00_);_("$"* (#,##0.00);_("$"* "-"??_);_(@_)',
'0*-', // Striche hinter der Zahl
'**0'); // Sternchen vor der Zahl
Values: array[0..2] of Double = (1234.5, 42, -5);
// Jede Zeile sollte drucken:
// [ $] fill " " [1,234.50 ]
// [42] fill "-" []
// [-] fill "*" [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'); // der PDF-Export setzt das Fill spaltenweise
finally
Book.Free;
end;
end;
Jede Zeile zeigt Präfix, Fill-Zeichen und Suffix in Klammern. Achten Sie auf die Leerzeichen: In der ersten Zeile ist der Präfix ein Leerzeichen und ein Dollarzeichen, und der Suffix endet mit einem Leerzeichen, beide erzeugt von den _-Paaren. SaveAsPDF arbeitet mit denselben drei Teilen und berechnet die Wiederholungszahl aus der echten Spaltenbreite. In fills.pdf sollte das Dollarzeichen auf dem linken Padding der ersten Zelle sitzen, und die Striche nach 42 sollten bis an den rechten Rand der zweiten laufen. Seiteneinrichtung, Ränder und Fonts für diese Datei regeln die üblichen Einstellungen des Worksheet-PDF-Exports
Welche Seite bekommt den Restbruchteil eines Zeichens?
Bei General und linksbündigen Zellen: der Raum zwischen Fill und Suffix. Die Wiederholungszahl ist eine ganze Zahl, also bleibt fast immer ein Bruchteil eines Zeichens übrig, und §18.8.30 sagt nichts darüber, wo er hingeht. Excels eigene PDF-Ausgabe und ihr Range.Text zeigen die folgende Platzierung, die von der horizontalen Ausrichtung abhängt:
- General und links: Der Präfix liegt am linken Padding, der Suffix am rechten Padding, und der Rest sitzt zwischen Fill und Suffix (am Zeilenende, wenn es keinen Suffix gibt)
- Zentriert: Präfix und Fill rücken um die Hälfte des Rests nach rechts; Rechtsbündigkeit rückt sie um alles
- Fill, Justify, Distributed und umgebrochener Text: Die drei Teile laufen von links weiter, mit dem Rest am Zeilenende
- Einzug verkleinert die verfügbare Breite wie üblich, und eine "Shrink to Fit"-Zelle bekommt kein Fill
An der General-Ausrichtung scheitern selbstgebaute Renderer. Zahlen unter General sind normalerweise rechtsbündig. Eine Zelle mit Fill ist es nicht. Halten Sie die Regel "Zahlen gehen nach rechts" durch, landet der Rest vor dem Fill und schiebt das Dollarzeichen um bis zu einer Leerzeichenbreite vom linken Padding weg. In einer Spalte mit Format-44-Beträgen wackeln die Dollarzeichen dann von Zeile zu Zeile. Selteneren Layouts folgt dasselbe Modell:
- Rotierter Text: Die Fill-Länge stammt aus der längsten Zeile, die nach der Rotation noch in die Zelle passt
- Rich Text: Das wiederholte Zeichen nimmt seinen Stil vom Zeichen direkt vor der Fill-Position
- Center across Selection: Das Fill überspannt die gesamte Spanne
- Mehrzeiliger Text: Nur die Zeile mit der Fill-Position bekommt Wiederholungen
Right-to-Left-Sheets sind der Fall, den HotXLS nicht aus Excels PDF-Export übernimmt. Dieser Export wirft Fill und Präfix-Glyphen weg, obwohl Range.Text für dieselben Zellen sie weiterhin enthält. HotXLS setzt solche Zellen so, wie das Grid sie zeigt, mit Fill an Ort und Stelle
Das Fill auf einer VCL-Canvas zeichnen
Messen Sie mit der Canvas, auf der Sie zeichnen werden. Das gilt für ein Custom-Grid, ein Report-Band und ein Thumbnail gleichermaßen. Die VCL-Canvas wählt beim Skalieren eine ganzzahlige Fontgröße, also fällt eine aus Font-Metriken bei der gebrochenen Größe berechnete Breite etwas schmaler aus als das, was GDI malt. Der Fehler pro Zeichen ist winzig. Über eine Reihe von Wiederholungen summiert er sich. Zählen Sie von der schmaleren Breite aus, läuft der linke Teil über sein Rechteck hinaus; mit DT_END_ELLIPSIS unter den Zeichnungs-Flags setzt GDI dann Auslassungspunkte auf den Suffix. Die Routine unten behandelt den verbreiteten einzeiligen Fall mit General- oder Linksbündigkeit und schickt alles andere auf den schlichten TextRect-Weg:
uses
Windows, Types, Graphics, lxHandleX;
procedure DrawFilledCell(Canvas: TCanvas; const R: TRect; Cell: TXLSXCell);
const
Pad = 2; // inneres Zell-Padding, Pixel
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);
// Mit derselben Canvas, demselben Font und derselben Größe messen, die den Text zeichnet
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; // nur ganze Zeichen
// General / links: Präfix + Fill links, Suffix rechts,
// der Restbruchteil bleibt zwischen Fill und Suffix
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;
Die beiden Hälften mit separaten Aufrufen zu zeichnen, hält den Betrag am rechten Rand fest, egal wie die Integerdivision rundet. Bei zentrierten oder rechtsbündigen Zellen verschieben Sie das erste TextOut um die Hälfte oder alles von Avail - Used - Count * FillWidth. Rotierte und mehrzeilige Zellen lassen sich einfacher anders handhaben: die gezählten Wiederholungen an FillIndex in den Text einfügen und das Ergebnis als einen String mit Ihrem üblichen Rotations- oder Umbruchcode zeichnen. In einem handgebauten Grid wie diesem Custom-Spreadsheet-Grid in Delphi sollte dieselbe Canvas auch Zeilenhöhen und verbundene Bereiche treiben
Fill und Underscore in Text mit fester Breite und CSV
Plain-Text-Ausgabe hat keine Pixel, aber sie kann eine Breite haben. TXLSXCell.FormattedText schreibt jedes _x als ein gewöhnliches Leerzeichen, also kommt der positive Abschnitt von Format 44 als $1,234.50 zurück, mit Leerzeichen an jedem Ende. In einem proportionalen Font ist ein Leerzeichen meist etwas schmaler als eine Klammer, nah genug für eine Vorschau. In einem Textreport mit Monospace hat jedes Zeichen denselben Vorlauf, also ist das Leerzeichen ein exakter Stellvertreter, und die Fill-Zählung ist schlichte Arithmetik: die Spaltenbreite in Zeichen minus die Länge des Texts. CSV ist anders. Eine Tabellenkalkulation oder Datenbank, die die Datei liest, will eine Zahl, also schreiben Sie dort den Value der Zelle und behalten den gepolsterten Text für Reports, die Menschen lesen:
uses
lxHandleX;
// Reportspalte mit fester Breite: Format 44, Wert 1234.5 und Width 14
// ergeben ' $ 1,234.50 ' (drei wiederholte Leerzeichen nach dem Dollarzeichen)
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; // Text breiter als die Spalte: keine Wiederholungen
Result := Copy(Text, 1, FillIndex) + StringOfChar(Fill, Count) +
Copy(Text, FillIndex + 1, MaxInt);
end;
Beginnen Sie mit einer Zelle: Format 44, der Wert 1234.5 und ein GetFormattedTextFill-Aufruf, der ein Leerzeichen bei Index 2 melden sollte. Ändern Sie die Spaltenbreite zweimal und prüfen Sie, dass das Dollarzeichen auf dem linken Padding bleibt, während 1,234.50 am rechten Rand bleibt. Hat Ihr Renderer das bestanden, sind die anderen Ausrichtungen Versätze des ersten TextOut, und eine SaveAsPDF-Seite aus der HotXLS Delphi Excel Component ist die Referenz zum Vergleichen