<Return[S]><Top>

SetDIBits

Declare Function Api_SetDIBits& Lib "gdi32" Alias "SetDIBits" (ByVal hDC&, ByVal hBitmap&, ByVal nStartScan&, ByVal nNumScans&, lpBits As Any, lpBI As BITMAPINFO, ByVal wUsage&)

Declare Function SetDIBits Lib "gdi32" (ByVal hDC As Long, ByVal hBitmap As Long, ByVal nStartScan As Long, ByVal nNumScans As Long, lpBits As Any, lpBI As BITMAPINFO, ByVal wUsage As Long) As Long

指定されたデバイス独立ビットマップ(DIB)の色データを使って、ビットマップにピクセルを変更する。

パラメータ
hdc
    デバイスコンテキストのハンドルを指定する。
hbmp
    ビットマップのハンドルを指定する。ここで指定したビットマップのピクセルが変更される。
uStartScan
    lpvBits パラメータが指す配列が保持している、デバイス独立の色データの最初の走査行を指定する。
cScanLines
    デバイス独立の色データを保持している配列の中にある、走査行の数を指定する。
lpvBits
    DIB の色データを保持しているバイト配列へのポインタを指定する。

    ビットマップ値の形式は、lpbmi パラメータが指す BITMAPINFO 構造体の biBitCount メンバに依存する。
lpbmi
    DIB の情報を保持している 1 個の BITMAPINFO 構造体へのポインタを指定する。
fuColorUse
    BITMAPINFO 構造体の bmiColors メンバを設定したかどうかを指定する。

    設定した場合は、bmiColors メンバは RGB 値かパレットインデックスのどちらかである。次の値のいずれかを指定する。

    値                                 

意味                                                   

    DIB_PAL_COLORS

 

カラーテーブルは、hdc パラメータが指すデバイスコンテキストの論理パレットに関連する 16 ビットのインデックス

番号からなる配列である。

    DIB_RGB_COLORS

カラーテーブルは、RGB 値そのものである。


戻り値
    関数が成功すると、コピーされた走査行の数が返る。
    関数が失敗すると、0 が返る。
    Windows NT/2000:拡張エラー情報を取得するには、GetLastError 関数を使う。