共用方式為

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 或更新版本中。 此外，您必須在指令清單中指定 Comctl32.dll 第 6 版。 如需指令清單的詳細資訊，請參閱 啟用可視化樣式。
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 標頭會根據 UNICODE 預處理器常數的定義，將 LVBKIMAGE 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

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