Compartilhar via


Controle de texto

O controle Texto exibe texto estático, que pode usar um estilo predefinido.

O método recomendado para exibir texto com quebras de linha especificadas é usar vários controles de texto de uma linha localizados abaixo uns dos outros. As sequências de caracteres \n, \r\nou \n\r no campo de texto do controle não são exibidas como uma quebra de linha. Essas sequências de caracteres são literalmente exibidas pelo controle.

Atributos de controle

Você pode usar os atributos a seguir com o controle Texto. Para alterar o valor de um atributo usando um evento, assine o controle em um ControlEvent na tabela EventMapping e liste o identificador do atributo na coluna Attribute. Insira o identificador do ControlEvent na coluna Evento.

Identificador de atributo Bit hexadecimal Descrição
de Posição Posição de controle na caixa de diálogo. Insira a largura, a altura e as coordenadas do controle do canto esquerdo do controle nas colunas Width, Height, X e Y da tabela controle ou tabela BBControl. Use unidades do instalador para comprimento e distância.
de Texto Texto exibido pelo controle. Para definir a fonte e o estilo de fonte de uma cadeia de caracteres de texto, prefixe a cadeia de caracteres exibida com {\style} ou {&style}. Onde o estilo é um identificador listado na coluna TextStyle da tabela TextStyle. Se nenhum deles estiver presente, mas a propriedade DefaultUIFont for definida como um estilo de texto válido, essa fonte será usada.
TimeRemaining Esse atributo permite que um controle Text exiba o número aproximado de minutos e segundos restantes para uma instalação. Assine o controle Texto no TimeRemaining ControlEvent na tabela Eventmapping e insira TimeRemaining na coluna Atributo.
O instalador publica um registro que contém um inteiro que representa o número de segundos restantes na instalação. Inclua uma linha na tabela UIText com TimeRemaining na coluna Chave. Insira uma cadeia de caracteres de texto formatada na coluna Texto criada para exibir minutos e segundos. Formate esta cadeia de caracteres conforme descrito para MsiFormatRecord.
Visíveis 0x00000000 0x00000001
Controle oculto. Controle visível.
Inclua esse bit na palavra bit da coluna Atributos na tabela Control ou tabela BBControl.para tornar o controle visível ou oculto na criação.
Você também pode ocultar ou mostrar um controle usando a tabela ControlCondition.
habilitado 0x00000000 0x00000002
Controlar em um estado desabilitado. Controlar em um estado habilitado.
Inclua esse bit na palavra bit na coluna Atributos do Control ou tabelas BBControl para habilitar o controle na criação.
Você também pode habilitar ou desabilitar um controle usando a tabela ControlCondition.
submersa 0x00000000 0x00000004
Exibe o estilo visual padrão. Exibe o controle com uma aparência submersa, 3D.
Inclua esses bits na palavra bit na coluna Atributos da tabela controle .
RTLRO 0x00000000 0x00000020
O texto no controle é exibido na ordem de leitura da esquerda para a direita. O texto no controle é exibido na ordem de leitura da direita para a esquerda.
RightAligned 0x00000000 0x00000040
O texto no controle é alinhado à esquerda. O texto no controle está alinhado à direita.
transparent 0x00000000 0x00010000
Controle opaco. A tela de fundo é exibida por meio do controle. O controle tem o estilo WS_EX_TRANSPARENT.
Inclua esse bit na coluna Atributos do Control ou tabelas BBControl.
NoPrefix 0x00000000 0x00020000
Use & em uma cadeia de caracteres de texto para exibir o próximo caractere conforme sublinhado. O caractere & em uma cadeia de caracteres é exibido como ele mesmo.
Inclua esse bit na palavra bit na coluna Atributos do de Controle ou tabelas BBControl.
NoWrap 0x00000000 0x00040000
Quebras de texto. O texto é exibido em uma única linha. Se o texto se estender além das margens do controle, ele será recortado e uma reticências ("...") será inserida.
Inclua esse bit na palavra bit na coluna Atributos do de Controle ou tabelas BBControl.
UsersLanguage 0x00000000 0x00100000
Fontes criadas na página de código do banco de dados. Fontes criadas na página de código de interface do usuário padrão do usuário.
de atributo de controle formatSize 0x00000000 0x00080000
Formatado como texto. Se esse bit for definido, o controle tentará formatar o texto exibido como um número que representa uma contagem de bytes. Para formatação adequada, o texto do controle deve ser definido como uma cadeia de caracteres que representa um número expresso em unidades de 512 bytes. O valor exibido será formatado em termos de KB (quilobytes), megabytes (MB) ou gigabytes (GB) e exibido com a cadeia de caracteres apropriada que representa as unidades.

 

Observações

Esse controle pode ser criado a partir da classe STATIC usando a função CreateWindowEx. Ele tem os estilos SS_LEFT, WS_CHILDe WS_GROUP.

Não coloque controles de texto transparentes sobre bitmaps coloridos. O texto poderá não estar visível se o usuário alterar o esquema de cores de exibição. Por exemplo, o texto poderá ficar invisível se o usuário definir o parâmetro de alto contraste por motivos de acessibilidade.