Structure LITEM (commctrl.h)

Permet de définir et de récupérer des informations sur un élément de lien.

Syntaxe

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

Membres

mask

Type : UINT

Combinaison d’un ou plusieurs des indicateurs suivants, décrivant les informations à définir ou à récupérer :

Valeur	Signification
LIF_ITEMINDEX	Récupérez l’index d’élément numérique. Les éléments étant toujours accessibles par index, vous devez toujours définir cet indicateur et affecter une valeur à iLink. Pour obtenir l’ID d’élément, vous devez définir LIF_ITEMINDEX et LIF_ITEMID.
LIF_STATE	Utilisez stateMask pour obtenir ou définir l’état du lien.
LIF_ITEMID	Spécifiez l’élément par la valeur d’ID indiquée dans szID.
LIF_URL	Définissez ou obtenez l’URL de cet élément.

iLink

Type : int

Valeur de type int qui contient l’index d’élément. Cet index numérique est utilisé pour accéder à un lien de contrôle SysLink.

state

Type : UINT

Combinaison d’un ou plusieurs des indicateurs suivants, décrivant l’état de l’élément :

Valeur	Signification
LIS_ENABLED	Le lien peut répondre aux entrées de l’utilisateur. Il s’agit de la valeur par défaut, sauf si l’intégralité du contrôle a été créée avec WS_DISABLED. Dans ce cas, tous les liens sont désactivés.
LIS_FOCUSED	Le lien a le focus clavier. Appuyez sur Entrée pour envoyer une notification NM_CLICK.
LIS_VISITED	Le lien a été visité par l’utilisateur. La modification de l’URL par une URL qui n’a pas été visitée entraîne l’effacement de cet indicateur.
LIS_HOTTRACK	Indique que le contrôle syslink se met en surbrillance dans une couleur différente (COLOR_HIGHLIGHT) lorsque la souris pointe sur le contrôle.
LIS_DEFAULTCOLORS	Activer l’utilisation des couleurs de texte personnalisées.

stateMask

Type : UINT

Combinaison d’indicateurs décrivant l’élément d’état à obtenir ou à définir. Les éléments autorisés sont identiques à ceux autorisés dans l’état.

szID[MAX_LINKID_TEXT]

Type : WCHAR[MAX_LINKID_TEXT]

Chaîne WCHAR qui contient le nom de l’ID. Le nombre maximal de caractères dans le tableau est MAX_LINKID_TEXT. Le nom de l’ID ne peut pas être utilisé pour accéder à un lien de contrôle SysLink. Vous utilisez l’index d’élément pour accéder à l’élément.

szUrl[L_MAX_URL_LENGTH]

Type : WCHAR[L_MAX_URL_LENGTH]

Chaîne WCHAR qui contient l’URL représentée par le lien. Le nombre maximal de caractères dans le tableau est L_MAX_URL_LENGTH.

Spécifications

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	commctrl.h