Directory Contents Search << >>
CreateCompatibleDIB erzeugt eine leere (schwarze) DIB mit der angegebenen Größe. Farbtiefe und Farbpalette werden der Referenz-DIB entnommen. Es wird eine globales Speicherhandle erstellt, das einen BITMAPINFOHEADER und eine Standard-Palette enthält, die Bitmap-Daten der DIB werden nicht initialisiert.
HDIB API CreateCompatibleDIB(HDIB hdib, UINT Width, UINT Height);
|
hdib |
HDIB |
Handle einer Referenz-DIB, die Farbtiefe und Farbpalette der neuen DIB vorgibt. |
|
Width |
UINT |
Breite der neuen DIB in Pixeln |
|
Height |
UINT |
Höhe der neuen DIB in Pixeln |
Rückgabewert: |
||
|
Der Rückgabewert gibt das Handle der DIB an. Das Handle muss von der Applikation mit der Funktion GlobalFree wieder freigegeben werden. |
||
Anmerkungen |
||
|
Aus Performancegründen werden die einzelnen Pixel der DIB nicht initialisiert und können jeden beliebigen Wert annehmen. Bei einer frisch gestarteten Anwendung wird Windows neu initialisierten Speicher mit Nullwerten zurückliefern, das ist aber nach einiger Ausführungszeit nicht mehr der Fall. Die Anwendung sollte den Inhalt der DIB immer auf irgendwelche sinnvollen Werte setzen. |
||
Siehe auch |
||
|
→ CreateDIBID_CREATEDIB |
Leonardo: Funktion CreateCompatibleDIB