LVITEM

9/9/2008

Essa estrutura que especifica ou recebe os atributos de uma lista-exibição item. Ele foi atualizado para um novo valor máscara (LVIF_INDENT) que permite recuo item suporte.

Syntax

typedef struct _LVITEM { 
  UINT mask; 
  int iItem; 
  int iSubItem; 
  UINT state; 
  UINT stateMask; 
  LPTSTR pszText; 
  int cchTextMax; 
  int iImage; 
  LPARAM lParam;
  #if (_WIN32_IE >= 0x0300)
    int iIndent;
  #endif
    int iGroupId;
} LVITEM; 

Os membros

• máscara
  Especifica que os membros dessa estrutura contêm dados a ser definido ou são que está sendo solicitados. Ele pode ser uma combinação de um ou mais a seguinte sinalizadores.

  Valor	Descrição
  LVIF_GROUPID	O iGroupId membro é válido ou deve ser preenchido.
  LVIF_TEXT	O pszText membro é válido ou deve ser preenchido.
  LVIF_IMAGE	O iImage membro é válido ou deve ser preenchido.
  LVIF_INDENT	O iIndent membro é válido ou deve ser preenchido.
  LVIF_NORECOMPUTE	O controle não irá gerar uma mensagem LVN_GETDISPINFO para recuperar informações de texto se ele recebe uma mensagem LVM_GETITEM. Em vez disso, o pszText membro conterá LPSTR_TEXTCALLBACK.
  LVIF_PARAM	O lParam membro é válido ou deve ser preenchido.
  LVIF_STATE	O estado membro é válido ou deve ser preenchido.
  LVIF_DI_SETITEM	O sistema operacional deve armazenar informações as item solicitado lista e não pergunte para ele novamente. Este sinalizador é usado somente com a mensagem LVN_GETDISPINFO.

• iItem
  Índice baseado em zero do item ao qual essa estrutura se refere.

• iSubItem
  Índice One-Based do subitem aos quais essa estrutura se refere, ou zero se esta estrutura se refere a um item rather than um subitem.

• estado
  Estado atual do item se estado do item está sendo recuperado, ou o novo estado se estado do item estiver sendo definido. O stateMask membro Especifica os bits desse membro devem ser recuperadas ou modificados. Qualquer bits nesse membro que não são definidos no stateMask será ignorado. Esse membro pode ser qualquer válido combinação de lista-Valores estado da exibição.

• stateMask
  Especifica os bits da estado membro será recuperado ou modificado.

  Se estado do item está sendo recuperado, esse membro permite que você especificar quais estados serão recuperados. De exemplo, configuração esse membro para LVIS_SELECTED irá causar somente estado seleção do item a ser recuperados.

  Se estado do item está sendo modificado, esse membro permite que você modifique uma ou mais estados sem recuperar todos os estados primeiro. De exemplo, configuração esse membro para LVIS_SELECTED e estado Para zero irá causar estado seleção do item a ser limpos, mas nenhum dos outros estados serão afetados.

  Para recuperar ou modificar todos os estados, defina esse membro como (UINT) –1.

• pszText
  Ponteiro para uma seqüência de caracteres NULL-Terminated que contém o texto item se a estrutura Especifica atributos item. Se esse membro for o valor LPSTR_TEXTCALLBACK, o item será um callback item. Não defina o pszText membro para LPSTR_TEXTCALLBACK se a lista-exibição controle possui estilo LVS_SORTASCENDING ou LVS_SORTDESCENDING.

  Se a estrutura está recebendo atributos item, esse membro é o ponteiro para a reserva que recebe o texto item.

• cchTextMax
  Tamanho da reserva apontado pelo pszText membro. Se a estrutura não está recebendo informações, esse membro será ignorado.

• iImage
  O índice da lista-exibição ícone do item na lista a ícone e lista de imagens o ícone pequeno.

  Se esse membro é o valor I_IMAGECALLBACK, o janela pai é responsável para armazenar o índice. Neste maiúsculas e minúsculas, a lista-controle de exibição o pai envia uma mensagem LVN_GETDISPINFO para get o índice quando ele precisa exibir a imagem.

• lParam
  Especifica os 32-bit valor do item. Se você usar o LVM_SORTITEMS mensagem, a lista-controle de exibição passa esse valor para a função de comparação Application-defined. Você também pode usar a mensagem LVM_FINDITEM para pesquisa uma lista-controle de exibição para um item com um especificado lParam valor.

• iIndent
  Número de larguras imagem para recuar o item. Um único recuo é igual a largura de uma imagem item. Portanto, o valor 1 recua o item, a largura de uma imagem, os recuos valor 2 por duas imagens e SO on. Observe que esse membro é com suporte somente para itens. A tentativa de definir subitem recuo irá causar a função chamado falhe.

• iGroupId
  Identificador (identificação) da GRUPO. Ele pode ser uma do seguinte valores.

  Valor	Descrição
  I_GROUPIDCALLBACK	O controle ListView envia o pai um LVN_GETDISPINFO mensagem notificação para recuperar o índice da GRUPO
  I_GROUPIDNONE	O controle ListView tem não GRUPO.

Remarks

O LVITEM estrutura é usada com um número de mensagens, incluindo LVM_GETITEM, LVM_SETITEM, LVM_INSERTITEM e LVM_DELETEITEM.

Essa estrutura substitui o LV_ITEM estrutura.

Tamanho da reserva apontado pelo pszText membro se a estrutura está recebendo atributos item. Este membro será ignorado se a estrutura Especifica atributos item.

Requirements

Header	commctrl.h
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

List-View Controls Structures