ImageCreate¶
ImageCreate erzeugt ein Bildobjekt. Falls ein Dateiname angegeben wird, wird das Bildobjekt aus der Datei geladen.
-
hImg = ImageCreate(ssFileName)
-
hImg = ImageCreate(hImgOther)
-
hImg = ImageCreate(width, height)
Returnwert
hImg ist die Zugriffsnummer (Handle) des erzeugten Bildobjekts oder 0 falls das Objekt nicht erzeugt werden konnte.
Parameter
-
hImgOther
Falls hImgOther angegeben wird, erzeugt die Funktion eine Kopie von hImgOther.
-
ssFileName
ssFileName ist der Name einer Bilddatei. Folgende Typen werden zur Zeit unterstützt:
Typ Bedeutung JPG Jpeg PNG PNG Gif Gif TIFF Tagged Image File Format BMP, BMZ Bitmap und Bitmap komprimiert. WMF, WMZ Windows Meta File und Windows Meta File komprimiert. EMF, EMZ Enhanced Meta File und Enhanced Meta File komprimiert. EMF+, EMZ+ Enhanced Meta File with Extensions und Enhanced Meta File with Extensions komprimiert. EMF+Dual, EMZ+Dual EMF und EMF+ in einer Datei kombiniert. Anmerkung: Die Typen EMF, EMF+, EMF+Dual haben gewöhnlich alle die Dateierweiterung
.emf
.
-
width
width ist die Breite in Pixel.
-
height
height ist die Höhe in Pixel.
Beispiel
hDoc = DocCreate();
hPage = PageCreate();
hLayer = LayerCreate();
DocAddPage(hDoc, hPage);
PageAddLayer(hPage, hLayer);
ssImage = "d:/c0005.jpg"
hImg = ImageCreate(ssImage);
if (hImg == 0) {
MessageBoxError("Image \"%s\" not found", ssImage);
return;
}
LayerAddObjects(hLayer, hImg);
ImageUpdate(hImg);
PageReplot(hPage);
History
Version | Beschreibung |
---|---|
R2018 | Unterstützt zusätzlich die Formate TIFF, EMF+, EMF+Dual. |
5.3.2 | Die Funktion kann mit den Parametern width und height aufgerufen werden. |
4.2.7 | Funktion kann auch mit einem Parameter hImgOther aufgerufen werden (Kopier-Konstruktor). |
Siehe auch
id-1488459