Partager via

Structure COMPONENT (shlobj_core.h)

  • Article

Utilisé par Windows 2000 pour stocker des informations sur un composant. Cette structure remplace la structure IE4COMPONENT .

Syntaxe

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;

Membres

dwSize

Type : DWORD

Taille de la structure.

dwID

Type : DWORD

Réservé. Définit la valeur zéro.

iComponentType

Type : int

Type de composant. Il peut prendre l’une des valeurs suivantes.

COMP_TYPE_HTMLDOC

Document HTML

COMP_TYPE_PICTURE

Image

COMP_TYPE_WEBSITE

Site web

COMP_TYPE_CONTROL

Contrôle ActiveX. Cette valeur est valide uniquement pour IActiveDesktop ::AddDesktopItem.

fChecked

Type : BOOL

Valeur définie sur TRUE si le composant est activé, ou FALSE si ce n’est pas le cas.

fDirty

Type : BOOL

Valeur définie sur TRUE si le composant a été modifié et n’a pas encore été enregistré sur le disque. Elle est définie sur FALSE si le composant n’a pas été modifié, ou s’il a été modifié et enregistré sur le disque.

fNoScroll

Type : BOOL

Valeur définie sur TRUE si le composant peut faire défiler ou FALSE si ce n’est pas le cas.

cpPos

Type : COMPPOS

Structure COMPPOS contenant des informations de position et de taille.

wszFriendlyName[MAX_PATH]

Type : WCHAR[MAX_PATH]

Nom convivial du composant.

wszSource[INTERNET_MAX_URL_LENGTH]

Type : WCHAR[INTERNET_MAX_URL_LENGTH]

URL du composant.

wszSubscribedURL[INTERNET_MAX_URL_LENGTH]

Type : WCHAR[INTERNET_MAX_URL_LENGTH]

URL abonnée.

dwCurItemState

Type : DWORD

État actuel du composant. Il peut prendre l’une des valeurs suivantes.

IS_NORMAL

Écran normal

IS_FULLSCREEN

Plein écran

IS_SPLIT

Écran fractionné

csiOriginal

Type : COMPSTATEINFO

Structure COMPSTATEINFO avec l’état du composant lors de sa première ajout.

csiRestored

Type : COMPSTATEINFO

Structure COMPSTATEINFO avec l’état restauré du composant.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête shlobj_core.h (inclure Shlobj.h)