Controle de dica de ferramenta

Esse controle exibe uma mensagem de informação sobre outros controles.

O controle Dica de ferramenta é mais comumente usado para exibir dicas úteis sobre controles de entrada. O controle Dica de ferramenta é um contêiner para outros controles, como Texto.

Propriedades de configuração

Configure ou modifique propriedades de configuração do controle, como propriedades de aparência e comportamento, na guia de propriedades Configuração. Configure as propriedades de configuração de fórmula na guia Eventos.
Tamanho da Tela
Uma propriedade de configuração que tenha o ícone Tamanhos de tela O ícone Tamanhos de tela ao lado do nome da propriedade pode ter valores diferentes para cada tamanho de tela. Se um valor não for configurado, o tamanho da tela herdará o valor do próximo maior tamanho de tela como seu valor padrão. Se estiver utilizando o editor de desktop do Process Designer, configure o valor para o tamanho de tela grande. Os outros tamanhos de tela herdam esse valor.
Definições de tema
As definições de tema especificam as cores e os estilos para um controle e determinam a aparência do controle. É possível visualizar a aparência e o comportamento de controles no editor de tema. Consulte o Temas.
As propriedades de configuração de aparência para o controle Dica de ferramenta são mostradas na tabela a seguir:
Tabela 1. Propriedades de configuração de aparência para o controle Dica de ferramenta
Propriedade de configuração de aparência Descrição Tipo de Dados
Mostrar rótulo O ícone Tamanhos de tela Exibe um rótulo. Se o controle Dica de ferramenta tiver um rótulo, ele será exibido. Se o controle Dica de ferramenta não tiver um rótulo e contiver outro controle, o rótulo do controle interno será exibido. Se Mostrar rótulo não estiver selecionado, nenhum rótulo será mostrado.
Nota: A propriedade de visibilidade Rótulo da visualização de coach é ignorada.
 Boolean
Posicionamento do rótulo O ícone Tamanhos de tela A posição do rótulo. String
Largura O ícone Tamanhos de tela A largura do controle. É possível especificar a largura em px (pixels), % (percentual) ou unidades eme. Por exemplo, 50 px, 20% ou 0,4 eme. Se um tipo de unidade não for especificado, px será assumido. Integer
Estilo de cor O estilo de cor para o controle. As cores correspondem às variáveis no tema especificado. ColorStyle
Posição horizontal O posicionamento horizontal da dica de ferramenta. .  
Posição vertical O posicionamento vertical da dica de ferramenta.  

As propriedades de configuração de comportamento para o controle Dica de ferramenta são mostradas na tabela a seguir:

Tabela 2. Propriedades de configuração de comportamento para o controle Dica de ferramenta
Propriedade de configuração de comportamento Descrição Tipo de Dados
Mostrar dica de ferramenta O ícone Tamanhos de tela Exibe a dica de ferramenta quando a página é carregada. Boolean
Mostrar na ajuda instantânea Exibe a dica de ferramenta quando o usuário passa o mouse sobre o controle relacionado. Boolean
Texto como HTML Fornece o texto de dica da ferramenta usando HTML. Se sim, deve-se inserir o texto de dica da ferramenta na caixa de texto Ajuda, na guia Geral. Boolean

Exemplo

Neste exemplo, há um controle Texto dentro de um controle Dica de ferramenta e as propriedades de configuração a seguir são configuradas para o controle Dica de ferramenta:

  • Guia de Eventos:
    • A Fórmula de dica de ferramenta é configurada como "Minha dica de ferramenta".
  • Configuração de Aparência:
    • Mostrar rótulo não é selecionado.
    • Posicionamento do rótulo é configurado como Esquerda.
    • Largura é configurada como 50%.
    • Estilo de cor é configurado como Padrão.
    • Posição horizontal é configurado como Esquerda.
    • Posição vertical é configurado como Parte superior.
  • Configuração de comportamento:
    • Mostrar dica de ferramenta é selecionado.
    • Mostrar na ajuda instantânea não é selecionado.
    • Texto como HTML é selecionada.

Essas propriedades e seus valores resultam em um elemento de dica de ferramenta que é metade do tamanho do tamanho de controle da Dica de ferramenta padrão e que diz Minha dica de ferramenta em um fundo preto. Esse elemento de dica de ferramenta é exibido acima de uma área de texto, no lado esquerdo e fica visível assim que a página é carregada.

Nota: O controle Dica de ferramenta é um controle de contêiner. No tempo de execução, ele agrupa a si mesmo ao redor do controle aninhado.

Eventos

Configure ou modifique as propriedades de configuração da fórmula e os manipuladores de eventos para o controle na guia Eventos. É possível configurar eventos para serem acionados programaticamente ou quando um usuário interage com o controle. Para obter informações sobre como definir e codificar eventos, veja Eventos definidos pelo usuário.
As propriedades de configuração de fórmula para o controle Dica de ferramenta são mostradas na tabela a seguir:
Tabela 3. Propriedades de configuração de fórmula para o controle Dica de ferramenta
Propriedade de configuração de fórmula Descrição Tipo de Dados
Fórmula de dica de ferramenta Fórmula ou expressão usada para calcular o texto de Dica de ferramenta. String
O controle Dica de ferramenta tem os tipos de manipuladores de eventos a seguir:
  • On load: ativado quando a página é carregada.
  • On click: ativado quando a dica de ferramenta é clicada.

Métodos

Para obter informações detalhadas sobre os métodos disponíveis para o controle Dica de ferramenta, veja a API de JavaScript de Dica de ferramenta.

Recursos adicionais

Para obter informações sobre como criar um coach, veja Construindo coaches.
Para obter informações sobre propriedades padrão (Geral, Configuração, Posicionamento, Visibilidade e Atributos HTML), veja Propriedades da visualização de coach.

Tópico pai: Controles no kit de ferramentas de UI do BPM