DESKBANDINFO 結構 (shobjidl_core.h)

接收訊號範圍對象的相關信息。 此結構會與已被取代的 IDeskBand：：GetBandInfo 方法搭配使用。

語法

typedef struct DESKBANDINFO {
  DWORD    dwMask;
  POINTL   ptMinSize;
  POINTL   ptMaxSize;
  POINTL   ptIntegral;
  POINTL   ptActual;
  WCHAR    wszTitle[256];
  DWORD    dwModeFlags;
  COLORREF crBkgnd;
} DESKBANDINFO;

成員

dwMask

類型： DWORD

一組旗標，決定呼叫端正在要求此結構的成員。 下列一或多個值：

DBIM_MINSIZE

要求 ptMinSize 。

DBIM_MAXSIZE

要求 ptMaxSize 。

DBIM_INTEGRAL

要求 ptIntegral 。

DBIM_ACTUAL

要求 ptActual 。

DBIM_TITLE

要求 wszTitle 。

DBIM_MODEFLAGS

要求 dwModeFlags 。

DBIM_BKCOLOR

要求crBkgnd。

ptMinSize

類型： POINTL

POINTL 結構，可接收帶狀物件的大小下限。 POINTL 結構的 x 成員會提供最小寬度，而最小高度則會在 y 成員中指定。

ptMaxSize

類型： POINTL

POINTL 結構，可接收帶狀物件的大小上限。 POINTL 結構的 y 成員中會提供最大高度，並忽略 x 成員。 如果帶狀物件的最大高度沒有限制，應該使用 LONG) -1 (。

ptIntegral

類型： POINTL

POINTL 結構，接收重設大小步驟值 (遞增) 重設大小範圍物件。 垂直步驟值會在 POINTL 結構的 y 成員中指定，並忽略 x 成員。

dwModeFlags 成員必須包含DBIMF_VARIABLEHEIGHT旗標;否則會忽略 ptIntegral。

ptActual

類型： POINTL

POINTL 結構，可接收帶狀物件的理想大小。 在 POINTL 結構的 x 成員中會指定理想的寬度，而理想的高度則會在 y 成員中指定。 帶狀容器會嘗試使用這些值，但不保證帶狀範圍是這個大小。

wszTitle[256]

類型： WCHAR[256]

接收帶標題的 WCHAR 緩衝區。

dwModeFlags

類型： DWORD

值，接收一組旗標，這個旗標會指定帶狀對象的作業模式。 下列一或多個值：

DBIMF_NORMAL

訊號範圍使用預設屬性。 其他模式旗標會修改此旗標。

DBIMF_FIXED

Windows XP 和更新版本： 帶狀物件是固定大小和位置。 使用此旗標時，不會在帶狀對象上顯示重設大小底框。

DBIMF_FIXEDBMP

Windows XP 和更新版本： 帶狀物件會使用固定位圖 (.bmp) 檔案作為其背景。 請注意，在所有情況下都不支援背景，因此即使設定此旗標，也不會看到位圖。

DBIMF_VARIABLEHEIGHT

可以變更帶狀物件的高度。 ptIntegral 成員會定義可重設大小帶物件的步驟值。

DBIMF_UNDELETEABLE

Windows XP 和更新版本： 無法從訊號範圍容器中移除頻外物件。

DBIMF_DEBOSSED

帶狀物件會以下凹的外觀顯示。

DBIMF_BKCOLOR

帶形圖會以 crBkgnd中指定的背景色彩顯示。

DBIMF_USECHEVRON

Windows XP 和更新版本： 如果無法顯示完整帶狀物件 (也就是說，帶狀物件小於 ptActual，則會顯示形箭號，表示有更多可用的選項。 按兩下>形箭號時會顯示這些選項。

DBIMF_BREAK

Windows XP 和更新版本： 帶狀物件會顯示在帶狀容器的新數據列中。

DBIMF_ADDTOFRONT

Windows XP 和更新版本： 帶狀對像是訊號範圍容器中的第一個物件。

DBIMF_TOPALIGN

Windows XP 和更新版本： 訊號範圍物件會顯示在帶狀容器的頂端數據列中。

DBIMF_NOGRIPPER

Windows Vista 和更新版本： 不會顯示任何重設大小底框，讓用戶移動或調整訊號範圍物件的大小。

DBIMF_ALWAYSGRIPPER

Windows Vista 和更新版本： 一律會顯示允許用戶移動或重設大小帶物件的重設大小底框，即使該帶物件是容器中唯一的物件也一樣。

DBIMF_NOMARGINS

Windows Vista 和更新版本： 帶狀物件不應該顯示邊界。

crBkgnd

類型： COLORREF

接收帶背景色彩的 COLORREF 結構。 dwModeFlags 成員必須包含DBIMF_BKCOLOR旗標;否則會忽略crBkgnd。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	shobjidl_core.h (包含 Shobjidl.h)