FitImageAndRelease

Bildverarbeitung, Seitenlayout, Optimierung

Beschreibung

Passt das angegebene Bild unter Beibehaltung seines Seitenverhältnisses in ein Zielrechteck ein, wendet die gewünschte Ausrichtung und Drehung an und gibt anschließend das Bildhandle aus dem Bildcache des Dokuments frei

Referenzseite für FitImageAndRelease; die Funktion gehört zu Image handling, Page layout, Optimisation und behält alle Bezeichner exakt wie gezeigt bei

Syntax

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);

Rückgabewerte

ImageID	Das von einer Funktion zur Bilderstellung oder zum Bildimport zurückgegebene Bildhandle
Left	Die horizontale Koordinate des Zielrechtecks
Top	Die vertikale Koordinate des Zielrechtecks
Width	Die Breite des Zielrechtecks
Height	Die Höhe des Zielrechtecks
HAlign	Horizontale Ausrichtung innerhalb des Rechtecks, wobei 0 für links, 1 für zentriert und 2 für rechts steht
VAlign	Vertikale Ausrichtung innerhalb des Rechtecks, wobei 0 für oben, 1 für zentriert und 2 für unten steht
Rotate	Drehmodus, wobei 0 für normal, 1 für 90 Grad gegen den Uhrzeigersinn, 2 für 90 Grad im Uhrzeigersinn und 3 für 180 Grad steht

Rückgabewerte

0	Das Bild-Handle war ungültig, eine Platzierungsoption lag außerhalb des Bereichs, das Bild konnte nicht gezeichnet werden oder das Handle konnte nicht freigegeben werden
1	Das Bild wurde eingepasst und das Handle freigegeben

Siehe auch

Die gespeicherte PDF-Datei behält das Bildobjekt bei, da das Seitenressourcenwörterbuch bereits darauf verweist, bevor das Cache-Handle freigegeben wird

Nach erfolgreicher Ausführung dieser Funktion gibt SelectImage(ImageID) für das freigegebene Handle 0 zurück