4D Doc Center : OBJECT Get plain text

4D v13.4

OBJECT Get plain text


OBJECT Get plain text ( {* ;} objeto ) -> Resultado

Parâmetro	Tipo	Descrição
*	Operador	Se especificado, objeto é um nome de objeto (string), se omitido, objeto é uma variável ou campo.
objeto	Objeto de formulário	Nome de objeto (se * é especificado) ou Variável ou campo (se * é omitido)
Resultado	Texto	Texto sem tags

Descrição

O comando OBJECT Get plain text remove as etiquetas de estilo da variável ou campo de texto designado pelos parâmetros * e objeto e devolve o texto plano.

Se passa o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (cadeia). Durante a execução se o objeto tem o foco, o comando devolve informação sobre o objeto que está sendo editado, no entanto, quando o objeto não tem o foco, o comando devolve informação sobre a fonte de dados (campo ou variável) do objeto.

Se omite o parâmetro *, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, passe uma referencia campo ou variável em vez de uma cadeia e durante a execução, o comando devolve informação sobre este campo ou variável.

Exemplo

Você está procurando o texto "muito bem" entre os valores de um campo de texto multiestilo. O valor foi guardado da seguinte forma: "O clima está muito bem hoje".

QUERY BY FORMULA([Comments];OBJECT Get plain text([Comments]Weather)="@muito bem@")

Nota: Neste contexto, a seguinte instrução não dará o resultado desejado porque o texto está guardado com etiquetas de estilo:

QUERY([Comments];[Comments]Weather="@muitobem@")

Variáveis e conjuntos do sistema

Depois de executar este comando, a variável OK toma o valor 1 se não é apresento nenhum erro; do contrário, toma o valor 0. Este é o caso particularmente quando as etiquetas de estilo não são avaliados corretamente (etiquetas incorretas ou faltantes).

No caso de erro, não modifica a variável. Quando ocorre um erro em uma variável quando se está avaliando o texto, 4D transforma o texto em texto plano; como resultado, os caracteres <, > e & são convertidas em entidades HTML.