SetBitmapDimensionEx-Funktion (wingdi.h)
Die SetBitmapDimensionEx-Funktion weist einer Bitmap bevorzugte Dimensionen zu. Diese Dimensionen können von Anwendungen verwendet werden; sie werden jedoch nicht vom System verwendet.
Syntax
BOOL SetBitmapDimensionEx(
[in] HBITMAP hbm,
[in] int w,
[in] int h,
[out] LPSIZE lpsz
);
Parameter
[in] hbm
Ein Handle für die Bitmap. Die Bitmap darf keine DIB-Abschnittsbitbitte sein.
[in] w
Die Breite der Bitmap in 0,1-Millimeter-Einheiten.
[in] h
Die Höhe der Bitmap in 0,1-Millimeter-Einheiten.
[out] lpsz
Ein Zeiger auf eine SIZE-Struktur , um die vorherigen Dimensionen der Bitmap zu empfangen. Dieser Zeiger kann NULL sein.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Eine Anwendung kann die Dimensionen abrufen, die einer Bitmap mit der SetBitmapDimensionEx-Funktion zugewiesen sind, indem sie die GetBitmapDimensionEx-Funktion aufruft .
Die durch hBitmap identifizierte Bitmap kann kein DIB-Abschnitt sein, bei dem es sich um eine Bitmap handelt, die von der CreateDIBSection-Funktion erstellt wird. Wenn es sich bei der Bitmap um einen DIB-Abschnitt handelt, schlägt die SetBitmapDimensionEx-Funktion fehl.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |