Compartilhar via

Estrutura TTTOOLINFOA (commctrl.h)

  • Artigo

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:

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 da ferramenta. Se esse sinalizador não estiver definido, uId será o identificador da ferramenta.
TTF_PARSELINKS

versão 6.0 e posteriores. 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-o 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 aos 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 de retângulo delimitador da ferramenta. As coordenadas são relativas ao canto superior esquerdo da área do cliente da janela identificada por . 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 poderá 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 posteriores. Um valor definido pelo aplicativo de 32 bits associado à ferramenta.

lpReserved

Tipo: void*

Reservado. Deve ser definido como NULL.

Observações

Janelas normais exibem texto da esquerda para a direita (LTR). As janelas podem ser espelhadas 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.

Nota

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