CListCtrl::SetItem

Artigo
08/25/2010

Define alguns ou todos de um modo de exibição de lista de atributos do item.

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 um LVITEM estrutura que contém sistema autônomo novos atributos do item, conforme descrito no Windows SDK. iItem and iSubItem membros identificar o item ou subitem e máscara membro especifica quais atributos ao conjunto.Para obter mais informações sobre o máscara membro, consulte o Comentários.
nItem
Índice do item cujos atributos devem ser conjunto.
nSubItem
Índice de subitem cujos atributos devem ser conjunto.
nMask
Especifica os atributos que devem ser conjunto (consulte os comentários).
lpszItem
Endereço de uma cadeia terminada com nulo que especifica o rótulo do item.
nImage
Índice da imagem do item dentro da lista de imagem.
nState
Especifica valores para os estados a ser alterada (consulte os comentários).
nStateMask
Especifica quais estados estão a ser alterada (consulte os comentários).
lParam
Um valor de específicas do aplicativo de 32 bit a ser associado ao item.
nIndent
Largura, em pixels, o recuo.If nIndent é menor que a largura mínima definida pelo sistema, a nova largura é conjunto mínimo definido pelo sistema

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, nenhum.

Comentários

The iItem and iSubItem o membrosLVITEM estrutura e o nItem e nSubItem parâmetros identificam o item e subitem cujos atributos devem ser conjunto.

The máscara membro do LVITEM estrutura e o nMask parâmetro especifica qual item atributos devem ser definidas:

LVIF_TEXT O pszText membro ou a lpszItem parâmetro é o endereço de uma seqüência de caracteres terminada com caractere nulo; o cchTextMax membro será ignorado.
LVIF_STATE O stateMask membro ou nStateMask parâmetro especifica qual item informa para alterar o estado membro ou nState parâmetro contém os valores para os estados.