|
La macro sc_event_hint permite que el desarrollador defina un texto de ayuda (tooltip) en los campos que contienen enlaces creados a partir del evento onClick.
La macro no está disponible para eventos creados a partir de los botones de la barra de acción.
Parámetros
La macro tiene tres parámetros, de los cuales dos son obligatorios (nombre_del_campo y mensaje) y uno opcional (ancho_máximo). Los parámetros deben estar separados por una coma (,).
| Parámetro |
Descripción |
Ejemplo |
nombre_del_campo |
Parámetro obligatorio que recibe el nombre del campo, como una cadena, donde se mostrará el texto de ayuda (tooltip).
El nombre del campo debe estar entre comillas dobles o simples, conteniendo solo el nombre del campo. Este parámetro no acepta el uso de variables.
|
// Ejemplo de definición del parámetro.
sc_event_hint('nombre_del_campo', 'Haga clic para más información', 100);
|
mensaje |
Parámetro obligatorio que recibe el texto de ayuda que se mostrará al pasar el cursor sobre el enlace creado en el evento Ajax. El texto solo se mostrará en el campo especificado en el primer parámetro si existe un evento onClick configurado.
El parámetro se puede definir usando:
- Cadena de texto (protegida por comillas dobles o simples)
- Variable PHP
- Variable global
- Lang
|
// Definir el texto usando una cadena de texto.
sc_event_hint('nombre_del_campo', 'Haga clic para más información', 100);
// Definir el texto usando una variable PHP.
sc_event_hint('nombre_del_campo', $var_php, 100);
// Definir el texto usando una variable global.
sc_event_hint('nombre_del_campo', [var_global], 100);
// Definir el texto usando una lang de Scriptcase.
sc_event_hint('nombre_del_campo', {lang_nombre}, 100);
|
ancho_máximo |
Parámetro opcional que define el ancho máximo del tooltip donde se mostrará el mensaje. Al alcanzar el límite definido, el texto se dividirá en varias líneas.
El tamaño se define en píxeles y debe contener solo números.
|
// Definir el texto con un límite de ancho.
sc_event_hint('nombre_del_campo', 'Haga clic para más información', 100);
|
Ejemplo de uso
Ejemplo 1: Usando un lang
sc_event_hint("id_cliente", {lang_nombre});
Ejemplo 2: Usando una variable PHP.
$var_msg_help = "Mensaje de ayuda del campo";
sc_event_hint("id_cliente", &var_msg_help );
Ejemplo 3: Con validación
if ( {tipo_persona} == "F" ) {
sc_event_hint(nombre_del_campo,"Persona Física");
} else {
sc_event_hint(nombre_del_campo,"Persona Jurídica");
}
|