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 mm 単位)。

[in] h

ビットマップの高さ (0.1 mm 単位)。

[out] lpsz

ビットマップの前のディメンションを受け取る SIZE 構造体へのポインター。このポインターには NULL を指定できます。

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

アプリケーションは、 GetBitmapDimensionEx 関数を呼び出すことによって、SetBitmapDimensionEx 関数を使用してビットマップに割り当てられたディメンションを取得できます。

hBitmap で識別されるビットマップは、CreateDIBSection 関数によって作成されたビットマップである DIB セクションにすることはできません。ビットマップが DIB セクションの場合、 SetBitmapDimensionEx 関数は失敗します。


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll