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
| DPI | DPI używane podczas renderowania strony. Steruje wymiarami ramki metapliku; sama zawartość wektorowa jest niezależna od DPI |
|---|---|
| Page | Numer strony do renderowania |
| Format | mfEMF = 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 |
| Target | Strumień, w którym zostaną umieszczone bajty wyrenderowanego metapliku |
Wartości zwracane
| 0 | Nie udało się wyrenderować strony |
|---|---|
| 1 | Strona została poprawnie wyrenderowana, a bajty metapliku zapisano w strumieniu |