Control Imagen

Con este control se puede añadir una imagen en un coach y se puede programar la imagen para que se pueda pulsar en ella utilizando el suceso Al pulsar.

Enlace de datos

Defina o modifique el enlace de datos para el control en la pestaña de propiedades Generales. El control Imagen puede estar vinculado a una variable de tipo Serie que contiene la ubicación de la imagen que tiene que mostrar el control. En general, puede enlazar el control con una imagen almacenada como archivo web y el URL es una vía de acceso relativa para recuperar el archivo del servidor. Cuando enlaza el control con una variable, la variable debe contener un URL que se pueda resolver en el servidor.

Consejo: Los URL absolutos se pueden aceptar, no obstante los URL relativos son en general una mejor opción para evitar avisos de seguridad potenciales.

Puede utilizar el enlace para especificar la imagen. Si no se especifica ningún enlace, se utiliza la propiedad de configuración URL de imagen predeterminado. ara establecer una imagen distinta para diferentes tamaños de pantalla, debe utilizar la propiedad de configuración URL de imagen predeterminado.

Propiedades de configuración

Puede definir o modificar las propiedades de configuración del control, como por ejemplo las propiedades de aspecto y comportamiento, en la pestaña de propiedades de Configuración.

Tamaño de pantalla: Una propiedad de configuración que tenga el icono Tamaños de pantalla además del nombre de propiedad, puede tener distintos valores para cada tamaño de pantalla. Si no define un valor, el tamaño de la pantalla hereda el valor del siguiente tamaño de pantalla más grande como su valor predeterminado. Si está utilizando el editor del escritorio de Process Designer, está estableciendo el valor para el tamaño de pantalla grande. Los otros tamaños de pantalla heredan este valor.

Definiciones de temas: Las definiciones de temas especifican los colores y estilos de un control y determinan el aspecto del control. Puede obtener una vista previa del aspecto de los controles en el editor de temas. Consulte Temas.

En la tabla siguiente se muestran las propiedades de configuración del aspecto para el control Imagen:

Tabla 1. Propiedades de configuración del aspecto para el control Imagen
Propiedad de configuración del aspecto	Descripción	Tipo de datos
Radio de borde	Especifica el radio de la curvatura para una imagen. Puede hacer una imagen perfectamente redonda estableciéndola a al menos la mitad de la anchura especificada para la propiedad Anchura. De forma predeterminada, no hay ningún radio de borde especificado.	`String`
Anchura	Especifica la anchura de una imagen en píxeles, en porcentaje o en unidades em. Por ejemplo, `50px` o `20%` o `0.4em`. Si solo se especifica un número sin especificar unidad, se interpreta que se trata de píxeles. De forma predeterminada, no hay ninguna anchura especificada.	`String`
Altura	Especifica la altura de una imagen en píxeles o en unidades em. Por ejemplo: `50px` o `0.4em`. Si solo se especifica un número sin especificar unidad, se interpreta que se trata de píxeles. De forma predeterminada, no hay ninguna altura especificada.

En la tabla siguiente se muestran las propiedades de configuración del comportamiento del control Imagen:

Tabla 2. Propiedades de configuración del comportamiento del control Imagen
Propiedad de configuración del comportamiento	Descripción	Tipo de datos
Impedir varias pulsaciones	Impide que un usuario pueda pulsar más de una vez en una imagen cuando se ha programado el suceso Al pulsar. De forma predeterminada, esta propiedad no está seleccionada.	`Boolean`
Tipo de URL de imagen	El tipo del URL de imagen: Web Externo Nota: Utilice Externo para imágenes que no estén alojadas en el servidor local.
Acrónimo de aplicación de imagen	El acrónimo de la aplicación de proceso que contiene la imagen. De forma predeterminada, se utiliza el acrónimo de la aplicación de proceso actual.
URL de imagen predeterminado	Si el control no está enlazado, se utiliza este URL. Para establecer una imagen distinta para tamaños de pantalla distintos, debe utilizar esta propiedad. Para utilizar una imagen, debe cargarla en IBM® Process Designer. Consulte Adición de archivos gestionados
Tipo de URL de imagen predeterminado	Si el control no está enlazado, se utiliza este tipo de URL. Web Externo Nota: Utilice Externo para imágenes que no estén alojadas en el servidor local.
Acrónimo aplicación de imagen predeterminado	El acrónimo predeterminado de la aplicación de proceso que contiene la imagen. De forma predeterminada, se utiliza el acrónimo de la aplicación de proceso actual. Si el control no está enlazado, se utiliza el acrónimo que se haya especificado aquí.

Ejemplo

Cargue la imagen que desee utilizar en Process Designer. Consulte Adición de archivos gestionados.

En este ejemplo, el control Imagen se encuentra dentro de un control Diseño vertical, que a su vez está dentro de un control Pozo. En el ejemplo se utilizan las siguientes opciones de configuración:

Tipo de URL de imagen es Web.
URL de imagen predeterminado es magnolia.gif.
Tipo de URL de imagen predeterminado es Web.
Posición de etiqueta es Abajo.
Radio de borde es 50px.
Anchura es 300px.

Al ejecutar el coach, ve lo siguiente:

Image of a gear icon

Sucesos

Establezca o modifique los manejadores de sucesos para el control en la pestañaSucesos. Puede definir que los sucesos se desencadenen mediante programación o cuando el usuario interactúa con el control. Para obtener información sobre cómo definir y codificar sucesos, consulte Sucesos definidos por el usuario.

El control Imagen tiene los siguientes tipos de manejadores de sucesos:

Al cargar: Se activa cuando se carga la página. Por ejemplo:
console.log("Img1 successfully loaded")
Al pulsar: Se activa cuando se pulsa en una imagen, antes de salir de la página. Si la expresión evaluada devuelve false, el clic no activa un suceso de límite. Por ejemplo:
return ${Text1}.isValid();

Métodos

Para obtener información detallada sobre los métodos disponibles para el control Imagen, consulte la documentación de JavaScript.

Recursos adicionales

Para obtener información sobre cómo crear un coach, consulte Creación de coaches.
Para obtener información sobre las propiedades estándar (General, Configuración, Posicionamiento, Visibilidad y Atributos HTML), consulte Propiedades de vista de coach.