Obsługa eksportu TDBGrid

Jednostka dodatkowa dbGridHotPDFExport (Lib\addons\DBGrid) zapisuje widoczne kolumny i wszystkie wiersze datasetu TDBGrid do tabeli PDF. Tworzy, wypełnia i zapisuje własny dokument THotPDF, więc grid to jedyne, czego potrzebuje na wejściu

Punkty wejścia

• DBGridHotPDFExportToFile(AGrid, AOutputFileName[, AOptions]) zapisuje PDF do pliku
• DBGridHotPDFExportToStream(AGrid, AOutputStream[, AOptions]) zapisuje go do strumienia, przez plik tymczasowy w %TEMP%
• DBGridHotPDFDefaultOptions zwraca rekord TDBGridHotPDFExportOptions z wartościami domyślnymi: A4 w punktach (595 x 842), marginesy 36 punktów, wiersze 22 punkty, wiersz nagłówka 24 punkty, Arial 9 z tytułem 14 punktów, nagłówek clBtnFace i naprzemienne wiersze $00F5F5F5
• TDBGridHotPDFExport to ten sam eksport jako komponent na palecie HotPDF (rejestrowanym przez dbGridHotPDFDesign): ustaw Grid i OutputFileName, potem wywołaj ExportToFile albo ExportToStream. Każde pole opcji jest opublikowaną właściwością; ResetOptions przywraca wartości domyślne

Co jest eksportowane

• Widoczne kolumny grida z polem, w kolejności grida, z tytułami kolumn, albo widoczne pola datasetu, gdy grid nie ma kolumn; szerokości kolumn zachowują proporcje grida na całej szerokości drukowalnej
• Każdy rekord od First do Eof, z użyciem DisplayText każdego pola; tekst komórki, który się nie mieści, jest ucinany i kończy się ...
• Cały tekst używa FontName, który musi mieć glyphy dla tych danych: domyślny Arial pokazuje tekst chiński, japoński czy koreański jako puste kwadraty, więc dla takich danych ustaw font CJK, np. Microsoft YaHei
• Nowa strona zaczyna się, gdy następny wiersz przekroczyłby dolny margines, a wiersz nagłówka powtarza się na każdej stronie. Tytuł (Title, inaczej Name grida) jest rysowany raz, na pierwszej stronie, dopóki IncludeTitle jest True
• Title, Author, Subject, Keywords, PDFVersion (domyślnie pdf17), PDFACompliance, PDFXCompliance i Compression są przekazywane do dokumentu

Stan datasetu

• Eksport woła DisableControls na czas przejścia po datasecie i EnableControls po nim, więc powiązane kontrolki nie przerysowują się przy każdym wierszu
• Bieżący rekord jest najpierw zapamiętywany zakładką i odtwarzany na końcu, także gdy eksport zawiedzie
• Grid nilowy, pusta nazwa pliku, grid bez datasetu, nieaktywny dataset albo grid bez widocznych kolumn danych kończy się wyjątkiem zamiast zwrócić False

Przykład

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;

Powiązane API

• THotPDF Class
• THPDFPage Class
• Omówienie HotPDF