Estrutura TTTOOLINFOA (commctrl.h)

A estrutura TOOLINFO contém informações sobre uma ferramenta em um controle de dica de ferramenta.

Sintaxe

typedef struct tagTOOLINFOA {
  UINT      cbSize;
  UINT      uFlags;
  HWND      hwnd;
  UINT_PTR  uId;
  RECT      rect;
  HINSTANCE hinst;
  LPSTR     lpszText;
  LPARAM    lParam;
  void      *lpReserved;
} TTTOOLINFOA, *PTOOLINFOA, *LPTTTOOLINFOA;

Membros

cbSize

Tipo: UINT

Tamanho dessa estrutura, em bytes. Esse membro deve ser especificado.

uFlags

Tipo: UINT

Sinalizadores que controlam a exibição da dica de ferramenta. Esse membro pode ser uma combinação dos seguintes valores:

hwnd

Tipo: HWND

Manipule para a janela que contém a ferramenta. Se lpszText incluir o valor LPSTR_TEXTCALLBACK, esse membro identificará a janela que recebe os códigos de notificação TTN_GETDISPINFO .

uId

Tipo: UINT_PTR

Identificador definido pelo aplicativo da ferramenta. Se uFlags incluir o sinalizador TTF_IDISHWND, uId deverá especificar o identificador de janela para a ferramenta.

rect

Tipo: RECT

As coordenadas do retângulo delimitador da ferramenta. As coordenadas são relativas ao canto superior esquerdo da área do cliente da janela identificada por hwnd. Se uFlags incluir o sinalizador TTF_IDISHWND, esse membro será ignorado.

hinst

Tipo: HINSTANCE

Manipule para a instância que contém o recurso de cadeia de caracteres para a ferramenta. Se lpszText especificar o identificador de um recurso de cadeia de caracteres, esse membro será usado.

lpszText

Tipo: LPTSTR

Ponteiro para o buffer que contém o texto da ferramenta ou o identificador do recurso de cadeia de caracteres que contém o texto. Às vezes, esse membro é usado para retornar valores. Se você precisar examinar o valor retornado, deverá apontar para um buffer válido de tamanho suficiente. Caso contrário, ele pode ser definido como NULL. Se lpszText estiver definido como LPSTR_TEXTCALLBACK, o controle enviará o código de notificação TTN_GETDISPINFO para a janela do proprietário para recuperar o texto.

lParam

Tipo: LPARAM

Versão 4.70 e posterior. Um valor definido pelo aplicativo de 32 bits associado à ferramenta.

lpReserved

Tipo: void*

Reservado. Deve ser definido como NULL.

Comentários

Janelas normais exibem texto da esquerda para a direita (LTR). O Windows pode ser espelhado para exibir idiomas como hebraico ou árabe que leem da direita para a esquerda (RTL). Normalmente, o texto da dica de ferramenta é exibido na mesma direção que o texto em sua janela pai. Se TTF_RTLREADING estiver definido, o texto da dica de ferramenta será lido na direção oposta do texto na janela pai.

Requisitos