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

void TreeView_GetItem(
   hwnd,
   pitem
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo di visualizzazione albero.

pitem

Tipo: LPTVITEM

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

Valore restituito

nessuno

Osservazioni

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

Se il flag TVIF_TEXT viene impostato nel membro mask della struttura TVITEM o TVITEMEX , il membro pszText deve puntare a un buffer valido e il membro cchTextMax deve essere impostato sul numero di caratteri nel 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.

Requisiti