Multiestilo (área Rich text)

4D permite o uso das áreas de texto enriquecido com variações de estilo individuais. Por exemplo, agora é possível ter palavras em negrito e cursiva ou coloridas dentro de uma área de texto:

Esta função se aplica aos campos e variáveis do tipo Alfa e texto, e também as listbox. Tem suporte para formulários página, lista, tanto para visualização quanto para impressão.

Os atributos disponíveis são fonte, tamanho, estilo, cor do texto e (apenas em Windows) cor de fundo. Para modificar os atributos de estilo em uma área de texto enriquecido, há duas possibilidades diferentes:

• Durante a execução, utilize um menu pop up automático (a disponibilidade desse menu se configura na lista de propriedades)
• Por programação, usando o comando OBJECT SET STYLED TEXT ATTRIBUTES.

Nas áreas de texto enriquecido, os atributos de estilo são armazenadoscomo etiquetas HTML de tipo <SPAN>.  Quando são mostradas na área texto, estas etiquetas são interpretadas por 4D. Isto significa que o desenvolvedor pode especificar e modificar os atributos de estilo em um texto por programação. Os atributos <SPAN>; suportados por 4D estão descritos a seguir. O comando OBJECT Get plain text recupera o texto plano sem etiquetas de estilo.

Nota: as áreas de texto enriquecido não são utilizáveis nos seguintes contextos: filtros de entrada, informes rápidos e o editor de etiquetas.

As propriedades de gestão de texto enriquecido estão disponíveis para as variáveis editáveis, os capos e as células de listbox de tipo alfa ou texto.

Esta opção (tema "Texto") ativa a possibilidade de utilizar estilos específicos na área selecionada. Quando esta opção estiver ativa, 4D interpreta as possíveis etiquetas HTML <SPAN> presentes na área.

Por padrão, esta opção não está selecionada.

Esta opção só aparece quando Multiestilo estiver selecionado. Também se encontra no tema "Texto".
Quando esta opção estiver selecionada, a área armazenará as etiquetas de estilo com o texto, inclusive se não tiver feito nenhuma modificação. Neste caso, as etiquetas correspondem ao estilo padrão. Quando esta opção não estiver selecionada, só se guardam as etiquetas de estilo modificadas.

Por exemplo, este é um texto que inclui uma modificação de estilo:

Se a opção "Guardar as etiquetas padrão " não estiver selecionada, a área só guarda a modificação.O conteúdo armazenado é então:

Que <SPAN STYLE="font-size:13.5pt">bonito</SPAN> dia!

Se a opção estiver selecionada, a área guarda toda a informação de formato. Uma primeira etiqueta genérica descreve o estilo por  padrão assim que cada variação é objeto de um par de etiquetas adicionadas. O conteúdo armazenado na área é portanto:

<SPAN STYLE="font-family:'Arial';font-size:9pt;text-align:left;font-weight:normal;font-style:normal;text-decoration:none;color:#000000;background-color:#FFFFFF">Que <SPAN STYLE="font-size:13.5pt">bonito</SPAN> dia!</SPAN>

Esta opção (tema "Entrada") só aparece quando a opção Multiestilo foi selecionada.

A opção Menu contextual ativa para o usuário a possibilidade de chamar durante a entrada de dados a um menu emergente com um clique direito na área. Este menu pop-up oferece comandos padrão de edição de texto (cortar, copiar, colar) assim como também os comandos de modificação de estilo suportados: fonte, tamanho, cor, estilo e (Windows) cor de fundo:

Quando o usuário modifica um atributo de estilo através deste menu emergente, 4D gera o evento de formulário On After Edit.

Notas:

• Também é possível modificar os estilos através do comando OBJECT SET STYLED TEXT ATTRIBUTES. Leve em consideração que neste caso, não se gera nenhum evento formulário.
• O estilo "tachado" não é compatível com Mac OS. Entretanto, a etiqueta correspondente pode ser utilizada por programação.

