CListCtrl::SetItem

Artikel
06/10/2015

Legt mehrere oder alle Attribute eines Listenansichtelements fest.

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

Parameter

pItem
Adresse einer LVITEM-Struktur, die die Attribute des neuen Elements enthält, wie in Windows SDK beschrieben. Die iItem und iSubItem-Member der Struktur identifizieren das Element oder das Unterelement, und der mask-Member der Struktur gibt an, der zum, um festzulegen. Weitere Informationen zu den mask-Member, finden Sie unter Remarks.
nItem
Index des Elements, dessen Attribute festgelegt werden sollen.
nSubItem
Index des Unterelements, dessen Attribute festgelegt werden sollen.
nMask
Gibt an, welche Attribute festgelegt werden sollen (siehe die Hinweise).
lpszItem
Adresse einer auf NULL endende Zeichenfolge, die die Bezeichnung des Elements angibt.
nImage
Index des Bilds des Elements innerhalb der Bildliste.
nState
Gibt Werte an, damit Zustände geändert werden können (siehe die Hinweise).
nStateMask
Gibt an, welche Zustände geändert werden sollen (siehe die Hinweise).
lParam
Ein mit dem Element zugeordnet werden, anwendungsspezifisches 32-Bit-Wert.
nIndent
Breite, in Pixel, des Einzugs. Wenn nIndent kleiner als die systemdefinierte Mindestbreite ist, wird der neue Breite dem systemdefinierten Minimum festgelegt

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; null andernfalls.

Hinweise

Die iItem und iSubItemLVITEM-Member der Struktur und der nItem und nSubItem-Parameter identifizieren das Element und das Unterelement, dessen Attribute festgelegt werden sollen.

Der maskLVITEM-Member der Struktur und der nMask-Parameter geben an, die Elementattribute festgelegt werden sollen:

LVIF_TEXT der pszText-Member oder der lpszItem-Parameter ist die Adresse einer auf NULL endende Zeichenfolge; der cchTextMax-Member wird ignoriert.
LVIF_STATE der stateMask-Member oder der nStateMask-Parameter gibt an, das Element angibt, um zu ändern und der state-Member oder der nState-Parameter enthält die Werte für diese Zustände.