SetBkMode

Declare Function Api_SetBkMode& Lib "gdi32" Alias "SetBkMode" (ByVal hDC&, ByVal iBkMode&)

Declare Function SetBkMode Lib "gdi32" Alias "SetBkMode" (ByVal hdc As Long, ByVal nBkMode As Long) As Long

指定されたデバイスコンテキストの背景モードを設定する。背景モードは、テキスト、ハッチブラシ、（点線や鎖線など）実線ではないペンで使われる。

パラメータ
hdc
    背景モードを設定したいデバイスコンテキストのハンドルを指定する。
iBkMode
    背景モードを指定する。次の値のいずれかを指定する。

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

解説
    背景モードは、CreatePen 関数で作成したペンを使って描いた線のスタイルに影響を及ぼす。

    しかし、ExtCreatePen 関数で作成したペンを使って描いた線には影響を及ぼさない。
    iBkMode パラメータに、ドライバ特有の値を指定することもできる。

    GDI は、このような値をデバイスドライバに渡するが、それ以外の場合は GDI はそれらの値を無視する。