Text Control

El control Text muestra texto estático, que podría usar un estilo predefinido.

El método recomendado para mostrar texto con saltos de línea específicos consiste en usar varios controles de texto de una línea situados uno debajo del otro. Las secuencias de caracteres \n, \r\n o \n\r en el campo de texto del control no se muestran como un salto de línea. El control muestra estas secuencias de caracteres de forma literal.

Atributos de control

Puede usar los atributos siguientes con el control Text. Para cambiar el valor de un atributo mediante un evento, suscriba el control a un ControlEvent en la tabla EventMapping y enumere el identificador del atributo en la columna Attribute. Escriba el identificador de ControlEvent en la columna Event.

Identificador de atributo	Bit hexadecimal	Descripción
Posición		Posición del control en el cuadro de diálogo. Escriba el ancho y el alto del control y las coordenadas de la esquina izquierda del control en las columnas Width, Height, X e Y de la tabla Control o de la tabla BBControl. Use unidades del instalador para la longitud y la distancia.
Texto		El texto que muestra el control. Para establecer la fuente y el estilo de fuente de una cadena de texto, escriba {\style} o {&style} antes de la cadena de caracteres mostrados. Donde style es un identificador que aparece en la columna TextStyle de la tabla TextStyle. Si ninguno de estos elementos está presente, pero la propiedad DefaultUIFont está definida como un estilo de texto válido, se usará esa fuente.
TimeRemaining		Este atributo permite que un control Text muestre el número aproximado de minutos y segundos restantes para una instalación. Suscriba el control Text al ControlEvent TimeRemaining en la tabla Eventmapping y escriba TimeRemaining en la columna Attribute. El instalador publica un registro que contiene un entero que representa el número de segundos restantes para la instalación. Incluya una fila en la tabla UIText con TimeRemaining en la columna Key. Escriba una cadena de texto con formato en la columna Text que se ha creado para mostrar minutos y segundos. Dé formato a esta cadena como se describe en MsiFormatRecord.
Visible	0x00000000 0x00000001	Control oculto. Control visible. Incluya este bit en la palabra de bits de la columna Attributes de la tabla Control o de la tabla BBControl para que el control sea visible o esté oculto tras su creación. También se puede ocultar o mostrar un control mediante la tabla ControlCondition.
Enabled	0x00000000 0x00000002	Control en estado deshabilitado. Control en estado habilitado. Incluya este bit en la palabra de bits de la columna Attributes en la tabla Control o la tabla BBControl para habilitar el control al crearlo. También se puede habilitar o deshabilitar un control mediante la tabla ControlCondition.
Sunken	0x00000000 0x00000004	Muestra el estilo visual predeterminado. Muestra el control con un aspecto 3D, con profundidad. Incluya estos bits en la palabra de bit de la columna Attributes de la tabla Control.
RTLRO	0x00000000 0x00000020	El texto del control se muestra en orden de lectura de izquierda a derecha. El texto del control se muestra en orden de lectura de derecha a izquierda.
RightAligned	0x00000000 0x00000040	El texto del control está alineado a la izquierda. El texto del control está alineado a la derecha.
Transparente	0x00000000 0x00010000	Control opaco. El fondo se muestra a través del control. El control tiene el estilo WS_EX_TRANSPARENT. Incluya este bit en la columna Attributes de la tabla Control o la tabla BBControl.
NoPrefix	0x00000000 0x00020000	Use & en una cadena de texto para mostrar el siguiente carácter como subrayado. El carácter & de una cadena se muestra tal como es. Incluya este bit en la palabra de bits de la columna Attributes de la tabla Control o la tabla BBControl.
NoWrap	0x00000000 0x00040000	El texto se ajusta. El texto se muestra en una sola línea. Si el texto se extiende más allá de los márgenes del control, se recorta y se insertan puntos suspensivos ("…"). Incluya este bit en la palabra de bits de la columna Attributes de la tabla Control o la tabla BBControl.
UsersLanguage	0x00000000 0x00100000	Fuentes creadas en la página de códigos de la base de datos. Fuentes creadas en la página de códigos de la interfaz de usuario predeterminada del usuario.
Atributo de control FormatSize	0x00000000 0x00080000	Tiene formato de texto. Si se establece este bit, el control intenta aplicar formato al texto mostrado como un número que representa un recuento de bytes. Para que el formato sea adecuado, el texto del control debe establecerse en una cadena que represente un número expresado en unidades de 512 bytes. Después, se aplicará formato al valor mostrado en términos de kilobytes (KB), megabytes (MB) o gigabytes (GB) y se mostrará con la cadena adecuada que representa las unidades.

 

Comentarios

Este control se puede crear a partir de la clase STATIC mediante la función CreateWindowEx. Tiene los estilos SS_LEFT, WS_CHILD y WS_GROUP.

No coloque controles Text transparentes sobre mapas de bits coloreados. Es posible que el texto no esté visible si el usuario cambia la combinación de colores para mostrar. Por ejemplo, el texto podría volverse invisible si el usuario establece el parámetro de contraste alto por cuestiones de accesibilidad.