Partilhar via


Text Control

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

O método recomendado para exibir um 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\n ou \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 Text. 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 Event.

Identificador de atributo Bit hexadecimal Descrição
Posição Posição do controle na caixa de diálogo. Insira a largura, a altura e as coordenadas do controle ao canto esquerdo do controle nas colunas Width, Height, X e Y da tabela Control ou da tabela BBControl. Use Unidades do instalador para definir o comprimento e a distância.
Texto Texto exibido pelo controle. Para definir a fonte e o estilo da fonte de uma cadeia de texto, acrescente à cadeia de caracteres exibidos o prefixo {\style} ou {&style}. Sendo que Style é 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 de uma instalação. Assine o controle Text no TimeRemaining ControlEvent na tabela Eventmapping e insira TimeRemaining na coluna Attribute.
O instalador publica um registro que contém um inteiro que representa o número de segundos restantes da instalação. Inclua uma linha na tabela UIText com TimeRemaining na coluna Key. Insira uma cadeia de texto formatada na coluna Text criada para exibir os minutos e os segundos. Formate essa cadeia de caracteres conforme descrito para MsiFormatRecord.
Visível 0x00000000 0x00000001
Controle oculto. Controle visível.
Inclua esse bit na palavra de bit da coluna Attributes na tabela Control ou na tabela BBControl para tornar o controle visível ou oculto após a criação.
Você também pode ocultar ou mostrar um controle usando a tabela ControlCondition.
Enabled 0x00000000 0x00000002
Controle em um estado desabilitado. Controle em um estado habilitado.
Inclua esse bit na palavra de bit na coluna Attributes das tabelas Control ou BBControl para habilitar o controle na criação.
Você também pode habilitar ou desabilitar um controle usando a tabela ControlCondition.
Sunken 0x00000000 0x00000004
Exibe o estilo visual padrão. Exibe o controle com uma aparência 3D em baixo-relevo.
Inclua esses bits na palavra de bit da coluna Attributes da tabela Control.
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
Controle opaco. A tela de fundo é mostrada por meio do controle. O controle tem o estilo WS_EX_TRANSPARENT.
Inclua esse bit na coluna Attributes das tabelas Control ou 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 de bit da coluna Attributes das tabelas Control ou BBControl.
NoWrap 0x00000000 0x00040000
Quebras de texto. O texto é exibido em uma só linha. Se o texto se estender para além das margens do controle, ele será recortado e serão inseridas reticências ("…").
Inclua esse bit na palavra de bit da coluna Attributes das tabelas Control ou 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 for definido, o controle tentará formatar o texto exibido como um número que representa uma contagem de bytes. Para a formatação correta, o texto do controle precisa ser definido como uma cadeia de caracteres que representa um número expresso em unidades de 512 bytes. Em seguida, o valor exibido será formatado em termos de KB (quilobytes), MB (megabytes) ou GB (gigabytes) e exibido com a cadeia de caracteres apropriada que representa as unidades.

 

Comentários

Esse controle pode ser criado com base na classe STATIC por meio da função CreateWindowEx. Ele tem os estilos SS_LEFT, WS_CHILD e WS_GROUP.

Não coloque controles Text 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.