Cuadros de texto (Cuadro de diálogo de la interfaz de usuario)

Actualización: noviembre 2007

Los cuadros de diálogo Cuadros de texto se utilizan para presentarle al usuario hasta cuatro campos de entrada de texto y devolver el contenido de dichos campos durante la instalación. Existen tres cuadros de diálogo Cuadros de texto disponibles: Cuadros de texto (A), Cuadros de texto (B) y Cuadros de texto (C). Estos tres cuadros de diálogo son idénticos, pero cada uno de ellos sólo puede agregarse una vez a cada proyecto de implementación.

Los cuadros de diálogo contienen cuatro cuadros de texto con etiquetas asociadas y etiquetas adicionales para presentar información al usuario. El texto de estas etiquetas se especifica en tiempo de diseño en la ventana Propiedades. Para controlar la visibilidad de los cuadros de texto, establecer un texto predeterminado y devolver un valor, se proporcionan propiedades adicionales.

La ilustración siguiente muestra un cuadro de diálogo Cuadros de texto típico, tal y como aparecería durante la instalación:

Cuadro de diálogo Cuadros de texto

Propiedades

Las propiedades siguientes están disponibles para el cuadro de diálogo Cuadros de texto:

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 cuadros de texto. En la ilustración anterior, el texto es "Este es el texto principal".

Edit1Label

Determina el texto que se mostrará encima del primer cuadro de texto. En la ilustración anterior, el texto es "Primer campo de entrada".

Edit1Property

Determina el nombre de la propiedad que se usa para recuperar el texto especificado en el primer cuadro de texto. Esta propiedad puede usarse en condiciones. Para obtener más información, vea Implementación condicional.

Edit1Value

Determina el valor inicial (texto) del primer cuadro de texto.

Edit1Visible

Especifica si el primer cuadro de texto se ve o si está oculto. Debe establecerse en true para un cuadro de diálogo que muestra uno o más cuadros de texto.

Edit2Label

Determina el texto que se mostrará encima del segundo cuadro de texto. En la ilustración anterior, el texto es "Segundo campo de entrada".

Edit2Property

Determina el nombre de la propiedad que se usa para recuperar el texto especificado en el segundo cuadro de texto. Esta propiedad puede usarse en condiciones. Para obtener más información, vea Implementación condicional.

Edit2Value

Determina el valor inicial (texto) del segundo cuadro de texto.

Edit2Visible

Especifica si el segundo cuadro de texto se ve o si está oculto. Con cuadros de diálogo que muestren dos o más cuadros de texto, esta propiedad deberá establecerse en true; con cuadros de diálogo que sólo muestren un cuadro de texto, deberá establecerse en false.

Edit3Label

Determina el texto que se mostrará encima del tercer cuadro de texto. En la ilustración anterior, el texto es "Tercer campo de entrada".

Edit3Property

Determina el nombre de la propiedad que se usa para recuperar el texto especificado en el tercer cuadro de texto. Esta propiedad puede usarse en condiciones. Para obtener más información, vea Implementación condicional.

Edit3Value

Determina el valor inicial (texto) del tercer cuadro de texto.

Edit3Visible

Especifica si el tercer cuadro de texto se ve o si está oculto. Con cuadros de diálogo que muestren tres o más cuadros de texto, esta propiedad deberá establecerse en true; con cuadros de diálogo que sólo muestren dos o menos cuadros de texto, deberá establecerse en false.

Edit4Label

Determina el texto que se mostrará encima del cuarto cuadro de texto. En la ilustración anterior, el texto es "Cuarto campo de entrada".

Edit4Property

Determina el nombre de la propiedad que se usa para recuperar el texto especificado en el cuarto cuadro de texto. Esta propiedad puede usarse en condiciones. Para obtener más información, vea Implementación condicional.

Edit4Value

Determina el valor inicial (texto) del cuarto cuadro de texto.

Edit4Visible

Especifica si el cuarto cuadro de texto se ve o si está oculto. Con cuadros de diálogo que muestren cuatro cuadros de texto, esta propiedad deberá establecerse en true; con cuadros de diálogo que sólo muestren tres o menos cuadros de texto, deberá establecerse en false.

Control de la apariencia del cuadro de diálogo Cuadros de texto

Varias propiedades controlan el modo en que aparece el cuadro de diálogo Cuadros de texto ante el usuario durante la instalación:

  • La propiedad BannerBitmap controla la imagen que se muestra 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 se muestra bajo la sección del 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 EditNLabel controlan el texto de las etiquetas de los cuadros de texto. 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 dar lugar a una palabra mucho más larga en otro idioma, y el texto puede aparecer cortado.

Recuperar información del usuario utilizando las propiedades del cuadro de diálogo Cuadros de texto

Cuando se ejecuta un instalador que contiene el cuadro de diálogo Cuadros de texto, el usuario puede escribir información en cualquiera de los cuadros de texto visibles. Puede utilizar esa información más adelante en otra fase de la instalación.

Por ejemplo, podría crear un cuadro de diálogo Cuadros de texto que permitiese al usuario especificar un nombre de grupo de trabajo y almacenarlo en una entrada del Registro. En este caso, debería establecer la propiedad Edit1Label en "Escriba un nombre de grupo de trabajo". Las propiedades Edit2Visible, Edit3Visible y Edit4Visible, por su parte, se establecerían en False, ya que sólo se precisaría un cuadro de texto.

Si piensa que los usuarios van a utilizar mayoritariamente el grupo de trabajo "Predeterminado", puede escribir Predeterminado como valor de la propiedad Edit1Value. De este modo, el usuario verá esta entrada inicialmente en el cuadro de texto.

En el Registro, la propiedad Condition de la entrada de Registro del nombre del grupo de trabajo se establecería en el valor de Edit1Property; por ejemplo, [EDITA1].

Durante la instalación, la propiedad Condition será evaluada. Si el usuario escribe un nombre (o acepta el predeterminado), dicho nombre será agregado al Registro, si deja el cuadro de texto en blanco, no se creará ninguna entrada en el Registro.

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