Saltar al contenido principal
Versión: v20 R4 BETA

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

NombreTipos de datosValores posibles
customBackgroundPicturestringRuta 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

NombreTipos de datosValores posibles
styletext"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 / SinEjemplo
Sin margen
Con un margen 13 píxeles

Esta propiedad funciona junto con la propiedad Margen vertical.

Gramática JSON

NombreTipos de datosValores posibles
customBorderXnumberPara 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

NombreTipos de datosValores posibles
iconPlacementstring"none", "left", "right"

Objetos soportados

Encabezado de list box


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

NombreTipos de datosValores posibles
customOffsetnumbermí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.
nota
  • "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

NombreTipos de datosValores posibles
iconFramesnumberNú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

NombreTipos de datosValores posibles
iconpictureRuta 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:

OptionDescripciónEjemplo
IzquierdaEl texto se coloca a la izquierda del icono. El contenido del botón se alinea a la derecha.
ArribaEl texto se coloca debajo del icono. El contenido del botón está centrado.
DerechaEl texto se coloca a la derecha del icono. El contenido del botón se alinea a la izquierda.
AbajoEl texto se coloca sobre el icono. El contenido del botón está centrado.
CentradoEl 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

NombreTipos de datosValores posibles
textPlacementstring"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

NombreTipos de datosValores posibles
imageHugsTitlebooleantrue (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

NombreTipos de datosValores posibles
customBorderYnumberPara 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:

EnlazadoSeparado

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.
info

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

NombreTipos de datosValores posibles
popupPlacementstring
  • "none"
  • "linked"
  • "separated"
  • Objetos soportados

    Botón barra de herramientas - Botón bisel - Botón de bisel redondeado - Botón OS X Gradient - Botón OS X Textured - Botón Office XP - Botón círculo - Personalizado