sc_event_hint('nome_do_campo', 'mensagem de ajuda' , largura_maxima)

A macro sc_event_hint permite que o desenvolvedor defina um texto de ajuda (tootip) nos campos que contenham links criados a partir do evento onClick. 

A macro não está disponível para eventos criados a partir dos botões da barra de ação 

Parâmetros

A macro possui três, sendo dois obrigatórios (nome_do_campo e mensagem) e um opcional (largura_maxima). Os parâmetros devem ser separados por virgula (,).

Parâmetros Descrição Exemplo
nome_do_campo

Parâmetro obrigatório e recebe o nome do campo, em string, onde o texto de ajuda (tooltip) será exibido.

O nome do campo deve ser informado entre aspas duplas ou simples, contendo apenas o nome do campo. Este parâmetro não aceita o uso de veriáveis.

 
// Exemplo de definição do parâmetro.
sc_event_hint('nome_do_campo', 'Clique para mais informações', 100);
mensagem

Parâmetro obrigatório que recebe o texto de ajuda que será exibido ao posicionar o mouse sobre o link criado no evento ajax. O texto será axibido apenas no campo informado no primeiro parâmetro caso exita um evento onclink configurado.

O parâmetro pode ser definido com:

  • String (protegida por aspas duplas ou simples)
  • Variável PHP
  • Variável global
  • Lang. 
 
//Definição do texto usando string.
sc_event_hint('nome_do_campo', 'Clique para mais informações', 100);

//Definição do texto usando variável PHP.
sc_event_hint('nome_do_campo', $var_php, 100);

//Definição do texto usando variável global.
sc_event_hint('nome_do_campo', [var_global], 100);

//Definição do texto usando lang do scriptcase.
sc_event_hint('nome_do_campo', {lang_nome_da_lang}, 100);
largura_hint

Parâmetro opcional que define a largura máxima do hint onde a mensagem será exibida, ao atingir o limite definido quebra linha do texto.

O Tamanho é definido em pixel, e deve ser informado apenas números.

 
//Definição do texto usando limitando tamanho.
sc_event_hint('nome_do_campo', 'Clique para mais informações', 100);

Exemplo de uso

Exemplo 1: Utilizando uma lang

sc_event_hint("customerid", {lang_nome_da_lang});

 

Exemplo 2: Informando descrição com variável PHP.

$var_msg_help = "Mensagem de ajuda do campo";

sc_event_hint("customerid", &var_msg_help );

 

Exemplo 3: Com validação

if ( {tipo_pessoa} == "F" ) {

    sc_event_hint(campo,"Pessoa Física");

} else {
  
  sc_event_hint(campo,"Pessoa Jurídica");

}