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. En general, el icono de un botón incluye cuatro estados: activo, presionado, sobre el ratón e inactivo.
Cada estado está representado por una imagen diferente. En la imagen fuente, los estados deben apilarse verticalmente:
Están representados los siguientes estados:
- botón no presionado / casilla de selección no marcada (valor de la variable=0)
- botón presionado / casilla de selección marcada (valor variable=1)
- pasar por encima
- disabled
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| iconFrames | number | 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
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.
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