기술 문서

PDF export와 인쇄에서의 Excel fill 문자(*)

자작 formatter로 Excel의 accounting format 44인 시트를 export하면 PDF는 $1,234.50을 빡빡하게 붙여 보여 주거나 엉뚱한 별표가 붙은 $* 1,234.50을 내놓습니다. 그 간격은 열 폭과 폰트로 크기가 정해지는 * fill이고, 텍스트 안에서의 그 위치 — HotXLS가 TXLSXCell.GetFormattedTextFill에서 돌려주는 — 만이 renderer가 반복 횟수를 세는 데 필요한 전부입니다

*와 _는 Excel number format에서 어떻게 동작하는가

ECMA-376 Part 1 §18.8.30은 format-code 기호 표에서 두 문자를 정의합니다. *는 다음 문자를 "열을 현재 폭까지 채울 만큼 충분히" 반복하고, 하나의 section은 별표 하나를 지닐 수 있으며 여러 개가 나타나면 마지막 하나를 빼고 모두 무시됩니다. _는 "다음 문자의 폭을 건너뛰므로", _)는 닫는 괄호만 한 빈칸을 남기고 양수 금액이 (1,234.50)으로 표시되는 음수와 줄을 맞춥니다. 표준의 예는 짧습니다. 0*-는 숫자 뒤에 셀 가장자리까지 대시를 놓고, format 앞의 *0은 leading zero를 주며, 0*x는 특정 폭의 열에서 3을 3xxxxxx으로 보여 줍니다. 두 문자를 결합한 format은 Excel의 내장 accounting format, 즉 ID 41부터 44입니다. 그 번호들은 Excel 자체의 것입니다. §18.8.30의 built-in 표는 40에서 곧장 45로 뛰어 넘고, HotXLS는 아래 네 코드를 Excel의 번호 체계로 등록합니다

