Compartilhar via


Estrutura NMLVGETINFOTIPA (commctrl.h)

Contém e recebe informações de item de exibição de lista necessárias para exibir uma dica de ferramenta para um item. Essa estrutura é usada com o código de notificação LVN_GETINFOTIP.

Sintaxe

typedef struct tagNMLVGETINFOTIPA {
  NMHDR  hdr;
  DWORD  dwFlags;
  LPSTR  pszText;
  int    cchTextMax;
  int    iItem;
  int    iSubItem;
  LPARAM lParam;
} NMLVGETINFOTIPA, *LPNMLVGETINFOTIPA;

Membros

hdr

Tipo: NMHDR

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

dwFlags

Tipo: DWORD

Zero ou LVGIT_UNFOLDED. Consulte Comentários.

pszText

Tipo: LPTSTR

Endereço de um buffer de cadeia de caracteres que recebe qualquer informação de texto adicional. Se dwFlags for zero, esse membro conterá o texto do item existente. Nesse caso, você deve acrescentar qualquer texto adicional ao final dessa cadeia de caracteres. O tamanho desse buffer é especificado pela estrutura de cchTextMax .

cchTextMax

Tipo: int

Tamanho, em caracteres, do buffer apontado por pszText. Embora você nunca deva assumir que esse buffer será de qualquer tamanho específico, o valor INFOTIPSIZE pode ser usado para fins de design.

iItem

Tipo: int

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

iSubItem

Tipo: int

Índice baseado em um do subitem ao qual essa estrutura se refere. Se esse membro for zero, a estrutura se referirá ao item e não a um subitem. Este membro não é usado no momento e sempre será zero.

lParam

Tipo: LPARAM

Valor definido pelo aplicativo associado ao item. Este membro não é usado no momento e sempre será zero.

Observações

Diz-se que um item é dobrado quando o texto exibido atualmente é truncado. Se LVGIT_UNFOLDED for retornado em dwFlags, o texto completo do item já será exibido, portanto, não será necessário exibi-lo na dica de ferramenta.

Nota

O cabeçalho commctrl.h define NMLVGETINFOTIP 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