RenderPageToMetafileStream

Renderowanie i drukowanie

Opis

Ta funkcja jest dostępna wyłącznie w edycji Delphi. Renderuje stronę z wybranego dokumentu do obiektu TStream jako metaplik Windows (wyjście wektorowe), zachowując tekst i zawartość wektorową strony zamiast rasteryzować je do pikseli

Wybrany parametr Format steruje wariantem metapliku: mfEMF używa klasycznej ścieżki rozszerzonego metapliku GDI (szeroka zgodność z aplikacjami), mfEMFPlus i mfEMFDual używają ścieżki rejestrowania GDI+ (lepsza wierność przezroczystości i wygładzania), a mfWMF tworzy starszy format 16-bitowy

mfEMFDual zapisuje polecenia GDI i GDI+ w tym samym pliku, dzięki czemu starsze aplikacje obsługujące wyłącznie GDI nadal mogą go odczytać, kosztem większego rozmiaru pliku. Wybierz mfEMFPlus, gdy aplikacja docelowa obsługuje GDI+ (Office, Illustrator, nowoczesne przeglądarki)

Wewnętrznie jest to wygodna obudowa funkcji RenderPageToStream, która odwzorowuje Format na całkowitą wartość Options, dlatego DPI nadal jest mnożone przez skalę RenderScale danego egzemplarza ustawioną za pomocą SetRenderScale

Składnia

Delphi

Function TPDFlib.RenderPageToMetafileStream(DPI: Double; Page: Integer; Format: TPDFlibMetafileFormat; Target: TStream): Integer;

Parametry

DPIDPI używane podczas renderowania strony. Steruje wymiarami ramki metapliku; sama zawartość wektorowa jest niezależna od DPI
PageNumer strony do renderowania
FormatmfEMF = klasyczny EMF GDI; mfEMFPlus = GDI+ EMF+ Only; mfEMFDual = GDI+ EMF+ Dual (rekordy GDI + GDI+, większy rozmiar, lecz szeroka zgodność); mfWMF = starszy 16-bitowy WMF
TargetStrumień, w którym zostaną umieszczone bajty wyrenderowanego metapliku

Wartości zwracane

0Nie udało się wyrenderować strony
1Strona została poprawnie wyrenderowana, a bajty metapliku zapisano w strumieniu