Partilhar via


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

Consulte também

Referência

Classe CListCtrl

Gráfico da hierarquia

CListCtrl::GetItem