Struttura LITEM (commctrl.h)

  • Articolo

Consente di impostare e recuperare informazioni su un elemento di collegamento.

Sintassi

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

Members

mask

Tipo: UINT

Combinazione di uno o più dei flag seguenti, che descrivono le informazioni da impostare o recuperare:

Valore Significato
LIF_ITEMINDEX
 Recuperare l'indice dell'elemento numerico. Gli elementi sono sempre accessibili per indice, pertanto è necessario impostare sempre questo flag e assegnare un valore a iLink. Per ottenere l'ID elemento, è necessario impostare sia LIF_ITEMINDEX che LIF_ITEMID.
LIF_STATE
 Usare stateMask per ottenere o impostare lo stato del collegamento.
LIF_ITEMID
 Specificare l'elemento in base al valore ID specificato in szID.
LIF_URL
 Impostare o ottenere l'URL per questo elemento.

iLink

Tipo: int

Valore di tipo int che contiene l'indice dell'elemento. Questo indice numerico viene usato per accedere a un collegamento di controllo SysLink.

state

Tipo: UINT

Combinazione di uno o più dei flag seguenti, che descrive lo stato dell'elemento:

Valore Significato
LIS_ENABLED
 Il collegamento può rispondere all'input dell'utente. Si tratta dell'impostazione predefinita, a meno che l'intero controllo non sia stato creato con WS_DISABLED. In questo caso, tutti i collegamenti sono disabilitati.
LIS_FOCUSED
 Il collegamento ha lo stato attivo della tastiera. Premendo INVIO viene inviata una notifica di NM_CLICK.
LIS_VISITED
 Il collegamento è stato visitato dall'utente. Se si modifica l'URL con uno che non è stato visitato, questo flag viene cancellato.
LIS_HOTTRACK
 Indica che il controllo syslink verrà evidenziato in un colore diverso (COLOR_HIGHLIGHT) quando il mouse passa il mouse sul controllo.
LIS_DEFAULTCOLORS
 Abilitare i colori del testo personalizzati da utilizzare.

stateMask

Tipo: UINT

Combinazione di flag che descrivono l'elemento di stato da ottenere o impostare. Gli elementi consentiti sono identici a quelli consentiti nello stato.

szID[MAX_LINKID_TEXT]

Tipo: WCHAR[MAX_LINKID_TEXT]

Stringa WCHAR che contiene il nome ID. Il numero massimo di caratteri nella matrice è MAX_LINKID_TEXT. Il nome ID non può essere utilizzato per accedere a un collegamento di controllo SysLink. Usare l'indice dell'elemento per accedere all'elemento.

szUrl[L_MAX_URL_LENGTH]

Tipo: WCHAR[L_MAX_URL_LENGTH]

Stringa WCHAR che contiene l'URL rappresentato dal collegamento. Il numero massimo di caratteri nella matrice è L_MAX_URL_LENGTH.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione commctrl.h