Compartilhar via

Estrutura COMPONENT (shlobj_core.h)

  • Artigo

Usado pelo Windows 2000 para armazenar informações sobre um componente. Essa estrutura substitui a estrutura IE4COMPONENT .

Sintaxe

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;

Membros

dwSize

Tipo: DWORD

O tamanho da estrutura.

dwID

Tipo: DWORD

Reservado. Defina como zero.

iComponentType

Tipo: int

O tipo de componente. Ele pode ter um dos valores a seguir.

COMP_TYPE_HTMLDOC

Documento HTML

COMP_TYPE_PICTURE

Picture

COMP_TYPE_WEBSITE

Site da Web

COMP_TYPE_CONTROL

Controle ActiveX. Esse valor é válido apenas para IActiveDesktop::AddDesktopItem.

fChecked

Tipo: BOOL

Um valor definido como TRUE se o componente estiver habilitado ou FALSE se não estiver.

fDirty

Tipo: BOOL

Um valor definido como TRUE se o componente tiver sido modificado e ainda não tiver sido salvo no disco. Ele será definido como FALSE se o componente não tiver sido modificado ou se tiver sido modificado e salvo no disco.

fNoScroll

Tipo: BOOL

Um valor definido como TRUE se o componente for rolável ou FALSE , caso contrário.

cpPos

Tipo: COMPPOS

Uma estrutura COMPPOS que contém informações de posição e tamanho.

wszFriendlyName[MAX_PATH]

Tipo: WCHAR[MAX_PATH]

O nome amigável do componente.

wszSource[INTERNET_MAX_URL_LENGTH]

Tipo: WCHAR[INTERNET_MAX_URL_LENGTH]

A URL do componente.

wszSubscribedURL[INTERNET_MAX_URL_LENGTH]

Tipo: WCHAR[INTERNET_MAX_URL_LENGTH]

A URL assinada.

dwCurItemState

Tipo: DWORD

O estado atual do componente. Ele pode ter um dos valores a seguir.

IS_NORMAL

Tela normal

IS_FULLSCREEN

Tela inteira

IS_SPLIT

Tela dividida

csiOriginal

Tipo: COMPSTATEINFO

Uma estrutura COMPSTATEINFO com o estado do componente quando ele foi adicionado pela primeira vez.

csiRestored

Tipo: COMPSTATEINFO

Uma estrutura COMPSTATEINFO com o estado restaurado do componente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho shlobj_core.h (inclua Shlobj.h)