CListCtrl::SetItem

Článek
06/10/2015

Nastaví zobrazení seznamu všechny nebo některé položky atributy.

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  
);

Parametry

pItem
Adresa LVITEM struktura, která obsahuje novou položku atributy, jak je popsáno v .Na strukturu položky a iSubItem členy identifikovat položku nebo podpoložku a na strukturu Maska člena Určuje atributy, které chcete nastavit.Další informace o Maska člena, najdete poznámky.
nItem
Index položky, jejichž atributy mají být nastaveny.
nSubItem
Index podpoložek, jejichž atributy mají být nastaveny.
nMask
Určuje atributy, které mají být nastaveny (viz poznámky).
lpszItem
Adresa řetězec zakončený hodnotou null určující popisek položky.
nImage
Index obrázku pro položky v seznamu obrázků.
nState
Určuje hodnoty pro státy, které chcete změnit (viz poznámky).
nStateMask
Určuje, které státy změnit (viz poznámky).
lParam
Hodnota 32bitové aplikace přiřazené ke zboží.
nIndent
Šířka v pixelech odsazení.Pokud nIndent je menší než systémem definované minimální šířka Nová šířka nastavena na minimální definované systémem

Vrácená hodnota

Nenulová hodnota, pokud je úspěšná. jinak nula.

Poznámky

Položky a iSubItem členy LVITEM struktury a nItem a nSubItem parametry identifikaci položek a podpoložek, jejichž atributy mají být nastaveny.

Maska člen LVITEM struktury a nMask parametr určete, která položka atributy se stanoví:

LVIF_TEXTPszText člena nebo lpszItem parametr je adresa řetězec zakončený; cchTextMax bude tato vlastnost ignorována.
LVIF_STATEStateMask členských nebo nStateMask parametr určuje, která položka státy změnit a stavu člen nebo nState parametr obsahuje hodnoty pro tyto státy.