LVBKIMAGEA 構造体 (commctrl.h)
リスト ビュー コントロールの背景イメージに関する情報を格納します。 この構造体は、背景イメージ情報の設定と取得の両方に使用されます。
構文
typedef struct tagLVBKIMAGEA {
ULONG ulFlags;
HBITMAP hbm;
LPSTR pszImage;
UINT cchImageMax;
int xOffsetPercent;
int yOffsetPercent;
} LVBKIMAGEA, *LPLVBKIMAGEA;
メンバーズ
ulFlags
型: ULONG
このメンバーには、次のフラグの 1 つ以上を指定できます。 LVBKIF_SOURCE_MASK値を使用して、ソース フラグ以外のすべてをマスクできます。 LVBKIF_STYLE_MASK値を使用して、スタイル フラグ以外のすべてをマスクできます。
| 価値 | 意味 |
|---|---|
|
リスト ビュー コントロールには背景イメージがありません。 |
|
背景ビットマップは、LVBKIMAGEの |
|
pszImage メンバーには、背景画像の URL が含まれています。 |
|
背景画像は通常どおりに表示されます。 |
|
背景イメージは、コントロールの背景全体を塗りつぶすためにタイル化されます。 |
|
最初のタイルの座標を指定します。 このフラグは、LVBKIF_STYLE_TILE フラグも指定されている場合にのみ有効です。 このフラグを指定しない場合、最初のタイルはクライアント領域の左上隅から始まります。 ComCtl32.dll |
|
透かし背景ビットマップは、LVBKIMAGEの |
|
LVBKIF_TYPE_WATERMARKも指定されている場合にのみ有効です。 このフラグは、LVBKIF_TYPE_WATERMARKを介して提供されるビットマップに有効なアルファ チャネルが含まれていることを示します。 |
hbm
型: HBITMAP
背景ビットマップのハンドル。 このメンバーは、ulFlagsで
pszImage
型: LPTSTR
背景画像の URL を含む NULL で終わる文字列のアドレス。 このメンバーは、ulFlagsで
cchImageMax
型: UINT
pszImage内のアドレスにあるバッファーのサイズ
xOffsetPercent
型: int
イメージを水平方向にオフセットする必要があるコントロールのクライアント領域の割合。 たとえば、0% の場合、イメージはコントロールのクライアント領域の左端に対して表示されます。 50% の場合、イメージはコントロールのクライアント領域の中央に水平方向に表示されます。 100% の場合、イメージはコントロールのクライアント領域の右端に対して表示されます。 このメンバーは、ulFlagsで
yOffsetPercent
型: int
イメージを垂直方向にオフセットする必要があるコントロールのクライアント領域の割合。 たとえば、0% の場合、イメージはコントロールのクライアント領域の上端に対して表示されます。 50% の場合、イメージはコントロールのクライアント領域の中央に垂直方向に表示されます。 100% では、コントロールのクライアント領域の下端に対して画像が表示されます。 このメンバーは、ulFlagsで
備考
この構造体は、LVM_GETBKIMAGE および LVM_SETBKIMAGE メッセージと共に使用されます。
手記
commctrl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして LVBKIMAGE を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ヘッダー | commctrl.h |