Excel IDformat 코드기호소수 자릿수
41_(* #,##0_);_(* (#,##0);_(* "-"_);_(@_)없음0
42_("$"* #,##0_);_("$"* (#,##0);_("$"* "-"_);_(@_)$0
43_(* #,##0.00_);_(* (#,##0.00);_(* "-"??_);_(@_)없음2
44_("$"* #,##0.00_);_("$"* (#,##0.00);_("$"* "-"??_);_(@_)$2

44의 양수 section, _("$"* #,##0.00_)을 왼쪽부터 읽으면 이렇습니다. (만 한 폭의 빈칸, 달러 부호, 열을 채울 만큼 반복된 공백, 숫자, 그리고 )만 한 폭의 빈칸. 음수 section은 그 뒤의 빈칸을 진짜 괄호로 바꿉니다. 영(0) section은 대시 뒤에 ??를 인쇄하는데, 자릿수 하나만 한 폭의 빈칸 둘로 대시를 소수점 열에 놓이게 합니다. 값이 네 section 중 어느 것을 택하는지, 빈 section이 무엇을 하는지는 Excel number format section의 규칙을 따릅니다. fill을 걷어 내면 달러 부호가 숫자 위에 착지하고, 별표를 인쇄하면 독자는 format 문법을 보게 됩니다

Delphi용 HotXLS에서 Excel accounting format 44 양수 section의 해부도: 괄호 폭의 빈칸, 달러 부호, 반복되는 공백 fill, 숫자
별표 하나가 다음 문자를 열 폭까지 반복하게 만들고, accounting section의 모든 빈칸은 underscore에서 나옵니다

formatter가 반복을 스스로 끼워 넣지 못하는 이유

횟수를 모르기 때문입니다. 반복 횟수는 열 폭에서 그 외의 모든 것의 폭을 뺀 것을 fill 문자 하나의 폭으로 나눈 값입니다. 모든 항은 폰트와 크기, 줌, 출력 장치에 의존합니다. 평범한 string을 반환하는 formatter는 숫자를 골라야 하고, 누군가 열 크기를 바꾸는 순간 고정된 숫자는 전부 틀립니다. HotXLS는 일을 나눕니다. TXLSXCell.FormattedText는 fill 문자 복사본 없이 표시 텍스트를 반환하고, GetFormattedTextFill은 같은 텍스트에 fill 문자와 인덱스를 더해 반환합니다. 반복이 속할 지점 앞의 문자 수죠. 이 메서드는 format에 fill이 없을 때와 rich-text 셀, 즉 run이 있는 그대로 그려지는 셀에 대해서는 False를 반환합니다

자동 마이너스 부호는 fill보다 앞에 옵니다. format **0과 값 -5라면 텍스트는 -5, fill 문자는 *, 인덱스는 1입니다. 넉넉한 셀은 따라서 -****5를 표시하는데, Excel의 Range.Text가 그 셀에 대해 주는 string과 같습니다. 열이 없는 호출자는 fill을 아예 받지 못합니다. TEXT 워크시트 함수가 그런 호출자라서, HotXLS calculation engine에서 A1에 1234가 있을 때 TEXT(A1, "$* #,##0")는 $1,234로 평가됩니다. 아래 코드는 format 셋을 설정하고 renderer가 각각에 대해 받는 것을 인쇄합니다

Delphi용 HotXLS의 GetFormattedTextFill 계약: 접두 텍스트, fill 문자, 분할 인덱스로 renderer가 어떤 열 폭에도 반복 횟수를 셉니다
셀은 반복 횟수 대신 분할 지점을 보고합니다. 실제 열 폭을 아는 것은 그리는 canvas뿐이니까요
uses
  SysUtils, lxHandleX;

procedure InspectFills;
const
  Formats: array[0..2] of WideString = (
    // Excel 내장 format 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 export는 fill을 열 단위로 배치합니다
  finally
    Book.Free;
  end;
end;

각 줄은 접두부와 fill 문자, 접미부를 괄호 안에 보여 줍니다. 빈칸을 눈여겨보세요. 첫 행에서 접두부는 공백과 달러 부호이고 접미부는 공백으로 끝나는데, 둘 다 _ 짝이 만들어 낸 것입니다. SaveAsPDF는 같은 세 부분에서 일하며 실제 열 폭으로 반복 횟수를 계산합니다. fills.pdf에서 달러 부호는 첫 셀의 왼쪽 패딩에 앉아야 하고, 42 뒤의 대시는 두 번째 셀의 오른쪽 가장자리까지 이어져야 합니다. 그 파일의 page setup과 여백, 폰트는 평범한 워크시트 PDF export 설정이 처리합니다

남은 글자 조각은 어느 쪽에 놓이는가

General과 왼쪽 정렬 셀이라면 fill과 접미부 사이입니다. 반복 횟수는 정수이므로 글자 조각 하나가 거의 항상 남는데, §18.8.30은 그것이 어디로 가는지 말하지 않습니다. Excel의 PDF 출력과 Range.Text는 다음 배치를 보여 줍니다. 수평 정렬에 따라 달라집니다:

Delphi용 HotXLS에서 fill 문자의 남은 조각 배치 매트릭스: general과 왼쪽 정렬부터 center, right, shrink to fit까지
general과 왼쪽 정렬은 남은 조각을 fill과 접미부 사이에 놓아, 달러 부호 열이 흔들리지 않게 유지합니다
  • General과 왼쪽: 접두부는 왼쪽 패딩에 붙고 접미부는 오른쪽 패딩에 붙으며, 남은 조각은 fill과 접미부 사이에 앉습니다(접미부가 없으면 줄 끝에)
  • Center: 접두부와 fill은 남은 조각의 절반만큼 오른쪽으로 움직입니다. right 정렬은 그 전부만큼 움직이죠
  • Fill, justify, distributed, 줄바꿈 텍스트: 세 부분은 왼쪽부터 이어지고, 남은 조각은 줄 끝에 놓입니다
  • 들여쓰기는 여느 때처럼 이용 가능한 폭을 좁히고, "shrink to fit" 셀은 fill을 받지 못합니다

General 정렬이 자작 renderer가 틀어지는 지점입니다. General 아래의 숫자는 보통 오른쪽 정렬이지만, fill이 있는 셀은 그렇지 않습니다. "숫자는 오른쪽으로" 규칙을 유지하면 남은 조각이 fill 앞에 떨어져, 달러 부호가 공백 하나만 한 폭까지 왼쪽 패딩에서 밀려 납니다. format 44 금액 열을 내려가면 달러 부호들이 행마다 흔들리죠. 덜 흔한 레이아웃도 같은 모델을 따릅니다:

  • 회전 텍스트: fill 길이는 회전한 뒤에도 셀 안에 들어맞는 가장 긴 줄에서 나옵니다
  • Rich text: 반복되는 문자는 fill 위치 바로 앞의 문자에서 스타일을 가져옵니다
  • Center across selection: fill이 전체 범위를 덮습니다
  • 여러 줄 텍스트: fill 위치를 담은 줄만 반복을 얻습니다

오른쪽에서 왼쪽 시트는 HotXLS가 Excel의 PDF export에서 복사하지 않는 사례입니다. 그 export는 fill과 접두 glyph를 떨어뜨리는데, 같은 셀의 Range.Text는 여전히 그것들을 담고 있음에도 말입니다. HotXLS는 그런 셀을 격자가 보여 주는 대로, fill을 제자리에 둔 채 배치합니다

VCL canvas에 fill 그리기

실제로 그릴 canvas로 측정하세요. custom grid, report band, thumbnail 모두 마찬가지입니다. VCL canvas는 스케일할 때 정수 font size를 택하므로, fractional 크기의 font metrics로 계산한 폭은 GDI가 그리는 것보다 약간 좁게 나옵니다. 문자 하나당 오차는 자잘하지만 반복이 이어지면 쌓입니다. 더 좁은 폭에서 세면 왼쪽 부분이 자기 사각형을 넘고, drawing flags에 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);

  // 텍스트를 그릴 것과 같은 canvas, 폰트, 크기로 측정합니다
  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 / 왼쪽: 접두부 + fill은 왼쪽에, 접미부는 오른쪽에,
  // 남은 조각은 fill과 접미부 사이에 머뭅니다
  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;

두 부분을 별도 호출로 그리면 정수 나눗셈이 어떻게 반올림하든 금액이 오른쪽 가장자리에 고정됩니다. center나 right 정렬 셀이라면 첫 TextOut을 Avail - Used - Count * FillWidth의 절반이나 전부만큼 옮기세요. 회전과 여러 줄 셀은 다른 방법이 더 간단합니다. 센 반복을 FillIndex 위치의 텍스트에 끼워 넣고 결과를 평소의 회전이나 줄바꿈 코드로 하나의 string으로 그리면 됩니다. 이 Delphi custom 스프레드시트 grid 같은 손수 만든 grid에서는 같은 canvas가 행 높이와 병합 범위도 주관해야 합니다

고정폭 텍스트와 CSV에서의 fill과 underscore

평문 텍스트 출력에는 픽셀이 없지만 여전히 폭은 있을 수 있습니다. TXLSXCell.FormattedText는 각 _x를 평범한 공백 하나로 적으므로, format 44의 양수 section은 양 끝에 빈칸을 둔 $1,234.50 으로 돌아옵니다. proportional 폰트에서 공백은 보통 괄호보다 조금 좁은데, preview에는 충분히 가깝습니다. monospaced 텍스트 보고서에서는 모든 문자의 advance가 같으므로 공백이 정확한 대역이고 fill 횟수는 단순 산술입니다. 문자 단위 열 폭에서 텍스트 길이를 뺀 것이죠. CSV는 다릅니다. 파일을 읽는 스프레드시트나 데이터베이스는 숫자를 원하므로, 거기에는 셀의 Value를 적고 패딩된 텍스트는 사람이 읽는 보고서에 남겨 두세요:

uses
  lxHandleX;

// 고정폭 보고서 열: format 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;

셀 하나로 시작하세요. format 44, 값 1234.5, 그리고 인덱스 2의 공백을 보고해야 하는 GetFormattedTextFill 호출입니다. 열 크기를 두 번 바꾸고 달러 부호가 왼쪽 패딩에 머무는 동안 1,234.50이 오른쪽 가장자리에 머무는지 확인하세요. renderer가 여기서 통과하면 다른 정렬은 첫 TextOut의 오프셋일 뿐이고, HotXLS Delphi Excel component의 SaveAsPDF 페이지가 비교할 기준입니다