Soporte de exportación de TDBGrid

La unidad add-on dbGridHotPDFExport (Lib\addons\DBGrid) escribe las columnas visibles y todos los renglones del dataset de un TDBGrid en una tabla PDF. Crea, llena 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, pasando por un archivo temporal en %TEMP%
• DBGridHotPDFDefaultOptions devuelve un record TDBGridHotPDFExportOptions con los valores predeterminados: A4 en puntos (595 x 842), márgenes de 36 puntos, renglones de 22 puntos, un renglón de encabezado de 24 puntos, Arial 9 con un título de 14 puntos, encabezado clBtnFace y renglones alternos $00F5F5F5
• TDBGridHotPDFExport es la misma exportación como componente de la paleta de páginas 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 predeterminados

Qué se exporta

• Las columnas visibles de la cuadrícula que tienen un 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 conservan las proporciones de la cuadrícula a lo ancho imprimible
• Todos los records 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: el Arial predeterminado muestra texto chino, japonés o coreano como cuadros vacíos, así que para esos datos asigne una fuente CJK como Microsoft YaHei
• Una página nueva arranca cuando el siguiente renglón cruzaría el margen inferior, y el renglón de encabezado 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 (predeterminado pdf17), 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, de modo que los controles enlazados no se repinten por cada renglón
• El record 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

• Clase THotPDF
• Clase THPDFPage
• Panorama de HotPDF