Estrutura NMLVGETINFOTIPA (commctrl.h)

Contém e recebem 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 NMHDR que contém informações sobre esse código de notificação.

dwFlags

Tipo: DWORD

Zero ou LVGIT_UNFOLDED. Consulte Observações.

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 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. Esse membro não é usado no momento e sempre será zero.

lParam

Tipo: LPARAM

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

Comentários

Diz-se que um item é dobrado quando o texto exibido no momento é 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.

Observação

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 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

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