COMPONENT structure (shlobj_core.h)

Used by Windows 2000 to hold information about a component. This structure replaces the IE4COMPONENT structure.

Syntax

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;

Members

dwSize

Type: DWORD

The size of the structure.

dwID

Type: DWORD

Reserved. Set to zero.

iComponentType

Type: int

The component type. It can take one of the following values.

COMP_TYPE_HTMLDOC

HTML document

COMP_TYPE_PICTURE

Picture

COMP_TYPE_WEBSITE

Website

COMP_TYPE_CONTROL

ActiveX control. This value is valid only for IActiveDesktop::AddDesktopItem.

fChecked

Type: BOOL

A value that is set to TRUE if the component is enabled, or FALSE if it's not.

fDirty

Type: BOOL

A value that is set to TRUE if the component has been modified and not yet saved to disk. It will be set to FALSE if the component has not been modified, or if it has been modified and saved to disk.

fNoScroll

Type: BOOL

A value that is set to TRUE if the component is scrollable, or FALSE if not.

cpPos

Type: COMPPOS

A COMPPOS structure containing position and size information.

wszFriendlyName[MAX_PATH]

Type: WCHAR[MAX_PATH]

The component's friendly name.

wszSource[INTERNET_MAX_URL_LENGTH]

Type: WCHAR[INTERNET_MAX_URL_LENGTH]

The component's URL.

wszSubscribedURL[INTERNET_MAX_URL_LENGTH]

Type: WCHAR[INTERNET_MAX_URL_LENGTH]

The subscribed URL.

dwCurItemState

Type: DWORD

The current state of the component. It can take one of the following values.

IS_NORMAL

Normal screen

IS_FULLSCREEN

Full screen

IS_SPLIT

Split screen

csiOriginal

Type: COMPSTATEINFO

A COMPSTATEINFO structure with the state of the component when it was first added.

csiRestored

Type: COMPSTATEINFO

A COMPSTATEINFO structure with the restored state of the component.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	shlobj_core.h (include Shlobj.h)