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 及更高版本： 无法从带区容器中删除 band 对象。

DBIMF_DEBOSSED

带对象以凹陷的外观显示。

DBIMF_BKCOLOR

带以 crBkgnd 中指定的背景色显示。

DBIMF_USECHEVRON

Windows XP 及更高版本： 如果全带对象无法显示 (即，带区对象小于 ptActual，则显示 V 形图标以指示有更多可用选项。 这些选项在单击 V 形时显示。

DBIMF_BREAK

Windows XP 及更高版本： band 对象显示在 band 容器中的新行中。

DBIMF_ADDTOFRONT

Windows XP 及更高版本： band 对象是 band 容器中的第一个对象。

DBIMF_TOPALIGN

Windows XP 及更高版本： band 对象显示在乐队容器的首行中。

DBIMF_NOGRIPPER

Windows Vista 及更高版本： 不会显示大小调整手柄以允许用户移动带对象或调整其大小。

DBIMF_ALWAYSGRIPPER

Windows Vista 及更高版本： 始终显示允许用户移动带区对象或调整其大小的大小手柄，即使该带对象是容器中唯一的对象也是如此。

DBIMF_NOMARGINS

Windows Vista 及更高版本： 带区对象不应显示边距。

crBkgnd

类型： COLORREF

接收带的背景色的 COLORREF 结构。 dwModeFlags 成员必须包含 DBIMF_BKCOLOR 标志;否则，将忽略 crBkgnd。

要求

要求	值
最低受支持的客户端	Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	shobjidl_core.h (包括 Shobjidl.h)