TDBGrid export support

La unidad add-on dbGridHotPDFExport (Lib\addons\DBGrid) escribe las columnas visibles y todas las filas del dataset de una TDBGrid en una tabla PDF. Crea, rellena y guarda su propio documento THotPDF, así que la cuadrícula es la única entrada que necesita

Puntos de entrada

• DBGridHotPDFExportToFile(AGrid, AOutputFileName[, AOptions]) escribe el PDF en un archivo
• DBGridHotPDFExportToStream(AGrid, AOutputStream[, AOptions]) lo escribe en un stream, a través de un archivo temporal en %TEMP%
• DBGridHotPDFDefaultOptions devuelve un record TDBGridHotPDFExportOptions con los valores por defecto: A4 en puntos (595 x 842), márgenes de 36 puntos, filas de 22 puntos, fila de cabecera de 24 puntos, Arial 9 con título de 14 puntos, cabecera clBtnFace y filas alternas $00F5F5F5
• TDBGridHotPDFExport es la misma exportación como componente de la paleta HotPDF (registrado por dbGridHotPDFDesign): asigne Grid y OutputFileName, y llame a ExportToFile o ExportToStream. Cada campo de opciones es una propiedad published; ResetOptions restaura los valores por defecto

Qué se exporta

• Las columnas visibles de la cuadrícula que tienen campo, en el orden de la cuadrícula y con sus títulos, o los campos visibles del dataset cuando la cuadrícula no tiene columnas; los anchos de columna mantienen las proporciones de la cuadrícula a lo ancho imprimible
• Todos los registros desde First hasta Eof, usando el DisplayText de cada campo; un texto de celda que no cabe se corta y termina en ...
• Todo el texto usa FontName, que debe tener glifos para los datos: la Arial por defecto muestra el texto chino, japonés o coreano como cuadros vacíos, así que fije una fuente CJK como Microsoft YaHei para esos datos
• Una página nueva empieza cuando la siguiente fila cruzaría el margen inferior, y la fila de cabecera se repite en cada página. El título (Title, o el Name de la cuadrícula) se dibuja una vez, en la primera página, mientras IncludeTitle sea True
• Title, Author, Subject, Keywords, PDFVersion (pdf17 por defecto), PDFACompliance, PDFXCompliance y Compression se pasan al documento

Estado del dataset

• La exportación llama a DisableControls mientras recorre el dataset y a EnableControls al terminar, así que los controles enlazados no se repintan por cada fila
• El registro actual se guarda primero como bookmark y se restaura al final, también cuando la exportación falla
• Una cuadrícula nil, un nombre de archivo vacío, una cuadrícula sin dataset, un dataset inactivo o una cuadrícula sin columnas de datos visibles lanza una excepción en lugar de devolver False

Ejemplo

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