Suporte à exportação de TDBGrid

A unit add-on dbGridHotPDFExport (Lib\addons\DBGrid) grava as colunas visíveis e todas as linhas do dataset de um TDBGrid numa tabela PDF. Ela cria, preenche e salva o próprio documento THotPDF, de modo que a grid é a única entrada de que precisa

Pontos de entrada

• DBGridHotPDFExportToFile(AGrid, AOutputFileName[, AOptions]) grava o PDF num arquivo
• DBGridHotPDFExportToStream(AGrid, AOutputStream[, AOptions]) o grava num stream, por meio de um arquivo temporário em %TEMP%
• DBGridHotPDFDefaultOptions retorna um record TDBGridHotPDFExportOptions com os padrões: A4 em pontos (595 x 842), margens de 36 pontos, linhas de 22 pontos, uma linha de cabeçalho de 24 pontos, Arial 9 com um título de 14 pontos, um cabeçalho clBtnFace e linhas alternadas $00F5F5F5
• TDBGridHotPDFExport é a mesma exportação como componente na página de paleta HotPDF (registrado por dbGridHotPDFDesign): defina Grid e OutputFileName e então chame ExportToFile ou ExportToStream. Cada campo de opção é uma propriedade published; ResetOptions restaura os padrões

O que é exportado

• Colunas visíveis da grid com um campo, na ordem da grid, com os captions de título delas, ou os campos visíveis do dataset quando a grid não tem colunas; as larguras de coluna mantêm as proporções da grid na largura imprimível
• Cada record de First até Eof, usando o DisplayText de cada campo; um texto de célula que não cabe é cortado e termina em ...
• Todo texto usa FontName, que precisa ter glifos para os dados: a Arial padrão mostra texto em chinês, japonês ou coreano como caixas vazias, então defina uma fonte CJK como Microsoft YaHei para esses dados
• Uma nova página começa quando a próxima linha cruzaria a margem inferior, e a linha de cabeçalho se repete em todas as páginas. O título (Title, senão o Name da grid) é desenhado uma única vez, na primeira página, enquanto IncludeTitle é True
• Title, Author, Subject, Keywords, PDFVersion (padrão pdf17), PDFACompliance, PDFXCompliance e Compression são passados ao documento

Estado do dataset

• A exportação chama DisableControls enquanto percorre o dataset e EnableControls depois, de modo que os controles vinculados não repintam a cada linha
• O record atual é salvo como bookmark primeiro e restaurado no final, inclusive quando a exportação falha
• Uma grid nil, um nome de arquivo vazio, uma grid sem dataset, um dataset inativo ou uma grid sem colunas de dados visíveis levantam uma exceção em vez de retornar False

Exemplo

uses
  dbGridHotPDFExport;

var
  Options: TDBGridHotPDFExportOptions;
begin
  Options:= DBGridHotPDFDefaultOptions;
  Options.Title:= 'Customers';
  Options.PageWidth:= 842;   // A4 landscape
  Options.PageHeight:= 595;
  DBGridHotPDFExportToFile(DBGrid1, 'Customers.pdf', Options);
end;

APIs relacionadas

• THotPDF Class
• THPDFPage Class
• HotPDF overview