Os atributos de estilo suportados (fonte, tamanho, estilo e cor) são conservados em caso de arrastar-soltar ou copiar-colar texto com estilo entre:  

• diferentes áreas de texto enriquecido em 4D (variáveis/campos texto e list boxes),
• uma área 4D Write e uma área de texto enriquecido 4D,
• um texto externo com estilo e uma área de texto enriquecido 4D.

Nos outros casos, os estilos se manterão dependendo do contexto.

Os comandos que podem ser utilizados para manipular os objetos texto por programação não aceitam nenhum tipo de etiquetas de estilo integradas ao texto. Atuam sobre o texto mostrado como em versões anteriores de 4D. Se trata dos seguintes comandos:

• Tema Interface de Usuário
  HIGHLIGHT TEXT
  GET HIGHLIGHT

Considere que ao utilizar estes comandos com os comandos que manipulam cadeias de caracteres, é necessário filtrar os caracteres de formato utilizando o comando OBJECT Get plain text:

• Tema Propriedades de Objetos
  Os comandos que podem ser utilizados para modificar o estilo dos objetos (por exemplo, FONT) se aplicam para o objeto todo e não à seleção. Lembre que se o objeto não tem o foco quando se executa o comando, a modificacão se aplica simultaneamente ao objeto (a área de texto) e a sua variável associada. Se o objeto tem o foco, a modificação se realiza no objeto, mas não na variável associada. A modificação só se aplica à variável quando o objeto perde o foco. Lembre este princípio quando programar as áreas de texto. 

Se a opção "Guardar as etiquetas como padrão"  estiver selecionada para o objeto, o uso de estes comandos provocará uma modificação das etiquetas guardadas com cada objeto.

Quando se utiliza com uma área de texto enriquecido, o comando Get edited text (tema Eventos de formulário) devolve o texto da área atual incluindo as possíveis etiquetas de estilo. 

Para recuperar o texto "plano" (texto sem etiquetas) que se está editando, deve utilizar o comando OBJECT Get plain text:

As pesquisas e as ordenações efetuadas entre os objetos multiestilo consideram as possíveis etiquetas de estilo guardadas no objeto. Se uma modificação de estilo foi feita dentro de uma palavra, a pesquisa da palavra não terá sucesso

Para poder efetuar pesquisas e ordenações válidas, deve usar o comando OBJECT Get plain text. Por exemplo:

Este parágrafo lista os atributos das etiquetas <PORT> suportadas por 4D nas áreas de texto enriquecido. Pode utilizar estas etiquetas para implementar uma gestão personalizada de estilos. Só as etiquetas listadas a continuação são suportadas por 4D para as variações de estilo.

<SPAN STYLE="font-family: DESDEMONA"> ... </SPAN>

<SPAN STYLE="font-size: 20pt"> ... </SPAN>

• Negrito
  <SPAN STYLE="font-weight: bold"> ... </SPAN>

• Itálica ou normal
  <SPAN STYLE="font-style: italic"> ... </SPAN>
  <SPAN STYLE="font-style: normal"> ... </SPAN>

• Sublinhado
  <SPAN STYLE="text-decoration: underline"> ... </SPAN>

• Tachado
  <SPAN STYLE="text-decoration:line-through">...</SPAN>
  Nota: O estilo "tachado" não é suportado em Mac OS, mas esta etiqueta pode ser lidada por programação.

<SPAN STYLE="color:green"> ... </SPAN> 
o
<SPAN STYLE="color:#006CCC">...</SPAN>

<SPAN STYLE="background-color:green"> ... </SPAN>
o
<SPAN STYLE="background-color:#006CCC">...</SPAN>

Nota: Em Mac OS, este atributo é ignorado. Se elimina quando o objeto se modifica.

For font color and background color attributes, the color value can be either the hexadecimal code for an RGB color, or the name of one of the 16 HTML colors defined for standard CSS by the W3C: