IMAGELISTDRAWPARAMS 構造体 (commctrl.h)

イメージ リストの描画操作に関する情報が含まれており、 IImageList::D raw 関数で使用されます。

構文

typedef struct _IMAGELISTDRAWPARAMS {
  DWORD      cbSize;
  HIMAGELIST himl;
  int        i;
  HDC        hdcDst;
  int        x;
  int        y;
  int        cx;
  int        cy;
  int        xBitmap;
  int        yBitmap;
  COLORREF   rgbBk;
  COLORREF   rgbFg;
  UINT       fStyle;
  DWORD      dwRop;
  DWORD      fState;
  DWORD      Frame;
  COLORREF   crEffect;
} IMAGELISTDRAWPARAMS, *LPIMAGELISTDRAWPARAMS;

メンバー

cbSize

種類: DWORD

この構造体のサイズ (バイト単位)。

himl

種類: HIMAGELIST

描画するイメージを含むイメージ リストへのハンドル。

i

型: int

描画するイメージの 0 から始まるインデックス。

hdcDst

種類: HDC

ターゲット デバイス コンテキストのハンドル。

x

型: int

イメージを描画する場所を指定する x 座標。

y

型: int

イメージを描画する場所を指定する y 座標。

cx

型: int

xBitmap と yBitmap で指定された描画操作の左上隅を基準にして、描画するピクセル数を指定する値。 cx と cy が 0 の場合、Draw は有効なセクション全体を描画します。 メソッドは、パラメーターが有効であることを保証しません。

cy

型: int

xBitmap と yBitmap で指定された描画操作の左上隅を基準にして、描画するピクセル数を指定する値。 cx と cy が 0 の場合、Draw は有効なセクション全体を描画します。 メソッドは、パラメーターが有効であることを保証しません。

xBitmap

型: int

イメージ自体を参照する描画操作の左上隅を指定する x 座標。 xBitmap 以降の yBitmap の左側にある画像のピクセルは表示されません。

yBitmap

型: int

画像自体を参照する描画操作の左上隅を指定する y 座標。 xBitmap 以降の yBitmap の左側にある画像のピクセルは表示されません。

rgbBk

種類: COLORREF

イメージの背景色。 このパラメーターには、アプリケーション定義の RGB 値または次のいずれかの値を指定できます。

rgbFg

種類: COLORREF

画像の前景色。 このメンバーは、 fStyle に ILD_BLEND25 または ILD_BLEND50 フラグ が 含まれている場合にのみ使用されます。 このパラメーターには、アプリケーション定義の RGB 値または次のいずれかの値を指定できます。

fStyle

型: UINT

描画スタイルと、必要に応じてオーバーレイ イメージを指定するフラグ。 オーバーレイ イメージの詳細については、このトピックの最後にあるコメント セクションを参照してください。 このメンバーには、1 つ以上の イメージ リスト描画フラグを含めることができます。

dwRop

種類: DWORD

ラスター演算コードを指定する値。 これらのコードは、ソース四角形の色データを、最終的な色を実現するために変換先の四角形の色データと組み合わせる方法を定義します。 fStyle に ILD_ROP フラグが含まれていない場合、このメンバーは無視されます。 一般的なラスター演算コードには、次のようなものがあります。

fState

型: DWORD

描画状態を指定するフラグ。 このメンバーには、1 つ以上の イメージ リスト状態フラグを含めることができます。 このメンバーを使用するにはcomctl32.dllバージョン 6 を使用する必要があります。 解説を参照してください。

Frame

型: DWORD

アルファ ブレンド効果と共に使用されます。

ILS_ALPHAと共に使用すると、このメンバーはアルファ チャネルの値を保持します。 この値には 0 から 255 の値を指定できます。0 は完全に透明で、255 は完全に不透明です。

このメンバーを使用するにはcomctl32.dllバージョン 6 を使用する必要があります。 解説を参照してください。

crEffect

型: DWORD

光彩と影の効果に使用される色。 このメンバーを使用するにはcomctl32.dllバージョン 6 を使用する必要があります。 解説を参照してください。

解説

オーバーレイ イメージは、この構造体の i メンバーで指定されたプライマリ イメージの上に描画されるイメージです。 オーバーレイ イメージを指定するには、ビットごとの OR 演算子を使用して fStyle と INDEXTOOVERLAYMASK マクロを組み合わせ、マクロ内のオーバーレイ イメージの 1 から始まるインデックスを渡します。 このイメージは、 ImageList_SetOverlayImage API を使用してオーバーレイ イメージとして以前に指定されている必要があります。

fStyle からオーバーレイ イメージを抽出するには、ビットごとの AND 演算子を使用して fStyle をILD_OVERLAYMASK値でマスクします。

バージョン 6 Comctl32.dll再頒布可能ではありません。. バージョン 6 Comctl32.dll使用するには、マニフェストで指定する必要があります。 マニフェストの詳細については、「 ビジュアル スタイルの有効化」を参照してください。

要件