Editor de Rich Text

Controle do Editor de rich text em aplicativos Studio Web, incluindo texto de dicas, configurações de conteúdo padrão e casos de uso, como compor conteúdo de e-mail ou marketing.

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 .
• Size - The width and height of the control. By default, the size is set to auto. To set minimum or maximum values, select the three dot icon (...). If the size of the control is smaller than the options, a scroll bar is displayed.
  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