SetBitmapDimensionEx-Funktion (wingdi.h)

Artikel
08/27/2023

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