CListCtrl::SetItem
Define alguns ou todos os atributos de um item de exibição 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
Endereço de uma estrutura de LVITEM que contém os novos atributos de item, como descrito em Windows SDK.Membros de iItem e de iSubItem estrutura identificam o item ou, e o subitens o membro de estrutura mask especifica que atribui para definir.Para obter mais informações sobre o membro de mask , consulte Comentários.nItem
Índice do item cujos atributos devem ser definidos.nSubItem
Cujos índice de subitens atributos devem ser definidos.nMask
Especifica quais atributos devem ser definidos (consulte os comentários).lpszItem
Endereço de uma cadeia de caracteres NULL- finalizada que especifica o rótulo de item.nImage
Índice de imagem do item da lista de imagem.nState
Especifica valores para os estados sejam modificados (consulte os comentários).nStateMask
Especifica que estados devem ser alterados (consulte os comentários).lParam
Um valor específico do aplicativo de 32 bits para ser associado ao item.nIndent
Largura, em pixels, de recuo.Se nIndent for menor do que a largura mínima do sistema definida, a nova largura é definida como o mínimo sistema definido
Valor de retorno
Diferente de zero se com êxito; se não zero.
Comentários
Membros de iItem e de iSubItem estrutura de LVITEM e dos parâmetros de nItem e de nSubItem identificam o item e cujos o subitens atributos devem ser definidos.
O membro de mask estrutura de LVITEM e o parâmetro de nMask que especificam os atributos de item devem ser definidos:
LVIF_TEXT o membro de pszText ou o parâmetro de lpszItem é o endereço de uma cadeia de caracteres NULL-finalizada; o membro de cchTextMax é ignorado.
LVIF_STATE o membro de stateMask ou o parâmetro de nStateMask especifica que os estados de item para alterar e o membro de state ou o parâmetro de nState contêm os valores para os estados.
Exemplo
Consulte o exemplo para CListCtrl::HitTest.
Requisitos
Cabeçalho: afxcmn.h