SetBitmapDimensionEx 函式 (wingdi.h)

SetBitmapDimensionEx函式會將慣用維度指派給點陣圖。 應用程式可以使用這些維度;不過,系統不會使用它們。

語法

BOOL SetBitmapDimensionEx(
  [in]  HBITMAP hbm,
  [in]  int     w,
  [in]  int     h,
  [out] LPSIZE  lpsz
);

參數

[in] hbm

點陣圖的控制碼。 點陣圖不能是 DIB 區段點陣圖。

[in] w

點陣圖的寬度,以 0.1 公釐為單位。

[in] h

點陣圖的高度,以 0.1 公釐為單位。

[out] lpsz

要接收點陣圖先前維度 之 SIZE 結構的指標。 此指標可以是 Null

傳回值

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。

備註

應用程式可以藉由呼叫GetBitmapDimensionEx式來擷取指派給點陣圖的維度。

hBitmap所識別的點陣圖不能是 DIB 區段,這是CreateDIBSection函式所建立的點陣圖。 如果點陣圖是 DIB 區段, SetBitmapDimensionEx 函式會失敗。

規格需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 wingdi.h (包含 Windows.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

點陣圖函式

點陣圖概觀

CreateDIBSection

GetBitmapDimensionEx

SIZE