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 |