COMPONENT-Struktur (shlobj_core.h)

Wird von Windows 2000 verwendet, um Informationen zu einer Komponente zu enthalten. Diese Struktur ersetzt die IE4COMPONENT-Struktur .

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;

Member

dwSize

Art: DWORD

Die Größe der -Struktur.

dwID

Art: DWORD

Reserviert. Auf NULL festlegen.

iComponentType

Typ: int

Der Komponententyp. Es kann einen der folgenden Werte annehmen.

COMP_TYPE_HTMLDOC

HTML-Dokument

COMP_TYPE_PICTURE

Picture

COMP_TYPE_WEBSITE

Website

COMP_TYPE_CONTROL

ActiveX-Steuerelement. Dieser Wert ist nur für IActiveDesktop::AddDesktopItem gültig.

fChecked

Typ: BOOL

Ein Wert, der auf TRUE festgelegt ist, wenn die Komponente aktiviert ist, oder FALSE , wenn dies nicht der Fall ist.

fDirty

Typ: BOOL

Ein Wert, der auf TRUE festgelegt ist, wenn die Komponente geändert und noch nicht auf dem Datenträger gespeichert wurde. Sie wird auf FALSE festgelegt, wenn die Komponente nicht geändert wurde oder wenn sie geändert und auf dem Datenträger gespeichert wurde.

fNoScroll

Typ: BOOL

Ein Wert, der auf TRUE festgelegt ist, wenn die Komponente bildlauffähig ist, oder FALSE , wenn dies nicht der Fall ist.

cpPos

Typ: COMPPOS

Eine COMPPOS-Struktur , die Positions- und Größeninformationen enthält.

wszFriendlyName[MAX_PATH]

Typ: WCHAR[MAX_PATH]

Der Anzeigename der Komponente.

wszSource[INTERNET_MAX_URL_LENGTH]

Typ: WCHAR[INTERNET_MAX_URL_LENGTH]

Die URL der Komponente.

wszSubscribedURL[INTERNET_MAX_URL_LENGTH]

Typ: WCHAR[INTERNET_MAX_URL_LENGTH]

Die abonnierte URL.

dwCurItemState

Art: DWORD

Der aktuelle Zustand der Komponente. Es kann einen der folgenden Werte annehmen.

IS_NORMAL

Normaler Bildschirm

IS_FULLSCREEN

Vollbildmodus

IS_SPLIT

Geteilter Bildschirm

csiOriginal

Typ: COMPSTATEINFO

Eine COMPSTATEINFO-Struktur mit dem Status der Komponente, als sie zum ersten Mal hinzugefügt wurde.

csiRestored

Typ: COMPSTATEINFO

Eine COMPSTATEINFO-Struktur mit dem wiederhergestellten Zustand der Komponente.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	shlobj_core.h (shlobj.h einschließen)