Estrutura NMLVDISPINFOA (commctrl.h)

Contém informações sobre um código de notificação de LVN_GETDISPINFO ou LVN_SETDISPINFO . Essa estrutura é igual à estrutura de LV_DISPINFO , mas foi renomeada para se ajustar às convenções de nomenclatura padrão.

Sintaxe

typedef struct tagLVDISPINFO {
  NMHDR   hdr;
  LVITEMA item;
} NMLVDISPINFOA, *LPNMLVDISPINFOA;

Membros

hdr

Tipo: NMHDR

Estrutura NMHDR que contém informações sobre esse código de notificação.

item

Tipo: LVITEM

Estrutura LVITEM que identifica o item ou subitem. A estrutura contém ou recebe informações sobre o item. O membro mask contém um conjunto de sinalizadores de bits que especificam quais atributos de item são relevantes. Para obter mais informações sobre os sinalizadores de bits disponíveis, consulte LVITEM.

Comentários

Se a estrutura LVITEM estiver recebendo texto do item, os membros pszText e cchTextMax especificarão o endereço e o tamanho de um buffer. Você pode copiar texto para o buffer ou atribuir o endereço de uma cadeia de caracteres ao membro pszText . No último caso, você não deve alterar ou excluir a cadeia de caracteres até que o texto do item correspondente seja excluído ou duas mensagens LVN_GETDISPINFO adicionais tenham sido enviadas.

Se você estiver manipulando a mensagem LVN_GETDISPINFO , poderá definir o sinalizador LVIF_DI_SETITEM no membro de máscara da estrutura LVITEM . Isso instrui o sistema operacional a armazenar as informações de item de lista solicitadas e não solicitá-la novamente. Para controles de exibição de lista com o estilo LVS_REPORT , esse sinalizador só se aplica às informações da primeira coluna (subitem 0). O controle não armazenará informações para subitems.

Observação

O cabeçalho commctrl.h define NMLVDISPINFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	commctrl.h