COMPONENT 结构 (shlobj_core.h)

由 Windows 2000 用来保存有关组件的信息。 此结构替换 IE4COMPONENT 结构。

语法

typedef struct _tagCOMPONENT {
  DWORD         dwSize;
  DWORD         dwID;
  int           iComponentType;
  BOOL          fChecked;
  BOOL          fDirty;
  BOOL          fNoScroll;
  COMPPOS       cpPos;
  WCHAR         wszFriendlyName[MAX_PATH];
  WCHAR         wszSource[INTERNET_MAX_URL_LENGTH];
  WCHAR         wszSubscribedURL[INTERNET_MAX_URL_LENGTH];
  DWORD         dwCurItemState;
  COMPSTATEINFO csiOriginal;
  COMPSTATEINFO csiRestored;
} COMPONENT;

成员

dwSize

类型：DWORD

结构的大小。

dwID

类型：DWORD

保留。 设置为零。

iComponentType

类型： int

组件类型。 它可以采用以下值之一。

COMP_TYPE_HTMLDOC

HTML 文档

COMP_TYPE_PICTURE

图片

COMP_TYPE_WEBSITE

网站

COMP_TYPE_CONTROL

ActiveX 控件。 此值仅对 IActiveDesktop：：AddDesktopItem 有效。

fChecked

类型： BOOL

一个值，如果组件已启用，则设置为 TRUE ;如果未启用，则设置为 FALSE 。

fDirty

类型： BOOL

如果组件已修改但尚未保存到磁盘，则该值设置为 TRUE 。 如果组件尚未修改，或者已修改并保存到磁盘，则它将设置为 FALSE 。

fNoScroll

类型： BOOL

一个值，如果组件可滚动，则设置为 TRUE ;如果不可滚动，则设置为 FALSE 。

cpPos

类型： COMPPOS

包含位置和大小信息的 COMPPOS 结构。

wszFriendlyName[MAX_PATH]

类型： WCHAR[MAX_PATH]

组件的友好名称。

wszSource[INTERNET_MAX_URL_LENGTH]

类型： WCHAR[INTERNET_MAX_URL_LENGTH]

组件的 URL。

wszSubscribedURL[INTERNET_MAX_URL_LENGTH]

类型： WCHAR[INTERNET_MAX_URL_LENGTH]

订阅的 URL。

dwCurItemState

类型：DWORD

组件的当前状态。 它可以采用以下值之一。

IS_NORMAL

普通屏幕

IS_FULLSCREEN

全屏

IS_SPLIT

拆分屏幕

csiOriginal

类型： COMPSTATEINFO

具有组件首次添加时的状态的 COMPSTATEINFO 结构。

csiRestored

类型： COMPSTATEINFO

具有组件的还原状态的 COMPSTATEINFO 结构。

要求

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