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

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 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 shlobj_core.h (包含 Shlobj.h)