Estrutura LITEM (commctrl.h)

  • Artigo

Usado para definir e recuperar informações sobre um item de link.

Sintaxe

typedef struct tagLITEM {
  UINT  mask;
  int   iLink;
  UINT  state;
  UINT  stateMask;
  WCHAR szID[MAX_LINKID_TEXT];
  WCHAR szUrl[L_MAX_URL_LENGTH];
} LITEM, *PLITEM;

Membros

mask

Tipo: UINT

Combinação de um ou mais dos seguintes sinalizadores, descrevendo as informações a serem definidas ou recuperadas:

Valor Significado
LIF_ITEMINDEX
 Recupere o índice de item numérico. Os itens são sempre acessados pelo índice, portanto, você sempre deve definir esse sinalizador e atribuir um valor a iLink. Para obter a ID do item, você deve definir LIF_ITEMINDEX e LIF_ITEMID.
LIF_STATE
 Use stateMask para obter ou definir o estado do link.
LIF_ITEMID
 Especifique o item pelo valor de ID fornecido em szID.
LIF_URL
 Defina ou obtenha a URL para este item.

iLink

Tipo: int

Valor do tipo int que contém o índice do item. Esse índice numérico é usado para acessar um link de controle SysLink.

state

Tipo: UINT

Combinação de um ou mais dos seguintes sinalizadores, descrevendo o estado do item:

Valor Significado
LIS_ENABLED
 O link pode responder à entrada do usuário. Esse é o padrão, a menos que todo o controle tenha sido criado com WS_DISABLED. Nesse caso, todos os links estão desabilitados.
LIS_FOCUSED
 O link tem o foco do teclado. Pressionar ENTER envia uma notificação de NM_CLICK.
LIS_VISITED
 O link foi visitado pelo usuário. Alterar a URL para uma que não foi visitada faz com que esse sinalizador seja limpo.
LIS_HOTTRACK
 Indica que o controle syslink será realçado em uma cor diferente (COLOR_HIGHLIGHT) quando o mouse passar o mouse sobre o controle.
LIS_DEFAULTCOLORS
 Habilite as cores de texto personalizadas a serem usadas.

stateMask

Tipo: UINT

Combinação de sinalizadores que descrevem qual item de estado obter ou definir. Os itens permitidos são idênticos aos permitidos no estado .

szID[MAX_LINKID_TEXT]

Tipo: WCHAR[MAX_LINKID_TEXT]

Cadeia de caracteres WCHAR que contém o nome da ID. O número máximo de caracteres na matriz é MAX_LINKID_TEXT. O nome da ID não pode ser usado para acessar um link de controle SysLink. Use o índice de item para acessar o item.

szUrl[L_MAX_URL_LENGTH]

Tipo: WCHAR[L_MAX_URL_LENGTH]

Cadeia de caracteres WCHAR que contém a URL representada pelo link. O número máximo de caracteres na matriz é L_MAX_URL_LENGTH.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho commctrl.h