Estructura LITEM (commctrl.h)

  • Artículo

Se usa para establecer y recuperar información sobre un elemento de vínculo.

Sintaxis

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

Miembros

mask

Tipo: UINT

Combinación de una o varias de las marcas siguientes, que describen la información que se va a establecer o recuperar:

Valor Significado
LIF_ITEMINDEX
 Recupere el índice de elementos numéricos. Siempre se accede a los elementos por índice, por lo que siempre debe establecer esta marca y asignar un valor a iLink. Para obtener el identificador de elemento, debe establecer LIF_ITEMINDEX y LIF_ITEMID.
LIF_STATE
 Use stateMask para obtener o establecer el estado del vínculo.
LIF_ITEMID
 Especifique el elemento por el valor de identificador especificado en szID.
LIF_URL
 Establezca u obtenga la dirección URL de este elemento.

iLink

Tipo: int

Valor de tipo int que contiene el índice de elemento. Este índice numérico se usa para acceder a un vínculo de control SysLink.

state

Tipo: UINT

Combinación de una o varias de las marcas siguientes, que describen el estado del elemento:

Valor Significado
LIS_ENABLED
 El vínculo puede responder a la entrada del usuario. Este es el valor predeterminado a menos que se haya creado todo el control con WS_DISABLED. En este caso, todos los vínculos están deshabilitados.
LIS_FOCUSED
 El vínculo tiene el foco del teclado. Al presionar ENTRAR, se envía una notificación de NM_CLICK.
LIS_VISITED
 El usuario ha visitado el vínculo. Cambiar la dirección URL a una que no se ha visitado hace que esta marca se borre.
LIS_HOTTRACK
 Indica que el control syslink se resaltará en un color diferente (COLOR_HIGHLIGHT) cuando el mouse mantenga el puntero sobre el control.
LIS_DEFAULTCOLORS
 Habilite los colores de texto personalizados que se van a usar.

stateMask

Tipo: UINT

Combinación de marcas que describen qué elemento de estado se va a obtener o establecer. Los elementos permitidos son idénticos a los permitidos en estado.

szID[MAX_LINKID_TEXT]

Tipo: WCHAR[MAX_LINKID_TEXT]

Cadena WCHAR que contiene el nombre del identificador. El número máximo de caracteres de la matriz es MAX_LINKID_TEXT. El nombre del identificador no se puede usar para acceder a un vínculo de control SysLink. El índice de elementos se usa para tener acceso al elemento.

szUrl[L_MAX_URL_LENGTH]

Tipo: WCHAR[L_MAX_URL_LENGTH]

Cadena WCHAR que contiene la dirección URL representada por el vínculo. El número máximo de caracteres de la matriz es L_MAX_URL_LENGTH.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado commctrl.h