FitImageAndRelease

Obsługa obrazów, Układ strony, Optymalizacja

Opis

Dopasowuje wskazany obraz do prostokąta docelowego, zachowuje jego proporcje, stosuje żądane wyrównanie i obrót, a następnie zwalnia uchwyt obrazu z pamięci podręcznej obrazów dokumentu

Użyj tej funkcji pomocniczej, gdy generator wsadowy dodaje wiele obrazów jednorazowego użytku, które po umieszczeniu nie powinny pozostać dostępne do wyboru

Składnia

Delphi

Function TPDFlib.FitImageAndRelease(ImageID: Integer; Left, Top, Width, Height: Double; HAlign, VAlign, Rotate: Integer): Integer;

ActiveX

Function PDFlib::FitImageAndRelease(ImageID As Long, Left As Double, Top As Double, Width As Double, Height As Double, HAlign As Long, VAlign As Long, Rotate As Long) As Long

DLL

int DLFitImageAndRelease(int InstanceID, int ImageID, double Left, double Top, double Width, double Height, int HAlign, int VAlign, int Rotate);

Parametry

ImageID	Uchwyt obrazu zwrócony przez funkcję tworzenia lub importowania obrazu
Left	Współrzędna pozioma prostokąta docelowego
Top	Współrzędna pionowa prostokąta docelowego
Width	Szerokość prostokąta docelowego
Height	Wysokość prostokąta docelowego
HAlign	Wyrównanie w poziomie wewnątrz prostokąta, gdzie 0 oznacza lewą stronę, 1 środek, a 2 prawą stronę
VAlign	Wyrównanie w pionie wewnątrz prostokąta, gdzie 0 oznacza górę, 1 środek, a 2 dół
Rotate	Tryb obrotu, gdzie 0 oznacza brak obrotu, 1 obrót o 90 stopni przeciwnie do ruchu wskazówek zegara, 2 obrót o 90 stopni zgodnie z ruchem wskazówek zegara, a 3 obrót o 180 stopni

Wartości zwracane

0	Uchwyt obrazu był nieprawidłowy, opcja umieszczania była poza zakresem, nie można było narysować obrazu albo nie można było zwolnić uchwytu
1	Obraz został dopasowany, a uchwyt zwolniony

Uwagi

Zapisany plik PDF zachowuje obiekt obrazu, ponieważ słownik zasobów strony odwołuje się do niego jeszcze przed zwolnieniem uchwytu pamięci podręcznej

Po pomyślnym wykonaniu tej funkcji SelectImage(ImageID) zwraca 0 dla zwolnionego uchwytu