CListCtrl::SetItem
Imposta alcuni o tutti gli attributi di una voce della visualizzazione elenco.
BOOL SetItem(
const LVITEM* pItem
);
BOOL SetItem(
int nItem,
int nSubItem,
UINT nMask,
LPCTSTR lpszItem,
int nImage,
UINT nState,
UINT nStateMask,
LPARAM lParam
);
BOOL SetItem(
int nItem,
int nSubItem,
UINT nMask,
LPCTSTR lpszItem,
int nImage,
UINT nState,
UINT nStateMask,
LPARAM lParam,
int nIndent
);
Parametri
pItem
Indirizzo di una struttura LVITEM contenente i nuovi attributi dell'elemento, come descritto in Windows SDK. I membri iItem e iSubItem della struttura identifica l'elemento o elemento secondario e il membro mask della struttura specifica che gli attributi per impostare. Per ulteriori informazioni sul membro mask, vedere Note.nItem
Indice dell'elemento con gli attributi devono essere impostati.nSubItem
Indice dell'elemento secondario di cui gli attributi devono essere impostati.nMask
Specifica gli attributi devono essere impostati (vedere le note).lpszItem
Indirizzo di una stringa con terminazione null che specifica l'etichetta dell'elemento.nImage
Indice dell'immagine dell'elemento nell'elenco.nState
Specifica i valori affinché siano stati modificati (vedere le note).nStateMask
Specifica che gli stati devono essere modificati (vedere le note).lParam
Un valore specifico dell'applicazione a 32 bit da associare all'elemento.nIndent
Larghezza, in pixel, del rientro. Se nIndent è inferiore alla larghezza minima definita dal sistema, la nuova proprietà è impostata sul valore minimo definito dal sistema
Valore restituito
Diverso da zero se ha esito positivo; in caso contrario zero.
Note
I membri iSubItem e iItem della struttura LVITEM e i parametri nSubItem e nItem identifica l'elemento e l'elemento secondario di cui gli attributi devono essere impostati.
Il membro mask della struttura LVITEM e il parametro nMask specificare gli attributi dell'elemento deve essere impostato:
LVIF_TEXT il membro pszText o il parametro lpszItem è l'indirizzo di una stringa con terminazione null; il membro cchTextMax viene ignorato.
LVIF_STATE il membro stateMask o il parametro nStateMask specificare che l'elemento dichiara per la modifica e il membro state o il parametro nState contiene i valori per tali stati.
Esempio
Vedere l'esempio relativo CListCtrl::HitTest.
Requisiti
Header: afxcmn.h