macro TreeView_GetItem (commctrl.h)

Recupera alcuni o tutti gli attributi di un elemento della visualizzazione albero. È possibile utilizzare questa macro o inviare il messaggio di TVM_GETITEM in modo esplicito.

Sintassi

BOOL TreeView_GetItem(
   HWND     hwnd,
   LPTVITEM pitem
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione albero.

pitem

Tipo: LPTVITEM

Puntatore a una struttura TVITEM che specifica le informazioni da recuperare e ricevere informazioni sull'elemento. Con versione 4.71 e successive, è possibile usare invece una struttura TVITEMEX .

Valore restituito

Tipo: BOOL

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario.

Osservazioni

Quando viene inviato il messaggio di TVM_GETITEM, il membro hItem del TVITEM o struttura TVITEMEX identifica l'elemento per recuperare informazioni e il membro mask specifica gli attributi da recuperare.

Se il flag TVIF_TEXT è impostato nella maschera di membro del TVITEM o struttura TVITEMEX, il membro pszText deve puntare a un buffer valido e il membro cchTextMax deve essere impostato sul numero di caratteri in tale buffer. Il testo restituito non verrà necessariamente archiviato nel buffer originale passato dall'applicazione. È possibile che pszText punti al testo in un nuovo buffer anziché inserirlo nel buffer precedente.

Fabbisogno