Texto Longo
Um componente Texto Longo tem características similares à Caixa de Texto, porém dá suporte a mais informações, podendo chegar a ter várias linhas listadas nele; por isso é ideal para campos que irão conter textos extensos.
A configuração é bastante simples, basta adicionar o campo a que ele se relaciona em uma determinada tabela e outras configurações mais simples com o título que ele recebe, etc.
Propriedade em comum:
| Propriedade | Descrição | Tipo | Exemplo |
|---|---|---|---|
| Altura | Define a altura do componente | Inteiro | 250 |
| Código | Informa o código gerado pelo Maker ao qual o componente/formulário foi associado. De forma geral, não interfere nas características do componente. | Inteiro | 5 |
| Container | Informa em qual container o componente irá ser inserido. | Indefinido | |
| Dica | Armazena uma dica para o componente, o qual se torna acessível no modo de inserção ou alteração. | Letras | "Digite o CPF do cliente" |
| Habilitado | Torna o componente possível ser editado ou manipulado. | Lógico | Sim |
| PosiçãoX e PosiçãoY | O "X" determina a posição do componente em relação à esquerda do formulário, e o "Y" em relação ao topo. | Inteiro | 100 |
| Tabulação | Indica a ordem de tabulação do componente em relação aos outros que compõem a aba do formulário na qual está posto. Essa ordem pode ser observada quando o usuário altera o estado do formulário/grade para o modo de inclusão ou edição e navega entre os componentes/campos usando a tecla Tab. | Inteiro | 2 |
| Tabular | Selecionando a opção Sim, quando o usuário estiver navegando entre os componentes, como foi descrito no item anterior, o componente receberá foco (observada a ordem de tabulação). | Lógico | Sim |
| Tamanho | Aplicado a todos - determina a largura do componente ou formulário. | Inteiro | 100 |
| Visível | Aplicada a todos os componentes, com exceção da Moldura e do objeto formulário - Selecionando a opção Sim, o componente aparece no formulário. | Lógico | Sim |
| Nome | Aplicada a todos os componentes e para o objeto formulário - apresenta o nome do componente. O Maker sugere um nome diferente dos nomes dos componentes existentes no formulário para evitar que mais de um componente possua o mesmo nome. | Letras | "Tabela de Consumidores" |
| Descrição | Aplicada a todos os componentes exceto para os componentes Árvore, Grade, Moldura, Imagem e para o objeto formulário - É a legenda que aparece sobre o componente para identificar (resumidamente) qual a sua função. Observação: Ao selecionar um determinado campo o Maker irá sugerir uma descrição obtida no dicionários de dados, caso o usuário deseje deixar o campo da descrição em branco basta apagá-lo e clicar fora do componente. | Letras | "Insira aqui a idade do consumidor" |
Propriedades específicas do componente Texto Longo:
| Propriedade | Descrição | Tipo | Exemplo |
|---|---|---|---|
| Texto Rico | Esta propriedade modifica a estrutura do componente, oferecendo o suporte à formatação do texto contido no componente. Contém as seguintes opções: Texto - é mantida a estrutura-padrão do componente; HTML Básico - transforma o componente em uma caixa de texto multilinha; HTML Avançado - adiciona barras de ferramentas de formatação e de suporte à caracteres especiais na parte superior do componente. Sendo assim, é necessário posicionar o componente no formulário de uma maneira que este não se sobreponha a outros que o antecedam, já que será adicionada ao componente uma Barra de ferramentas. | Lista | Texto |
| Quebra Automática | Quando o conteúdo do texto exceder a largura do componente, o texto continua a ser comportado na linha seguinte. Esta propriedade também é aplicada no momento da digitação, ou seja, caso o conteúdo seja extenso, o componente quebrará a linha automaticamente. | Lógico | Sim |
| Tamanho Máximo | Determina o limite de caracteres que podem ser digitados no componente. | Inteiro | 100 |
Propriedade Texto Rico - HTML Básico
O componente Texto Longo possui na propriedade "Texto Rico" o modo HTML Básico. Este modo, permite que algumas funcionalidades sejam implementadas junto ao componente, são elas:
-
- Habilita a edição HTML.
-
- Define a formatação do texto selecionado.
-
- Coloca o texto selecionado como parágrafo.
-
- Coloca o texto selecionado como citação.
-
- Coloca o texto selecionado como título 1.
-
- Coloca o texto selecionado como título 2.
-
- Coloca o texto selecionado como título 3.
-
- Coloca o texto selecionado como título 4.
-
-
- Coloca o texto selecionado em negrito.
-
- Coloca o texto selecionado em Itálico.
-
- Risca o texto selecionado.
-
- Desfaz a última alteração feita.
-
- Refaz a última alteração que foi desfeita.
-
- Coloca o texto selecionado como sobrescrito.
-
- Coloca o texto selecionado como subscrito.
-
- Insere um marcador na linha.
-
- Insere numeração na linha.
-
- Remove a formatação do texto selecionado.
Propriedade Texto Rico - HTML Avançado
O componente Texto Longo possui na propriedade "Texto Rico" o modo HTML Avançado Este modo, permite que algumas funcionalidades sejam implementadas junto ao componente, são elas:
-
- Habilita a edição HTML.
-
- Define a formatação do texto selecionado.
-
- Coloca o texto selecionado como parágrafo.
-
- Coloca o texto selecionado como citação.
-
- Coloca o texto selecionado como título 1.
-
- Coloca o texto selecionado como título 2.
-
- Coloca o texto selecionado como título 3.
-
- Coloca o texto selecionado como título 4.
-
-
- Coloca o texto selecionado em negrito.
-
- Coloca o texto selecionado em Itálico.
-
- Risca o texto selecionado.
-
- Desfaz a última alteração feita.
-
- Refaz a última alteração que foi desfeita.
-
- Coloca o texto selecionado como sobrescrito.
-
- Coloca o texto selecionado como subscrito.
-
- Insere um marcador na linha.
-
- Insere numeração na linha.
-
- Insere/Remove um link no texto selecionado.
-
- Insere uma imagem.
-
Alinha o texto selecionado para a esquerda.
-
Centraliza o texto selecionado.
-
Alinha o texto selecionado para a direita.
-
Enquadra o texto selecionado em suas margens laterais.
-
- Insere um separador horizontal.
-
- Remove a formatação do texto selecionado.
Observações:
-
Caso os eventos Ao Entrar e Ao Navegar contenha uma ação com intuito de alterar, substituir ou desfazer o conteúdo, contido no componente Texto Longo, este com a propriedade HTML Básico ou HTML Avançado, é necessário fazer esta alteração a partir de um fluxo chamado pela função Agendar Execução de Fluxo.
-
Não é possível copiar e colar informações vindas de outro editor de texto (Word, Excel, OpenOffice...) para o componente memo/texto rico. As informações serão de fato salvas no componente e no banco, entretanto, caso tente visualizar as informações no relatório, não serão exibidas corretamente.
-
Sobre o componente texto longo, com a propriedade de HTML avançado, os eventos Ao Modificar e Ao Sair passam a funcionar a partir da versão 2.7.0.20 do Webrun.
- Para se obter o comportamento adequado do evento ao modificar desse componente, o conteúdo deve ser criado e/ou editado no próprio componente, pois, as validações de modificação consistes nas tags HTML predefinidas do componente. Caso o conteúdo seja copiado de outro editor, o evento ao modificar não terá o comportamento correto.