LVBKIMAGEA 結構 (commctrl.h)

  • 發行項

包含清單檢視控件的背景影像相關信息。 此結構用於設定和擷取背景影像資訊。

語法

typedef struct tagLVBKIMAGEA {
  ULONG   ulFlags;
  HBITMAP hbm;
  LPSTR   pszImage;
  UINT    cchImageMax;
  int     xOffsetPercent;
  int     yOffsetPercent;
} LVBKIMAGEA, *LPLVBKIMAGEA;

成員

ulFlags

類型： ULONG

此成員可能是下列一或多個旗標。 您可以使用 LVBKIF_SOURCE_MASK 值來遮罩所有來源旗標。 您可以使用LVBKIF_STYLE_MASK值來遮罩所有樣式旗標。

值 意義
LVBKIF_SOURCE_NONE
 清單檢視控件沒有背景影像。
LVBKIF_SOURCE_HBITMAP
 背景點陣圖是透過 LVBKIMAGE的 hbm 成員提供。 如果訊息 LVM_SETBKIMAGE 成功，則清單檢視會取得位圖的擁有權。
LVBKIF_SOURCE_URL
 pszImage成員包含背景影像的URL。
LVBKIF_STYLE_NORMAL
 背景影像通常會顯示。
LVBKIF_STYLE_TILE
 背景影像將會並排顯示，以填滿控件的整個背景。
LVBKIF_FLAG_TILEOFFSET
 指定第一個圖格的座標。 只有在同時指定 LVBKIF_STYLE_TILE 旗標時，此旗標才有效。 如果未指定此旗標，第一個磚會從工作區的左上角開始。 如果您使用 ComCtl32.dll 6.0 版 xOffsetPercent 和 yOffsetPercent 字段包含圖元，而非百分比值，以指定第一個磚的座標。 Comctl32.dll 第 6 版無法轉散發，但包含在 Windows 或更新版本中。 此外，您必須在指令清單中指定第 6 版 Comctl32.dll。 如需指令清單的詳細資訊，請參閱 啟用可視化樣式。
LVBKIF_TYPE_WATERMARK
 浮浮水印背景點陣圖是透過 LVBKIMAGE 的 hbm 成員提供。 如果 LVM_SETBKIMAGE 訊息成功，則清單檢視控件會取得位圖的擁有權。
LVBKIF_FLAG_ALPHABLEND
 只有在同時指定LVBKIF_TYPE_WATERMARK時才有效。 此旗標表示透過 LVBKIF_TYPE_WATERMARK 提供的位圖包含有效的 Alpha 色板。

hbm

類型： HBITMAP

背景點陣圖的句柄。 只有在ulFlags中設定LVBKIF_SOURCE_HBITMAP旗標時，此成員才有效。

pszImage

類型： LPTSTR

包含背景影像 URL 的 NULL 終止字串位址。 只有在ulFlags中設定LVBKIF_SOURCE_URL旗標時，此成員才有效。 這個成員必須初始化，才能指向包含或接收文字的緩衝區，再傳送訊息。

cchImageMax

類型： UINT

pszImage 中地址的緩衝區大小。 如果要將資訊傳送至控件，則會忽略這個成員。

xOffsetPercent

類型： int

影像應該水準位移之控件工作區的百分比。 例如，在 0% 時，影像會顯示在控件工作區的左邊緣。 在 50% 時，影像會在控件的工作區中水準置中顯示。 在 100% 時，影像會顯示在控件工作區的右邊緣。 只有在ulFlags中指定LVBKIF_STYLE_NORMAL時，此成員才有效。 如果在ulFlags中同時指定LVBKIF_FLAG_TILEOFFSET和LVBKIF_STYLE_TILE，則值會指定第一個磚的圖元，而不是百分比位移。 否則會忽略此值。

yOffsetPercent

類型： int

影像應該垂直位移的控制件工作區百分比。 例如，在 0% 時，影像會顯示在控件工作區的上邊緣。 在 50% 時，影像會顯示在控件的工作區中垂直置中。 在 100% 時，影像會顯示在控件工作區的下邊緣。 只有在ulFlags中指定LVBKIF_STYLE_NORMAL時，此成員才有效。 如果在ulFlags中同時指定LVBKIF_FLAG_TILEOFFSET和LVBKIF_STYLE_TILE，則值會指定第一個磚的圖元，而不是百分比位移。 否則會忽略此值。

備註

此結構會與 LVM_GETBKIMAGE 和 LVM_SETBKIMAGE 訊息搭配使用。

注意

commctrl.h 標頭會將 LVBKIMAGE 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 commctrl.h