Botones de opción (Cuadro de diálogo de la interfaz de usuario)

Actualización: noviembre 2007

Los cuadros de diálogo Botones de opción se utilizan para presentar al usuario hasta cuatro posibilidades de elección excluyentes entre sí y devolver durante la instalación el valor de la elección seleccionada. Existen tres cuadros de diálogo Botones de opción disponibles: Botones de opción (2 botones), Botones de opción (3 botones) y Botones de opción (4 botones). Estos tres cuadros de diálogo son idénticos, excepto por el número de botones de opción, pero cada uno de ellos sólo puede agregarse una vez a cada proyecto de implementación.

Los cuadros de diálogo contienen dos, tres o cuatro botones de opción con etiquetas asociadas y etiquetas adicionales para presentar información al usuario. El texto de estas etiquetas se determina durante el proceso del diseño en la ventana Propiedades. Existen propiedades adicionales para todos los botones de opción que permiten establecer un valor predeterminado para cada uno de ellos, así como el botón de opción predeterminado.

La ilustración siguiente muestra un cuadro de diálogo Botones de opción (2 botones) típico, tal y como aparecería durante la instalación:

Cuadro de diálogo Botones de opción (2 botones)

Propiedades

Las propiedades siguientes están disponibles para el cuadro de diálogo Botones de opción:

Propiedad

Descripción

BannerBitmap

Especifica la imagen de mapa de bits o JPEG que se mostrará en el área del titular. En la ilustración anterior, se muestra el mapa de bits predeterminado. Para obtener más información, vea BannerBitmap (Propiedad).

BannerText

Determina el texto que se mostrará en el área del titular. En la ilustración anterior, el texto es "Este es el texto del titular".

BodyText

Determina el texto que se mostrará encima de los botones de opción. En la ilustración anterior, el texto es "Este es el texto principal".

Button1Label

Determina el texto que se mostrará junto al primer botón de opción. En la ilustración anterior, el texto es "Primera opción".

Button1Value

Especifica un valor para el primer botón de opción. Se trata del valor que devolverá la propiedad ButtonProperty si se selecciona el primer botón de opción.

Button2Label

Determina el texto que se mostrará junto al segundo botón de opción. En la ilustración anterior, el texto es "Segunda opción".

Button2Value

Especifica un valor para el segundo botón de opción. Se trata del valor que devolverá la propiedad ButtonProperty si se selecciona el segundo botón de opción.

Button3Label

Determina el texto que se mostrará junto al tercer botón de opción. No está disponible para los cuadros de diálogo Botones de opción (2 botones).

Button3Value

Especifica un valor para el tercer botón de opción. Se trata del valor que devolverá la propiedad ButtonProperty si se selecciona el tercer botón de opción. No está disponible para los cuadros de diálogo Botones de opción (2 botones).

Button4Label

Determina el texto que se mostrará junto al cuarto botón de opción. No está disponible para los cuadros de diálogo Botones de opción (2 botones) ni Botones de opción (3 botones).

Button4Value

Especifica un valor para el cuarto botón de opción. Se trata del valor que devolverá la propiedad ButtonProperty si se selecciona el cuarto botón de opción. No está disponible para los cuadros de diálogo Botones de opción (2 botones) ni Botones de opción (3 botones).

ButtonProperty

Determina el nombre de la propiedad usada para recuperar el valor del botón de opción seleccionado. Esta propiedad puede usarse en condiciones. Para obtener más información, vea Implementación condicional.

DefaultValue

Determina qué botón de opción aparecerá seleccionado inicialmente cuando se abra el cuadro de diálogo.

Control de la apariencia del cuadro de diálogo Botones de opción

Varias propiedades controlan el modo en que se le muestra al usuario el cuadro de diálogo Botones de opción durante la instalación.

  • La propiedad BannerBitmap controla la imagen que aparece en la esquina superior derecha del cuadro de diálogo. La posición y el tamaño de la imagen son fijos.

    Sugerencia:

    Para aumentar la coherencia de la interfaz de usuario, debe utilizarse la misma imagen para todos los cuadros de diálogo del instalador.

  • La propiedad BannerText controla el texto que se muestra en el titular situado en la parte superior del cuadro de diálogo. La posición y el tamaño del texto y de la fuente son fijos. El texto se ajustará, pero no puede superar las dos líneas.

  • La propiedad BodyText controla el texto que aparece bajo el titular del cuadro de diálogo. La posición y el tamaño del texto y de la fuente son fijos. El texto se ajustará, pero no puede superar las cuatro líneas.

  • Las propiedades ButtonNLabel controlan el texto de las etiquetas de los botones de opción. La posición y el tamaño de la fuente son fijos, y el texto no se ajustará.

    Sugerencia:

    En los cuadros de diálogo que pueden localizarse, tenga en cuenta el espacio adicional para la expansión del texto. La traducción de una palabra de un idioma puede resultar en una palabra mucho más larga en otro idioma, y el texto puede aparecer cortado.

Recuperar elecciones del usuario con propiedades del cuadro de diálogo Botones de opción

Cuando se ejecuta un instalador con el cuadro de diálogo Botones de opción, el usuario ha de elegir una opción, que, más adelante, puede usarse para controlar otra fase de la instalación.

Por ejemplo, supongamos que crea un cuadro de diálogo Botones de opción (2 botones) que dé al usuario la posibilidad de instalar un archivo opcional. En este caso, la propiedad Button1Label deberá establecerse en "Instalar archivo opcional", mientras que Button2Label en "No instalar archivo opcional". Button1Value y Button2Value, por su parte, se dejarían con sus valores predeterminados de 1 y 2, respectivamente.

Si se cree que los usuarios no querrán instalar el archivo opcional, puede establecerse la propiedad DefaultValue en 2 para que aparezca seleccionada de forma predeterminada.

En el Editor del sistema de archivos, la propiedad Condition del archivo opcional se tendría que establecer en el valor predeterminado de la propiedad ButtonProperty (BUTTON2) más el de la propiedad Button1Value (1): BUTTON2=1.

Durante la instalación, se evaluará la propiedad Condition del archivo. Si el usuario selecciona el primer botón de opción, la propiedad ButtonProperty devolverá el valor Button1Value y el archivo se instalará; de lo contrario, la condición se evaluará como false y el archivo no será instalado.

Vea también

Conceptos

Implementación y la interfaz de usuario en tiempo de ejecución

Restricciones de los cuadros de diálogo de instalación

Otros recursos

Administración de la interfaz de usuario en la implementación

Cuadros de diálogo de implementación