Texto e Imagen
Ruta de acceso fondo
Define la ruta de la imagen que se dibujará en el fondo del objeto. Si el objeto utiliza un icono con diferentes estados, la imagen de fondo soportará automáticamente el mismo número de estados.
El nombre de la ruta a introducir es similar al de la propiedad Ruta de acceso para las imágenes estáticas.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| customBackgroundPicture | string | Ruta relativa en sintaxis POSIX. Debe utilizarse junto con la opción "Personalizado" de la propiedad "Style". |
Objetos soportados
Botón personalizado - Casilla de selección personalizada - Botón radio personalizado
Estilos de botón
Aspecto general del botón. El estilo del botón también influye en la disponibilidad de ciertas opciones.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| style | text | "regular", "flat", "toolbar", "bevel", "roundedBevel", "gradientBevel", "texturedBevel", "office", "help", "circular", "disclosure", "roundedDisclosure", "custom" |
Objetos soportados
Botón - Botón radio - Casilla de selección - Botón Radio
Margen horizontal
Esta propiedad permite definir el tamaño (en píxeles) de los márgenes horizontales del botón. Este margen delimita el área que el icono del botón y el título no deben sobrepasar.
Este parámetro es útil, por ejemplo, cuando la imagen de fondo contiene bordes:
| Con / Sin | Ejemplo |
|---|---|
| Sin margen |  |
| Con un margen 13 píxeles |  |
Esta propiedad funciona junto con la propiedad Margen vertical.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| customBorderX | number | Para usar con el estilo "personalizado". Mínimo: 0 |
Objetos soportados
Botón personalizado - Casilla de selección personalizada - Botón radio personalizado
Ubicación del icono
Designa la ubicación de un icono en relación con el objeto formulario.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| iconPlacement | string | "none", "left", "right" |
Objetos soportados
Desplazamiento icono
Define un valor de desplazamiento personalizado en píxeles, que se utilizará cuando se haga clic en el botón
El título del botón se desplazará hacia la derecha y hacia la parte inferior por el número de píxeles introducidos. Esto permite aplicar un efecto 3D personalizado cuando se presiona el botón.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| customOffset | number | mínimo: 0 |
Objetos soportados
Botón personalizado - Casilla de selección personalizada - Botón radio personalizado
Número de estados
Esta propiedad define el número exacto de estados presentes en la imagen utilizada como icono para un botón con icono, una casilla de selección o un botón radio personalizado.
La imagen puede contener de 2 a 6 estados.
- 2 estados: false, true
- 3 estados: false, true, rollover,
- 4 estados: false, true, rollover, desactivado,
- 5 estados (sólo para casillas de verificación y botones radio): false, true, rollover false, rollover true, desactivado
- 6 estados (sólo para casillas de verificación y botones radio): false, true, false rollover, true rollover, false desactivado, true desactivado.
- "false" significa botón no presionado/no seleccionado o casilla desmarcada (valor de la variable=0)
- "true" significa botón presionado/seleccionado o casilla marcada (valor de la variable=1)
Cada estado está representado por una imagen diferente. En la imagen fuente, los estados deben apilarse verticalmente:
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| iconFrames | number | Número de estados en la imagen del icono. Mínimo: 1 |
Objetos soportados
Botón (todos los estilos excepto Ayuda) - Casilla de selección - Botón radio
Ruta de acceso de la imagen
Define la ruta de la imagen que se utilizará como icono del objeto.
El nombre de la ruta a introducir es similar al de la propiedad Ruta de acceso para las imágenes estáticas.
Cuando se utiliza como icono de objetos activos, la imagen debe estar diseñada para soportar un número de estados variable.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| icon | picture | Ruta relativa o filesystem en sintaxis POSIX. |
Objetos soportados
Botón (todos los estilos excepto Ayuda) - Casilla de selección - Encabezado List Box - Botón radio
Posición título/imagen
Esta propiedad permite modificar la ubicación relativa del título del botón en relación con el icono asociado. Esta propiedad no tiene efecto cuando el botón sólo contiene un título (sin imagen asociada) o una imagen (sin título). Por defecto, cuando un botón contiene un título y una imagen, el texto se coloca debajo de la imagen.
Aquí están los resultados utilizando las distintas opciones para esta propiedad:
| Option | Descripción | Ejemplo |
|---|---|---|
| Izquierda | El texto se coloca a la izquierda del icono. El contenido del botón se alinea a la derecha. |  |
| Arriba | El texto se coloca debajo del icono. El contenido del botón está centrado. |  |
| Derecha | El texto se coloca a la derecha del icono. El contenido del botón se alinea a la izquierda. |  |
| Abajo | El texto se coloca sobre el icono. El contenido del botón está centrado. |  |
| Centrado | El texto del icono está centrado vertical y horizontalmente en el botón. Este parámetro es útil, por ejemplo, para el texto incluido en un icono. |  |
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| textPlacement | string | "left", "top", "right", "bottom", "center" |
Objetos soportados
Botón (todos los estilos excepto Ayuda) - Casilla de selección - Botón radio
Posición título imagen
Esta propiedad permite definir si el título y la imagen del botón deben estar visualmente contiguos o separados, según las propiedades Posición del título/imagen y Alineación horizontal.
Esta propiedad no tiene efecto cuando el botón sólo contiene un título (sin imagen asociada) o una imagen (sin título).
Por defecto, cuando un botón contiene un título y una imagen, los elementos se unen. El siguiente gráfico muestra el efecto de la propiedad imageHugsTitle (true cuando la propiedad está activada) con diferentes alineaciones de los botones:
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| imageHugsTitle | boolean | true (por defecto), false |
Objetos soportados
Botón (todos los estilos excepto Ayuda) - Casilla de verificación (todos los estilos excepto Regular, Plano, Revelar y Contraer/Expandir) - Botón radio (todos los estilos excepto Regular, Plano, Revelar y Contraer/Expandir).
Margen vertical
Esta propiedad permite definir el tamaño (en píxeles) de los márgenes verticales del botón. Este margen delimita el área que el icono del botón y el título no deben sobrepasar.
Este parámetro es útil, por ejemplo, cuando la imagen de fondo contiene bordes.
Esta propiedad funciona junto con la propiedad Margen horizontal.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| customBorderY | number | Para usar con el estilo "personalizado". Mínimo: 0 |
Objetos soportados
Botón personalizado - Casilla de selección personalizada - Botón radio personalizado
Con menú pop-up
Esta propiedad permite mostrar un símbolo que aparece como un triángulo en el botón para indicar la presencia de un menú emergente adjunto:
La apariencia y ubicación de este símbolo depende del estilo del botón y de la plataforma actual.
Vinculados y separados
Para asociar un símbolo de menú emergente a un botón, hay dos opciones de visualización disponibles:
| Enlazado | Separado |
|---|---|
 |  |
La disponibilidad efectiva de un modo "separado" depende del estilo del botón y de la plataforma.
Cada opción precisa la relación entre el botón y el menú emergente asociado:
- Cuando el menú emergente está separado, al hacer clic en la parte izquierda del botón se ejecuta directamente la acción actual del botón; esta acción puede modificarse mediante el menú emergente accesible en la parte derecha del botón.
- Cuando el menú emergente está vinculado, un simple clic en el botón sólo muestra el menú emergente. Sólo la selección de la acción en el menú emergente provoca su ejecución.
Consulte la descripción del evento On Alternative Click para más información sobre el manejo de eventos en este caso.
Gestión del menú emergente
Es importante señalar que la propiedad "Con menú emergente" sólo gestiona el aspecto gráfico del botón. La visualización del menú emergente y sus valores deben ser manejados enteramente por el desarrollador, particularmente utilizando eventos formulario y los comandos Menú emergente dinámico y Menú emergente.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| popupPlacement | string |
Objetos soportados
Toolbar Button - Bevel Button - Rounded Bevel Button - OS X Gradient Button - OS X Textured Button - Office XP Button - Circle Button - Custom