Compartilhar via

Estrutura NMLVDISPINFOA (commctrl.h)

  • Artigo

Contém informações sobre um código de notificação LVN_GETDISPINFO ou LVN_SETDISPINFO. Essa estrutura é a mesma que a 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 de NMHDR que contém informações sobre esse código de notificação.

item

Tipo: LVITEM

estrutura de LVITEM que identifica o item ou subitem. A estrutura contém ou recebe informações sobre o item. A máscara membro 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.

Observações

Se a estrutura LVITEM estiver recebendo texto do item, os membros pszText e cchTextMax especificar 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. Neste ú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 de LVN_GETDISPINFO adicionais tenham sido enviadas.

Se você estiver tratando a mensagem de LVN_GETDISPINFO, poderá definir o sinalizador LVIF_DI_SETITEM na máscara de membro da estrutura de LVITEM . Isso informa ao sistema operacional para 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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