Esportate un foglio nel formato contabile 44 di Excel con un formatter fatto in casa e il PDF mostra $1,234.50 tutto serrato, oppure $* 1,234.50 con un asterisco di troppo. Quello spazio è un fill * dimensionato su larghezza di colonna e font, e la sua posizione nel testo, che HotXLS restituisce da TXLSXCell.GetFormattedTextFill, è tutto ciò che un renderer vuole per contare le ripetizioni
Come lavorano * e _ in un formato numerico Excel?
ECMA-376 Part 1 §18.8.30 definisce entrambi i caratteri nella sua tabella dei simboli dei format code. * ripete il carattere successivo "quante volte basta per riempire la colonna fino alla sua larghezza corrente"; una sezione può tenere un solo asterisco, e se ne compare più di uno, tutti tranne l'ultimo vengono ignorati. _ "salta la larghezza del carattere successivo", così _) lascia un vuoto largo quanto una parentesi di chiusura e gli importi positivi si allineano con i negativi mostrati come (1,234.50). Gli esempi dello standard sono brevi. 0*- mette trattini dopo un numero fino al bordo della cella, *0 davanti a un formato dà zeri in testa, e 0*x mostra 3 come 3xxxxxx in una colonna di una certa larghezza. I formati che combinano entrambi i caratteri sono i formati contabili incorporati di Excel, ID da 41 a 44. Quei numeri sono di Excel: la tabella incorporata in §18.8.30 salta da 40 dritto a 45, e HotXLS registra i quattro codici qui sotto con la numerazione di Excel
| ID Excel | Codice formato | Simbolo | Decimali |
|---|---|---|---|
| 41 | _(* #,##0_);_(* (#,##0);_(* "-"_);_(@_) | nessuno | 0 |
| 42 | _("$"* #,##0_);_("$"* (#,##0);_("$"* "-"_);_(@_) | $ | 0 |
| 43 | _(* #,##0.00_);_(* (#,##0.00);_(* "-"??_);_(@_) | nessuno | 2 |
| 44 | _("$"* #,##0.00_);_("$"* (#,##0.00);_("$"* "-"??_);_(@_) | $ | 2 |
Leggete la sezione positiva del 44, _("$"* #,##0.00_), da sinistra a destra: un vuoto della larghezza di (, un simbolo del dollaro, uno spazio ripetuto fino a riempire la colonna, il numero, e un vuoto della larghezza di ). La sezione negativa scambia quel vuoto finale con vere parentesi. La sezione zero stampa un trattino seguito da ?? — due vuoti larghi quanto una cifra che mettono il trattino nella colonna della virgola decimale. Quale delle quattro sezioni scelga un valore, e cosa faccia una sezione vuota, segue le regole delle sezioni dei formati numerici Excel. Togliete il fill e il simbolo del dollaro finisce sulle cifre. Stampate l'asterisco e il reader si trova davanti la sintassi del formato
Perché un formatter non può inserire da sé le ripetizioni?
Non conosce il conteggio. Il numero di ripetizioni è la larghezza della colonna meno la larghezza di tutto il resto, diviso la larghezza di un carattere di fill. Ogni termine dipende dal font, dalla dimensione, dallo zoom e dal dispositivo di output. Un formatter che restituisce una stringa semplice dovrebbe scegliere un numero, e qualunque numero fisso è sbagliato appena qualcuno ridimensiona la colonna. HotXLS sparte il lavoro. TXLSXCell.FormattedText restituisce il testo visualizzato senza copia del carattere di fill, e GetFormattedTextFill restituisce quello stesso testo più il carattere di fill e un indice: il numero di caratteri prima del punto in cui le ripetizioni vanno messe. Il metodo restituisce False quando il formato non ha fill e per una cella rich text, i cui run vengono disegnati così come sono
Il segno meno automatico viene prima del fill. Con il formato **0 e il valore -5, il testo è -5, il carattere di fill è * e l'indice è 1. Una cella larga mostra quindi -****5, la stessa stringa che il Range.Text di Excel dà per quella cella. Un chiamante senza colonna non riceve alcun fill. La funzione del foglio TEXT è un chiamante del genere, così nel motore di calcolo di HotXLS TEXT(A1, "$* #,##0") con 1234 in A1 valuta a $1,234. Il codice qui sotto imposta tre formati e stampa ciò che un renderer riceve per ognuno
uses
SysUtils, lxHandleX;
procedure InspectFills;
const
Formats: array[0..2] of WideString = (
// lo stesso codice del formato 44 incorporato di Excel
'_("$"* #,##0.00_);_("$"* (#,##0.00);_("$"* "-"??_);_(@_)',
'0*-', // trattini dopo il numero
'**0'); // stelle davanti al numero
Values: array[0..2] of Double = (1234.5, 42, -5);
// Ogni riga dovrebbe stampare:
// [ $] 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'); // l'export PDF dispone il fill per colonna
finally
Book.Free;
end;
end;
Ogni riga mostra il prefisso, il carattere di fill e il suffisso tra parentesi. Fate caso ai vuoti: nella prima riga il prefisso è uno spazio e un simbolo del dollaro, e il suffisso finisce con uno spazio, entrambi prodotti dalle coppie _. SaveAsPDF lavora dalle stesse tre parti e calcola il conteggio delle ripetizioni dalla vera larghezza di colonna. In fills.pdf il simbolo del dollaro dovrebbe sedere sul padding sinistro della prima cella, e i trattini dopo 42 dovrebbero correre fino al bordo destro della seconda. Page setup, margini e font per quel file sono gestiti dalle impostazioni del normale export PDF del foglio di lavoro
Quale lato prende la frazione avanzata di un carattere?
Per General e per le celle allineate a sinistra, lo spazio tra il fill e il suffisso. Il conteggio delle ripetizioni è un numero intero, quindi una frazione di carattere resta quasi sempre indietro, e §18.8.30 non dice nulla su dove vada a finire. L'output PDF di Excel e il suo Range.Text mostrano il piazzamento seguente, che dipende dall'allineamento orizzontale:
- General e left: il prefisso si attacca al padding sinistro, il suffisso al padding destro, e l'avanzo sta tra il fill e il suffisso (a fine riga quando non c'è suffisso)
- Center: prefisso e fill si spostano a destra di metà dell'avanzo; l'allineamento a destra li sposta di tutto
- Fill, justify, distributed e testo a capo: le tre parti corrono da sinistra, con l'avanzo a fine riga
- L'indentazione restringe la larghezza disponibile come al solito, e una cella "shrink to fit" non riceve fill
L'allineamento General è dove i renderer fatti in casa sbagliano. I numeri sotto General sono di norma allineati a destra. Una cella con fill no. Tenete la regola "i numeri vanno a destra" e l'avanzo atterra davanti al fill, spingendo il simbolo del dollaro via dal padding sinistro fino alla larghezza di uno spazio. Giù per una colonna di importi in formato 44, i simboli del dollaro allora traballano da riga a riga. I layout meno comuni seguono lo stesso modello:
- Testo ruotato: la lunghezza del fill viene dalla riga più lunga che ancora ci sta nella cella una volta ruotata
- Rich text: il carattere ripetuto prende lo stile dal carattere subito prima della posizione del fill
- Center across selection: il fill copre l'intera estensione
- Testo multi-riga: solo la riga che contiene la posizione del fill prende le ripetizioni
I fogli right-to-left sono il caso che HotXLS non copia dall'export PDF di Excel. Quell'export butta via i glifi del fill e del prefisso, anche se il Range.Text per le stesse celle li contiene ancora. HotXLS dispone quelle celle come le mostra la griglia, con il fill al suo posto
Disegnare il fill su una canvas VCL
Misurate con la canvas su cui disegnerete. Vale per una grid personalizzata, una banda di report e una miniatura allo stesso modo. La canvas VCL seleziona una dimensione font intera quando scala, quindi una larghezza calcolata dai metrici del font alla dimensione frazionaria esce leggermente più stretta di ciò che GDI dipinge. L'errore per carattere è minuscolo. Su una sequenza di ripetizioni si accumula. Contate dalla larghezza più stretta e la parte sinistra sconfinò nel suo rettangolo; con DT_END_ELLIPSIS tra i flag di disegno, GDI allora mette un'ellissi sopra il suffisso. La routine qui sotto gestisce il caso comune a riga singola con allineamento General o left e manda tutto il resto giù per la strada del semplice TextRect:
uses
Windows, Types, Graphics, lxHandleX;
procedure DrawFilledCell(Canvas: TCanvas; const R: TRect; Cell: TXLSXCell);
const
Pad = 2; // padding interno della cella, in 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);
// Misurate con lo stesso canvas, font e dimensione che disegneranno il testo
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; // solo caratteri interi
// General / left: prefisso + fill a sinistra, suffisso a destra,
// la frazione avanzata sta tra il fill e il suffisso
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;
Disegnare le due metà con chiamate separate tiene l'importo inchiodato al bordo destro a prescindere da come arrotonda la divisione intera. Per le celle centrate o allineate a destra, spostate la prima TextOut di metà o di tutto Avail - Used - Count * FillWidth. Le celle ruotate e multi-riga sono più semplici da trattare in altro modo: inserite le ripetizioni contate nel testo a FillIndex e disegnate il risultato come una stringa unica con il vostro consueto codice di rotazione o wrapping. In una grid costruita a mano come questa grid foglio di calcolo personalizzata in Delphi, la stessa canvas dovrebbe guidare anche le altezze di riga e i range uniti
Fill e underscore in testo a larghezza fissa e CSV
L'output in testo semplice non ha pixel, ma può avere una larghezza. TXLSXCell.FormattedText scrive ogni _x come un normale spazio, così la sezione positiva del formato 44 torna come $1,234.50 con un vuoto a ogni estremità. In un font proporzionale uno spazio è di solito un po' più stretto di una parentesi, abbastanza vicino per una preview. In un report testuale a spaziatura fissa ogni carattere ha lo stesso avanzamento, così lo spazio è un rimpiazzo esatto e il conteggio del fill è aritmetica pura: la larghezza della colonna in caratteri meno la lunghezza del testo. Il CSV è un'altra cosa. Un foglio di calcolo o un database che legge il file vuole un numero, quindi scrivete lì il Value della cella e tenete il testo riempito per i report che le persone leggono:
uses
lxHandleX;
// Colonna report a larghezza fissa: formato 44, valore 1234.5 e Width 14
// danno ' $ 1,234.50 ' (tre spazi ripetuti dopo il simbolo del dollaro)
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; // testo più largo della colonna: nessuna ripetizione
Result := Copy(Text, 1, FillIndex) + StringOfChar(Fill, Count) +
Copy(Text, FillIndex + 1, MaxInt);
end;
Partite da una cella: formato 44, il valore 1234.5, e una chiamata GetFormattedTextFill che dovrebbe riportare uno spazio all'indice 2. Ridimensionate la colonna due volte e controllate che il simbolo del dollaro resti sul padding sinistro mentre 1,234.50 resta sul bordo destro. Una volta che il vostro renderer supera quel test, gli altri allineamenti sono scostamenti della prima TextOut, e una pagina SaveAsPDF del componente Excel HotXLS per Delphi è il riferimento con cui confrontarli