DrawIconEx

指定されたアイコンまたはマウスカーソルを指定されたデバイスに描画します。

BOOL DrawIconEx(
    HDC    hDC,         // デバイスコンテキスト
    int    x,           // x座標
    int    y,           // y座標
    HICON  hIcon,       // アイコンまたはマウスカーソル
    int    width,       // 幅
    int    height,      // 高さ
    UINT   iStepAniCur, // フレームインデックス
    HBRUSH hbrFlicker,  // ブラシ
    UINT   uFlags       // フラグ
);

USER32.DLL

引数

hDC

描画先のデバイスコンテキストのハンドルを指定します。

x, y

アイコンまたはマウスカーソルの左上端の座標を論理単位で指定します。

hIcon

描画するアイコンまたはマウスカーソルのハンドルを指定します。アニメーションカーソルのハンドルを指定することもできます。

width, height

アイコンまたはマウスカーソルの実際の描画サイズを指定します。

このパラメータに 0 を指定し、かつ、uFlags パラメータに DI_DEFAULTSIZE を指定した場合はデフォルトの幅や高さが使用されます。このパラメータに 0 を指定し、かつ、uFlags パラメータに DI_DEFAULTSIZE を指定しなかった場合は実際のリソースの幅や高さが使用されます。

iStepAniCur

hIcon パラメータにアニメーションカーソルのハンドルを指定した場合に、描画するフレームのインデックスを指定します。hIcon パラメータがアニメーションカーソルを指定していない場合は、このパラメータは無視されます。

hbrFlicker

ブラシのハンドルを指定します。アイコンを描画する際に、指定されたブラシを使ってオフスクリーンビットマップを作成し、アイコンまたはマウスカーソルをそのビットマップに描き、hDC パラメータで指定されたデバイスコンテキストにそのビットマップをコピーします。

0 (NULL) を指定した場合は、アイコンまたはマウスカーソルをデバイスコンテキストに直接描画します。

uFlags

描画フラグを指定します。以下の値のいずれかを指定します。

意味
0x0001 (DI_MASK) マスクを使ってアイコン (またはマウスカーソル) を描画します。
0x0002 (DI_IMAGE) イメージを使ってアイコン (またはマウスカーソル) を描画します。
0x0003 (DI_NORMAL) DI_IMAGE と DI_MASK の組み合わせです。
0x0004 (DI_COMPAT) ユーザーが指定したイメージではなく、システムデフォルトのイメージを使って、アイコン (またはマウスカーソル) を描画します。
0x0008 (DI_DEFAULTSIZE) width パラメータと height パラメータに 0 が指定されている場合、アイコンまたはマウスカーソルをデフォルトのサイズで描画します。

戻り値

成功した場合は 0 以外の値が返ります。

失敗した場合は 0 が返ります。拡張エラー情報を取得するには、 GetLastError 関数を使います。

対応情報

Windows 95 以降 / Windows NT 3.5 以降