Partilhar via


Controle de texto

O controle Text 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 um do outro. 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 seguintes atributos com o controle Text. Para alterar o valor de um atributo usando um evento, inscreva o controle em um ControlEvent na tabela EventMapping e liste o identificador do atributo na coluna Atributo. Insira o identificador do ControlEvent na coluna Evento.

Identificador de atributo Bit hexadecimal Descrição
Posição Posição do controle na caixa de diálogo. Insira a largura, altura e coordenadas do canto esquerdo do controle nas colunas Largura, Altura, X e Y da tabela Control ou tabela BBControl. Use unidades de instalação para comprimento e distância.
de texto Texto exibido pelo controle. Para definir a fonte e o estilo de fonte de uma cadeia de texto, prefixe a cadeia de caracteres exibidos com {\style} ou {&style}. Onde style é um identificador listado na coluna TextStyle da tabela TextStyle. Se nenhum deles estiver presente, mas a propriedadeDefaultUIFontfor 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. Inscreva o controle Text no TimeRemaining ControlEvent na tabela Eventmapping e insira TimeRemaining na coluna Atributo.
O instalador publica um registro contendo 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ível 0x00000000 0x00000001
Controle oculto. Controlo 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 após sua criação.
Você também pode ocultar ou mostrar um controle usando a tabela ControlCondition.
ativado 0x00000000 0x00000002
Controle em um estado desativado. Controle em um estado habilitado.
Inclua esse bit na palavra bit na coluna Atributos do de Controle de ou tabelas BBControl habilitar o controle na criação.
Você também pode habilitar ou desabilitar um controle usando a tabela ControlCondition.
afundado 0x00000000 0x00000004
Exibe o estilo visual padrão. Exibe o controle com uma aparência 3D afundada.
Inclua esses bits na palavra bit na coluna Atributos da tabela Controle de .
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 é alinhado à direita.
transparente 0x00000000 0x00010000
Controlo opaco. O plano de fundo é mostrado através do controle. O controle tem o estilo WS_EX_TRANSPARENT.
Inclua esse bit na coluna Atributos do de Controle de ou tabelas BBControl.
NoPrefix 0x00000000 0x00020000
Use & em uma cadeia de texto para exibir o próximo caractere como sublinhado. O caractere & em uma cadeia de caracteres é exibido como ele mesmo.
Inclua esse bit na palavra bit na coluna Atributos do de Controle de ou tabelas BBControl.
NoWrap 0x00000000 0x00040000
Quebra automática de texto. O texto é exibido em uma única linha. Se o texto se estender além das margens do controle, ele será cortado e uma reticência ("...") será inserida.
Inclua esse bit na palavra bit na coluna Atributos do de Controle de 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 da interface do usuário padrão do usuário.
Atributo de controle FormatSize 0x00000000 0x00080000
Formatado como texto. Se esse bit estiver definido, o controle tentará formatar o texto exibido como um número que representa uma contagem de bytes. Para uma 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 kilobytes (KB), megabytes (MB) ou gigabytes (GB) e exibido com a cadeia de caracteres apropriada representando as unidades.

 

Comentários

Esse controle pode ser criado a partir da classe STATIC usando a funçãoCreateWindowEx. Tem os estilos SS_LEFT, WS_CHILDe WS_GROUP.

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