IDeskBand::GetBandInfo 方法 (shobjidl_core.h)
获取带对象的状态信息。
重要 应在新开发中使用 缩略图工具栏 来代替桌面带,因为从 Windows 7 开始不支持这些带。
语法
HRESULT GetBandInfo(
DWORD dwBandID,
DWORD dwViewMode,
DESKBANDINFO *pdbi
);
参数
dwBandID
类型:DWORD
由容器分配的带的标识符。 如果需要,band 对象可以保留此值。
dwViewMode
类型:DWORD
带对象的视图模式。 以下值之一:
DBIF_VIEWMODE_NORMAL
带对象正在水平带中显示。
DBIF_VIEWMODE_VERTICAL
带对象正在垂直带中显示。
DBIF_VIEWMODE_FLOATING
波段对象显示在浮动带中。
DBIF_VIEWMODE_TRANSPARENT
带对象显示在透明带中。
pdbi
类型: DESKBANDINFO*
指向接收对象的带信息的 DESKBANDINFO 结构的指针。 此结构的 dwMask 成员指示正在请求的特定信息。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版、Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shlobj.h) |
DLL | Shell32.dll (版本 4.71 或更高版本) |