SetBitmapDimensionEx

Declare Function Api_SetBitmapDimensionEx& Lib "gdi32" Alias "SetBitmapDimensionEx" (ByVal hBitmap&, ByVal nWidth&, ByVal nHeight&, lpSize As SIZE)

Declare Function SetBitmapDimensionEx Lib "gdi32" Alias "SetBitmapDimensionEx" (ByVal hBitmap As Long, ByVal nWidth As Long, ByVal nHeight As Long, lpSize As SIZE) As Long

ビットマップのサイズを設定する。アプリケーションはこのサイズを利用できるが、Windows システムはこのサイズを利用しない。

パラメータ
hBitmap
    ビットマップのハンドルを指定する。DIB セクションのビットマップは指定できない。
nWidth
    ビットマップの幅を 0.1mm 単位で指定する。
nHeight
    ビットマップの高さを 0.1mm 単位で指定する。
lpSize
    1 個の 構造体へのポインタを指定する。関数から制御が返ると、この構造体に、設定前のサイズが格納される。この情報が不要なとき

    は、NULL を指定する。

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。
    Windows NT/2000：拡張エラー情報を取得するには、 関数を使う。

解説
    アプリケーションは GetBitmapDimensionEx 関数を呼び出すと、SetBitmapDimensionEx 関数で設定したサイズを取得できる。
    hBitmap に、DIB セクションのビットマップ、つまり CreateDIBSection 関数で作成したビットマップのハンドルを指定することはできない。

    DIB セクションのビットマップを指定すると、SetBitmapDimensionEx 関数は失敗する。