Editor de Rich Text

Use o controle do Editor de rich text para permitir que os usuários componham rich text do seu aplicativo. Esse texto pode ser usado como conteúdo de e-mail, conteúdo de marketing e muito mais.

Tempo de projeto

Geral

• Texto de dica — o texto de ajuda a ser exibido no tempo de execução.
• Texto padrão — o conteúdo padrão a ser exibido no tempo de execução. Se esta propriedade estiver vinculada a uma variável de aplicativo, as alterações feitas no valor padrão não serão propagadas para a variável de aplicativo.
• Rótulo — o texto de exibição do controle.
• Obrigatório — se verdadeiro, os usuários de aplicativos devem fornecer dados no controle. Para marcar o controle como obrigatório no tempo de execução, um asterisco * é adicionado após o texto do rótulo.
• Mensagem de erro personalizada - o texto a ser exibido se a propriedade Obrigatório estiver definida como verdadeira e o controle for deixado vazio.
• Oculto— se verdadeiro, oculta o controle no tempo de execução.
• Somente leitura — se verdadeiro, você não pode adicionar texto no tempo de execução, mas o conteúdo existente é exibido e não pode ser editado.

Events

• Valor alterado — configure o que deve acontecer quando o conteúdo for alterado.

Estilo

• Alinhamento de controle — Por padrão, herda o alinhamento parent. É possível definir outro alinhamento que não o pai. Para voltar ao alinhamento padrão pai, desmarque as opções substituídas.
  Observação:

  O alinhamento depende do layout selecionado para o pai (Vertical vs Horizontal).

• Posicionamento do rótulo — por padrão, o rótulo é definido para ser exibido na parte superior do controle, no lado esquerdo. Você pode colocá-lo à esquerda do controle, na mesma linha. A propriedade Largura do rótulo configura a largura do rótulo e a propriedade Espaço entre define a distância entre o rótulo e o controle.
• Fonte — os atributos de fonte para o texto do rótulo, como família de fontes, tamanho, cor ou estilo (Necessário, Itálico e Sublinhado). Por padrão, o controle herda a família de fontes do contêiner pai imediato, que é indicado pela palavra-chave “herdado”.
• Margem — a margem do controle. Por padrão, uma margem de 4px é definida. As propriedades Top/Bottom e Left/Right são combinadas. Essas propriedades podem ser desanexadas usando o botão Link no lado direito da seção Margem .
• Tamanho — a largura e a altura do controle. Por padrão, o tamanho é definido como auto. Para definir valores mínimos ou máximos, clique no ícone de três pontos (*). Se o tamanho do controle for menor que as opções, será exibida uma barra de rolagem.
  Observação:

  Quando o alinhamento de controle é definido como Esticar e o controle pai é definido como Permitir encapsulamento, o controle do Editor de rich text não é esticado até a altura completa. Para evitar isso, você pode remover o alinhamento Esticar ou fornecer uma altura explícita para o controle.

Propriedades VB

Propriedade do VB	Tipo de dados	Description
Tooltip	String	Texto informativo que aparece quando o usuário passa o mouse sobre o Editor de rich text.
HintText	String	Texto do espaço reservado exibido dentro do Editor de rich text.
Label	String	O rótulo do Editor de rich text, normalmente o texto exibido precedendo o controle.
ReadOnly	Booleano	Se for verdadeiro, o Editor de rich text fica no modo somente leitura no runtime.
Value	String	Valor atualmente selecionado do Editor de rich text.
Required	Booleano	Especifica se o valor do Editor de rich text é obrigatório.
RequiredErrorMessage	String	Mensagem exibida quando o valor do Editor de rich text era exigido mas não foi fornecido.
Hidden	Booleano	Determina a visibilidade do Editor de rich text. Se definido como verdadeiro, oculta o controle no tempo de execução.
Disabled	Booleano	Determina se é possível interagir com o Editor de rich text . Se definido como verdadeiro, desabilita a interação com o Editor de rich text no tempo de execução.
IsValid	Booleano	Verifica a validade do valor do Editor de rich text . Se for verdadeiro, indica que é válido.

Runtime

Visão geral

Use esse controle para compor rich text diretamente do aplicativo no tempo de execução.

Observação:

Se você selecionar a caixa Somente leitura durante o tempo de execução, a interface do Editor de rich text será alterada: os controles de edição são ocultados e você não pode adicionar novo texto ou editar o existente.

Interface

A interface fornece recursos úteis, tais como:

• Estilo de fonte — Personalize a fonte. Você pode escolher entre as seguintes opções:
  • Negrito
  • Itálico
  • Sublinhado
  • Lista com marcadores — criar uma lista com marcadores.
  • Lista numerada — criar uma lista numerada.
  • Tabela — criar uma tabela. Você pode alterar o estilo da tabela (tamanho, alinhamento, cor de fundo e borda) selecionando Propriedades da tabela no menu suspenso.
  • Família da fonte
  • Font size
  • Cor do texto
  • Cor de fundo do texto
• Alinhamento — alinhar o conteúdo do Editor de rich text.
  • Alinhar à esquerda — alinhar o texto com uma borda esquerda.
  • Alinhar à direita — alinhar o texto com uma borda direita.
  • Alinhar no centro — alinhar o texto entre duas bordas.
  • Justificar — aumentar o espaço entre as palavras para preencher toda a linha de modo que o texto fique alinhado com as bordas esquerda e direita.
• Diminuir e Aumentar a indentação — aumentar ou diminuir o espaço entre a margem esquerda e direita de um parágrafo.
• Altura da linha — alterar o espaço entre duas linhas.
• Sobrescrito e Subscrito — formatar o texto de modo que fique um pouco acima (sobrescrito) ou abaixo (subscrito) da linha normal de digitação.
• Limpar formatação — remover toda a formatação em um bloco de texto selecionado, um parágrafo ou o texto inteiro.
• Inserir/editar imagem — inserir uma imagem de um Bucket de armazenamento.
• Blockquote — indicar a citação de uma grande seleção de texto de outra fonte.
• Linha horizontal — inserir uma linha horizontal.
• Inserir/editar link — Inserir ou editar uma URL pública. Você também pode configurar a opção para abrir na mesma janela ou em uma nova janela.
• Desfazer e Refazer — desfazer quaisquer alterações ou refazê-las, se necessário.

Keyboard Shortcuts

Importante:

Atualmente, os atalhos de teclado CTRL+C e CTRL+V não funcionam nas máquinas do Windows para incorporar ou pop-ups de imagem exibidas no controle do Editor de rich text . Use CTRL+SHIFT+C e CTRL+SHIFT+V em vez disso.

Você pode usar os seguintes atalhos de teclado para acessar a barra de ferramentas do controle:

Tarefa	PC (não macOS)	Mac OS
Focar ou pular para a barra de menu	ALT+F9	Option+F9
Focar ou pular para a barra de ferramentas	ALT+F10	Option+F10