TDBGrid export support

L'unità add-on dbGridHotPDFExport (Lib\addons\DBGrid) scrive le colonne visibili e tutte le righe del dataset di una TDBGrid in una tabella PDF. Crea, riempie e salva un suo documento THotPDF, quindi la griglia è l'unico input di cui ha bisogno

Punti di ingresso

• DBGridHotPDFExportToFile(AGrid, AOutputFileName[, AOptions]) scrive il PDF su un file
• DBGridHotPDFExportToStream(AGrid, AOutputStream[, AOptions]) lo scrive su uno stream, attraverso un file temporaneo in %TEMP%
• DBGridHotPDFDefaultOptions restituisce un record TDBGridHotPDFExportOptions con i default: A4 in punti (595 x 842), margini di 36 punti, righe di 22 punti, una riga di intestazione di 24 punti, Arial 9 con un titolo di 14 punti, intestazione clBtnFace e righe alternate $00F5F5F5
• TDBGridHotPDFExport è la stessa esportazione come componente nella palette HotPDF (registrato da dbGridHotPDFDesign): imposta Grid e OutputFileName, poi chiama ExportToFile o ExportToStream. Ogni campo delle opzioni è una proprietà published; ResetOptions ripristina i default

Cosa viene esportato

• Le colonne visibili della griglia con un campo, nell'ordine della griglia, con le rispettive didascalie, oppure i campi visibili del dataset quando la griglia non ha colonne; le larghezze delle colonne conservano le proporzioni della griglia sulla larghezza stampabile
• Ogni record da First a Eof, usando il DisplayText di ogni campo; il testo di una cella che non entra viene tagliato e finisce con ...
• Tutto il testo usa FontName, che deve avere i glifi per i dati: la Arial predefinita mostra il testo cinese, giapponese o coreano come riquadri vuoti, quindi imposta un font CJK come Microsoft YaHei per dati di questo tipo
• Una nuova pagina parte quando la riga successiva supererebbe il margine in basso, e la riga di intestazione si ripete su ogni pagina. Il titolo (Title, altrimenti il Name della griglia) viene disegnato una volta, sulla prima pagina, mentre IncludeTitle è True
• Title, Author, Subject, Keywords, PDFVersion (default pdf17), PDFACompliance, PDFXCompliance e Compression vengono passati al documento

Stato del dataset

• L'esportazione chiama DisableControls mentre percorre il dataset e EnableControls alla fine, così i controlli collegati non si ridisegnano per ogni riga
• Il record corrente viene prima salvato come bookmark e ripristinato alla fine, anche quando l'esportazione fallisce
• Una griglia nil, un nome file vuoto, una griglia senza dataset, un dataset non attivo o una griglia senza colonne dati visibili sollevano un'eccezione invece di restituire False

Esempio

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;

API correlate

• THotPDF Class
• THPDFPage Class
• HotPDF overview