Estrutura TTTOOLINFOW (commctrl.h)

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

Sintaxe

typedef struct tagTOOLINFOW {
  UINT      cbSize;
  UINT      uFlags;
  HWND      hwnd;
  UINT_PTR  uId;
  RECT      rect;
  HINSTANCE hinst;
  LPWSTR    lpszText;
  LPARAM    lParam;
  void      *lpReserved;
} TTTOOLINFOW, *PTOOLINFOW, *LPTTTOOLINFOW;

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:

Valor	Significado
TTF_ABSOLUTE	Posiciona a janela de dica de ferramenta nas mesmas coordenadas fornecidas pelo TTM_TRACKPOSITION. Esse sinalizador deve ser usado com o sinalizador TTF_TRACK.
TTF_CENTERTIP	Centraliza a janela de dica de ferramenta abaixo da ferramenta especificada pelo membro uId .
TTF_IDISHWND	Indica que o membro uId é o identificador de janela para a ferramenta. Se esse sinalizador não estiver definido, uId será o identificador da ferramenta.
TTF_PARSELINKS	Versão 6.0 e posterior. Indica que os links no texto da dica de ferramenta devem ser analisados. Observe que Comctl32.dll versão 6 não é redistribuível, mas está incluído no Windows ou posterior. Para usar Comctl32.dll versão 6, especifique-a em um manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.
TTF_RTLREADING	Indica que o texto da dica de ferramenta será exibido na direção oposta ao texto na janela pai.
TTF_SUBCLASS	Indica que o controle de dica de ferramenta deve subclasse a janela da ferramenta para interceptar mensagens, como WM_MOUSEMOVE. Se esse sinalizador não estiver definido, você deverá usar a mensagem TTM_RELAYEVENT para encaminhar mensagens para o controle de dica de ferramenta. Para obter uma lista de mensagens que um controle de dica de ferramenta processa, consulte TTM_RELAYEVENT.
TTF_TRACK	Posiciona a janela de dica de ferramenta ao lado da ferramenta à qual ela corresponde e move a janela de acordo com as coordenadas fornecidas pelas mensagens TTM_TRACKPOSITION . Você deve ativar esse tipo de ferramenta usando a mensagem TTM_TRACKACTIVATE .
TTF_TRANSPARENT	Faz com que o controle de dica de ferramenta encaminhe mensagens de evento do mouse para a janela pai. Isso é limitado a eventos do mouse que ocorrem dentro dos limites da janela de dica de ferramenta.

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

Observação

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

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