Экспортируйте лист в бухгалтерском формате Excel 44 самодельным форматировщиком — и PDF покажет $1,234.50 слипшимся или $* 1,234.50 с торчащей звёздочкой. Этот зазор — заполнитель *, размер которого зависит от ширины колонки и шрифта, а его позиция в тексте, которую HotXLS возвращает из TXLSXCell.GetFormattedTextFill, — всё, что нужно рендереру для подсчёта повторов
Как работают * и _ в числовом формате Excel?
ECMA-376 Part 1 §18.8.30 определяет оба символа в своей таблице символов кода формата. * повторяет следующий символ «столько раз, чтобы заполнить колонку до её текущей ширины»; секция может нести одну звёздочку, и если их несколько, все, кроме последней, игнорируются. _ «пропускает ширину следующего символа», поэтому _) оставляет пустое место шириной с закрывающую скобку, и положительные суммы выстраиваются в линию с отрицательными, показанными как (1,234.50). Примеры стандарта коротки. 0*- ставит тире после числа вплоть до края ячейки, *0 перед форматом даёт ведущие нули, а 0*x показывает 3 как 3xxxxxx в колонке одной конкретной ширины. Форматы, сочетающие оба символа, — встроенные бухгалтерские форматы Excel с ID 41–44. Эти номера — самих Excel: встроенная таблица в §18.8.30 прыгает с 40 сразу на 45, и HotXLS регистрирует четыре кода ниже под нумерацией Excel
| Excel ID | Код формата | Символ | Десятичные |
|---|---|---|---|
| 41 | _(* #,##0_);_(* (#,##0);_(* "-"_);_(@_) | нет | 0 |
| 42 | _("$"* #,##0_);_("$"* (#,##0);_("$"* "-"_);_(@_) | $ | 0 |
| 43 | _(* #,##0.00_);_(* (#,##0.00);_(* "-"??_);_(@_) | нет | 2 |
| 44 | _("$"* #,##0.00_);_("$"* (#,##0.00);_("$"* "-"??_);_(@_) | $ | 2 |
Прочитайте положительную секцию 44, _("$"* #,##0.00_), слева направо: пустое место шириной с (, знак доллара, пробел, повторённый до заполнения колонки, число и пустое место шириной с ). Отрицательная секция меняет то замыкающее пустое место на настоящие скобки. Нулевая секция печатает тире, за которым следует ?? — два пустых места шириной с цифру, ставящие тире в колонку десятичной точки. Какую из четырёх секций выберет значение и что делает пустая секция, определяют правила секций числового формата Excel. Уберите заполнитель — и знак доллара сядет на цифры. Напечатайте звёздочку — и читатель смотрит на синтаксис формата
Почему форматировщик не может вставить повторы сам?
Он не знает числа. Число повторов — это ширина колонки минус ширина всего остального, делённая на ширину одного символа-заполнителя. Каждый член зависит от шрифта, кегля, масштаба и устройства вывода. Форматировщик, возвращающий простую строку, был бы обязан выбрать число, и любое фиксированное число неверно, как только кто-то изменит размер колонки. HotXLS делит работу. TXLSXCell.FormattedText возвращает отображаемый текст без единого символа-заполнителя, а GetFormattedTextFill возвращает тот же текст плюс символ-заполнитель и индекс: количество символов перед точкой, где принадлежат повторы. Метод возвращает False, когда в формате нет заполнителя, и для rich-text ячейки, чьи фрагменты рисуются как есть
Автоматический минус стоит перед заполнителем. С форматом **0 и значением -5 текст — -5, символ-заполнитель — *, а индекс — 1. Широкая ячейка поэтому показывает -****5 — ту же строку, что выдаёт для неё Range.Text Excel. Вызывающий без колонки не получает заполнителя вовсе. Функция листа TEXT — такой вызывающий, поэтому в вычислительном движке HotXLS TEXT(A1, "$* #,##0") с 1234 в A1 вычисляется в $1,234. Код ниже задаёт три формата и печатает то, что получает рендерер для каждого
uses
SysUtils, lxHandleX;
procedure InspectFills;
const
Formats: array[0..2] of WideString = (
// тот же код, что у встроенного формата Excel 44
'_("$"* #,##0.00_);_("$"* (#,##0.00);_("$"* "-"??_);_(@_)',
'0*-', // тире после числа
'**0'); // звёздочки перед числом
Values: array[0..2] of Double = (1234.5, 42, -5);
// Каждая строка должна напечатать:
// [ $] 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'); // экспорт PDF раскладывает заполнитель по колонке
finally
Book.Free;
end;
end;
Каждая строка показывает префикс, символ-заполнитель и суффикс в скобках. Заметьте пустые места: в первой строке префикс — пробел и знак доллара, а суффикс кончается пробелом, оба порождены парами _. SaveAsPDF работает от тех же трёх частей и вычисляет число повторов из реальной ширины колонки. В fills.pdf знак доллара должен сидеть на левом отступе первой ячейки, а тире после 42 — бежать до правого края второй. Параметры страницы, поля и шрифты для того файла ведает обычная настройка экспорта листа в PDF
Какая сторона получает дробный остаток от символа?
Для ячеек с General и выравниванием влево — пространство между заполнителем и суффиксом. Число повторов целое, поэтому дробная часть символа почти всегда остаётся в остатке, а §18.8.30 не говорит, куда она идёт. Собственный вывод PDF Excel и его Range.Text показывают следующее размещение, зависящее от горизонтального выравнивания:
- General и влево: префикс прижат к левому отступу, суффикс — к правому, а остаток сидит между заполнителем и суффиксом (в конце строки, когда суффикса нет)
- По центру: префикс и заполнитель сдвигаются вправо на половину остатка; выравнивание вправо — на весь остаток
- Заполнение, выравнивание по ширине, распределённое и переносимый текст: три части идут слева, с остатком в конце строки
- Отступ как обычно сужает доступную ширину, а ячейка «shrink to fit» заполнителя не получает
Выравнивание General — то место, где ошибаются самодельные рендереры. Числа под General обычно выровнены вправо. Ячейка с заполнителем — нет. Держите правило «числа направо» — и остаток приземлится перед заполнителем, отталкивая знак доллара от левого отступа на ширину до одного пробела. Вдоль колонки сумм формата 44 знаки доллара начинают качаться от строки к строке. Реже встречающиеся раскладки следуют той же модели:
- Повернутый текст: длина заполнителя берётся из самой длинной строки, которая всё ещё влезает в ячейку после поворота
- Rich text: повторяемый символ берёт свой стиль из символа прямо перед позицией заполнителя
- По центру выделения: заполнитель накрывает весь диапазон
- Многострочный текст: повторы получает только строка, содержащая позицию заполнителя
Листы справа-налево — случай, который HotXLS не копирует из экспорта PDF Excel. Тот экспорт выбрасывает глифы заполнителя и префикса, хотя Range.Text для тех же ячеек всё ещё содержит их. HotXLS раскладывает такие ячейки, как их показывает сетка, с заполнителем на месте
Рисование заполнителя на холсте VCL
Мерьте тем холстом, которым будете рисовать. Это верно и для пользовательской сетки, и для полосы отчёта, и для миниатюры. Холст VCL при масштабировании выбирает целый размер шрифта, поэтому ширина, посчитанная по метрикам шрифта на дробном размере, выходит чуть уже того, что красит GDI. Ошибка на символ крошечная. На серии повторов она складывается. Считайте от более узкой ширины — и левая часть вылезет из своего прямоугольника; при DT_END_ELLIPSIS среди флагов рисования GDI положит многоточие поверх суффикса. Подпрограмма ниже разбирает обычный однострочный случай с General или выравниванием влево и отправляет всё остальное по простому пути TextRect:
uses
Windows, Types, Graphics, lxHandleX;
procedure DrawFilledCell(Canvas: TCanvas; const R: TRect; Cell: TXLSXCell);
const
Pad = 2; // внутренний отступ ячейки, пиксели
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);
// Мерьте тем же холстом, шрифтом и кеглем, что будут рисовать текст
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; // только целые символы
// General / влево: префикс + заполнитель слева, суффикс справа,
// дробный остаток остаётся между заполнителем и суффиксом
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;
Рисование двух половин отдельными вызовами держит сумму приколоченной к правому краю, как бы ни округлило целочисленное деление. Для центрированных или выровненных вправо ячеек сдвиньте первый TextOut на половину или на весь Avail - Used - Count * FillWidth. Повернутые и многострочные ячейки проще разобрать иначе: вставьте посчитанные повторы в текст на FillIndex и нарисуйте результат одной строкой вашим обычным кодом поворота или переноса. В самосборной сетке вроде этой пользовательской сетки электронных таблиц в Delphi тем же холстом стоит вести и высоты строк, и объединённые диапазоны
Заполнитель и подчёркивание в тексте фиксированной ширины и CSV
У текстового вывода нет пикселей, но ширина быть может. TXLSXCell.FormattedText пишет каждую _x одним обычным пробелом, поэтому положительная секция формата 44 возвращается как $1,234.50 с пустым местом на каждом конце. В пропорциональном шрифте пробел обычно чуть уже скобки — для превью достаточно. В монопространственном текстовом отчёте у каждого символа одинаковая ширина, поэтому пробел — точная замена, а число заполнителей — простая арифметика: ширина колонки в символах минус длина текста. С CSV иначе. Таблица или база, читающая файл, хочет число, поэтому пишите туда Value ячейки, а набитый текст оставьте отчётам, которые читают люди:
uses
lxHandleX;
// Колонка отчёта фиксированной ширины: формат 44, значение 1234.5 и Width 14
// дают ' $ 1,234.50 ' (три повторённых пробела после знака доллара)
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; // текст шире колонки: без повторов
Result := Copy(Text, 1, FillIndex) + StringOfChar(Fill, Count) +
Copy(Text, FillIndex + 1, MaxInt);
end;
Начните с одной ячейки: формат 44, значение 1234.5 и вызов GetFormattedTextFill, который должен сообщить пробел на индексе 2. Дважды измените ширину колонки и проверьте, что знак доллара остаётся на левом отступе, а 1,234.50 — на правом крае. Как только ваш рендерер это пройдёт, остальные выравнивания — смещения первого TextOut, а страница SaveAsPDF от Excel-компонента HotXLS для Delphi — образец, с которым их сравнивать