CListCtrl::SetItem
Establece algunos o todos los atributos de un elemento de vista de lista.
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
);
Parámetros
pItem
Dirección de una estructura de LVITEM que contiene los atributos del nuevo elemento, como se describe en Windows SDK.Los miembros de iItem y de iSubItem de estructura identifican el elemento o el subelemento, y el miembro de máscara de estructura especifica que los atributos al conjunto.Para obtener más información sobre el miembro de máscara , vea Comentarios.nItem
Índice del elemento cuyos atributos deben estar establecidos.nSubItem
Índice del subelemento cuyos atributos deben estar establecidos.nMask
Especifica qué atributos deben estar establecidos (vea comentarios).lpszItem
Dirección de una cadena terminada en null que especifica la etiqueta del elemento.nImage
Índice del elemento de la lista de imágenes.nState
Especifica los valores para que los estados son modificadas (vea comentarios).nStateMask
Especifica que los estados deben modificarse (vea comentarios).lParam
Valor específico de la aplicación de 32 bits a asociar al elemento.nIndent
ancho, en píxeles, de la sangría.Si nIndent es menor que el ancho mínimo definido, el nuevo ancho se establece como mínimo definido
Valor devuelto
Distinto de cero si correctamente; si no cero.
Comentarios
Los miembros de iItem y de iSubItem de la estructura de LVITEM y los parámetros de nItem y de nSubItem identifican el elemento y el subelemento cuyos atributos deben estar establecidos.
El miembro de máscara de la estructura de LVITEM y el parámetro de nMask especifican que los atributos del elemento deben establecer:
El miembro deLVIF_TEXT The pszText o el parámetro de lpszItem es la dirección de una cadena terminada en null; se omite el miembro de cchTextMax .
El miembro deLVIF_STATE The stateMask o el parámetro de nStateMask especifica que el elemento indica para cambiar y el miembro de state o el parámetro de nState contiene valores para esos estados.
Ejemplo
Vea el ejemplo para CListCtrl:: HitTest.
Requisitos
encabezado: afxcmn.h