Exportez une feuille au format comptable 44 d'Excel avec un formateur maison et le PDF montre $1,234.50 collé, ou $* 1,234.50 avec un astérisque parasite. Ce vide est un remplissage * dimensionné par la largeur de colonne et la police, et sa position dans le texte, que HotXLS renvoie depuis TXLSXCell.GetFormattedTextFill, est tout ce dont un renderer a besoin pour compter les répétitions
Comment fonctionnent * et _ dans un format de nombre Excel ?
ECMA-376 Partie 1 §18.8.30 définit les deux caractères dans sa table des symboles de code de format. * répète le caractère suivant "assez de fois pour remplir la colonne jusqu'à sa largeur courante" ; une section peut porter un astérisque, et si plusieurs apparaissent, tous sauf le dernier sont ignorés. _ "saute la largeur du caractère suivant", si bien que _) laisse un vide de la largeur d'une parenthèse fermante et les montants positifs s'alignent avec les négatifs montrés comme (1,234.50). Les exemples de la norme sont courts. 0*- pose des tirets après un nombre jusqu'au bord de la cellule, *0 devant un format donne des zéros de tête, et 0*x montre 3 comme 3xxxxxx dans une colonne d'une largeur particulière. Les formats qui combinent les deux caractères sont les formats comptables intégrés d'Excel, ID 41 à 44. Ces numéros sont ceux d'Excel : la table intégrée du §18.8.30 saute de 40 droit à 45, et HotXLS enregistre les quatre codes ci-dessous sous la numérotation d'Excel
| ID Excel | Code de format | Symbole | Décimales |
|---|---|---|---|
| 41 | _(* #,##0_);_(* (#,##0);_(* "-"_);_(@_) | aucun | 0 |
| 42 | _("$"* #,##0_);_("$"* (#,##0);_("$"* "-"_);_(@_) | $ | 0 |
| 43 | _(* #,##0.00_);_(* (#,##0.00);_(* "-"??_);_(@_) | aucun | 2 |
| 44 | _("$"* #,##0.00_);_("$"* (#,##0.00);_("$"* "-"??_);_(@_) | $ | 2 |
Lisez la section positive du 44, _("$"* #,##0.00_), de gauche à droite : un vide de la largeur de (, un signe dollar, une espace répétée pour remplir la colonne, le nombre, et un vide de la largeur de ). La section négative échange ce vide final contre de vraies parenthèses. La section zéro imprime un tiret suivi de ?? — deux vides de largeur de chiffre qui posent le tiret dans la colonne du point décimal. Quelle section des quatre choisit une valeur, et que fait une section vide, suit les règles des sections du format de nombre Excel. Retirez le remplissage et le signe dollar atterrit sur les chiffres. Imprimez l'astérisque et le lecteur regarde de la syntaxe de format
Pourquoi un formateur ne peut-il pas insérer les répétitions lui-même ?
Il ne connaît pas le compte. Le nombre de répétitions est la largeur de colonne moins la largeur de tout le reste, divisée par la largeur d'un caractère de remplissage. Chaque terme dépend de la police, de la taille, du zoom et du périphérique de sortie. Un formateur qui renvoie une chaîne simple devrait choisir un nombre, et tout nombre fixe est faux dès que quelqu'un redimensionne la colonne. HotXLS partage le travail. TXLSXCell.FormattedText renvoie le texte d'affichage sans aucune copie du caractère de remplissage, et GetFormattedTextFill renvoie ce même texte plus le caractère de remplissage et un index : le nombre de caractères avant le point où les répétitions appartiennent. La méthode renvoie False quand le format n'a pas de remplissage et pour une cellule en texte riche, dont les runs sont dessinés tels quels
Le signe moins automatique vient avant le remplissage. Avec le format **0 et la valeur -5, le texte est -5, le caractère de remplissage est * et l'index vaut 1. Une cellule large affiche donc -****5, la même chaîne que le Range.Text d'Excel donne pour cette cellule. Un appelant sans colonne ne reçoit aucun remplissage. La fonction de feuille TEXT est un tel appelant, si bien que dans le moteur de calcul HotXLS, TEXT(A1, "$* #,##0") avec 1234 en A1 s'évalue en $1,234. Le code ci-dessous pose trois formats et imprime ce que reçoit un renderer pour chacun
uses
SysUtils, lxHandleX;
procedure InspectFills;
const
Formats: array[0..2] of WideString = (
// le même code que le format intégré 44 d'Excel
'_("$"* #,##0.00_);_("$"* (#,##0.00);_("$"* "-"??_);_(@_)',
'0*-', // tirets après le nombre
'**0'); // étoiles devant le nombre
Values: array[0..2] of Double = (1234.5, 42, -5);
// Chaque ligne doit imprimer :
// [ $] 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 dispose le remplissage par colonne
finally
Book.Free;
end;
end;
Chaque ligne montre le préfixe, le caractère de remplissage et le suffixe entre crochets. Notez les vides : dans la première ligne, le préfixe est une espace et un signe dollar, et le suffixe finit par une espace, tous deux produits par les paires _. SaveAsPDF travaille à partir des mêmes trois parties et calcule le compte de répétitions depuis la vraie largeur de colonne. Dans fills.pdf, le signe dollar doit siéger sur la marge gauche de la première cellule, et les tirets après 42 doivent courir jusqu'au bord droit de la seconde. Mise en page, marges et polices de ce fichier sont prises en charge par les réglages habituels de l'export PDF de feuille
Quel côté reçoit la fraction de caractère restante ?
Pour les cellules General et alignées à gauche, l'espace entre le remplissage et le suffixe. Le compte de répétitions est un entier, si bien qu'une fraction de caractère reste presque toujours en trop, et le §18.8.30 ne dit rien sur où elle va. La sortie PDF propre d'Excel et son Range.Text montrent le placement suivant, qui dépend de l'alignement horizontal :
- General et gauche : le préfixe colle à la marge gauche, le suffixe colle à la marge droite, et la part en trop siège entre le remplissage et le suffixe (en fin de ligne quand il n'y a pas de suffixe)
- Centre : le préfixe et le remplissage se décalent à droite de la moitié du reste ; l'alignement à droite les décale de la totalité
- Remplissage, justifié, distribué et texte renvoyé à la ligne : les trois parties courent depuis la gauche, avec la part en trop en fin de ligne
- L'indentation réduit la largeur disponible comme d'habitude, et une cellule "réduire pour ajuster" ne reçoit aucun remplissage
L'alignement General est l'endroit où les renderers maison se trompent. Les nombres sous General sont normalement alignés à droite. Une cellule à remplissage ne l'est pas. Gardez la règle "les nombres vont à droite" et la part en trop atterrit devant le remplissage, poussant le signe dollar hors de la marge gauche jusqu'à une largeur d'espace. Le long d'une colonne de montants au format 44, les signes dollar titubent alors de ligne en ligne. Les dispositions moins courantes suivent le même modèle :
- Texte pivoté : la longueur du remplissage vient de la ligne la plus longue qui tient encore dans la cellule une fois pivotée
- Texte riche : le caractère répété prend son style du caractère juste avant la position de remplissage
- Centré sur sélection : le remplissage couvre toute la portée
- Texte multiligne : seule la ligne qui contient la position de remplissage reçoit des répétitions
Les feuilles de droite à gauche sont le cas que HotXLS ne copie pas de l'export PDF d'Excel. Cet export abandonne les glyphes du remplissage et du préfixe, bien que le Range.Text des mêmes cellules les contienne encore. HotXLS dispose ces cellules comme la grille les montre, remplissage en place
Dessiner le remplissage sur un canvas VCL
Mesurez avec le canvas sur lequel vous dessinerez. Cela vaut pour une grille personnalisée, une bande de rapport et une vignette pareillement. Le canvas VCL choisit une taille de police entière quand il met à l'échelle, si bien qu'une largeur calculée depuis les métriques de police à la taille fractionnaire sort légèrement plus étroite que ce que GDI peint. L'erreur par caractère est minuscule. Sur une suite de répétitions, elle s'additionne. Comptez depuis la largeur plus étroite et la partie gauche déborde de son rectangle ; avec DT_END_ELLIPSIS parmi les indicateurs de dessin, GDI pose alors des points de suspension par-dessus le suffixe. La routine ci-dessous traite le cas monoligne courant avec alignement General ou gauche et envoie tout le reste par le chemin simple de TextRect :
uses
Windows, Types, Graphics, lxHandleX;
procedure DrawFilledCell(Canvas: TCanvas; const R: TRect; Cell: TXLSXCell);
const
Pad = 2; // marge intérieure de cellule, en pixels
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);
// Mesurez avec le même canvas, la même police et la même taille qui dessineront le texte
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; // caractères entiers seulement
// General / gauche : préfixe + remplissage à gauche, suffixe à droite,
// la fraction en trop reste entre le remplissage et le suffixe
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;
Dessiner les deux moitiés par appels séparés garde le montant épinglé au bord droit quelle que soit la façon dont la division entière arrondit. Pour des cellules centrées ou alignées à droite, décalez le premier TextOut de la moitié ou de la totalité de Avail - Used - Count * FillWidth. Les cellules pivotées et multilignes se traitent plus simplement autrement : insérez les répétitions comptées dans le texte à FillIndex et dessinez le résultat comme une seule chaîne avec votre code habituel de rotation ou de renvoi à la ligne. Dans une grille faite main comme cette grille de tableur personnalisée en Delphi, le même canvas doit piloter aussi les hauteurs de lignes et les plages fusionnées
Remplissage et underscore en texte à largeur fixe et CSV
La sortie en texte brut n'a aucun pixel, mais elle peut quand même avoir une largeur. TXLSXCell.FormattedText écrit chaque _x comme une espace ordinaire, si bien que la section positive du format 44 revient sous la forme $1,234.50 avec un vide à chaque bout. En police proportionnelle, une espace est habituellement un peu plus étroite qu'une parenthèse, assez proche pour un aperçu. Dans un rapport texte à chasse fixe, chaque caractère a la même avance, si bien que l'espace est un doublon exact et le compte de remplissage est de l'arithmétique simple : la largeur de colonne en caractères moins la longueur du texte. Le CSV est différent. Un tableur ou une base qui lit le fichier veut un nombre, donc écrivez-y le Value de la cellule et gardez le texte calé pour les rapports que les humains lisent :
uses
lxHandleX;
// Colonne de rapport à largeur fixe : format 44, valeur 1234.5 et Width 14
// donnent ' $ 1,234.50 ' (trois espaces répétées après le signe dollar)
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; // texte plus large que la colonne : aucune répétition
Result := Copy(Text, 1, FillIndex) + StringOfChar(Fill, Count) +
Copy(Text, FillIndex + 1, MaxInt);
end;
Commencez par une cellule : format 44, la valeur 1234.5, et un appel GetFormattedTextFill qui doit rapporter une espace à l'index 2. Redimensionnez la colonne deux fois et vérifiez que le signe dollar reste sur la marge gauche pendant que 1,234.50 reste sur le bord droit. Une fois votre renderer au point, les autres alignements sont des décalages du premier TextOut, et une page SaveAsPDF du composant Excel HotXLS pour Delphi est la référence à laquelle les comparer