4D Doc Center : ST Get plain text

4D v14.3

ST Get plain text


ST Get plain text ( {* ;} objeto {; refMode} ) -> 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)
refMode	Inteiro longo	Mode for handling references found in the text
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.

O parâmetro opcional modoRef indica a forma em que as referências que se encontram em objeto devem ser devolvidas. Em modoRef, passe uma das seguintes constantes, que se encontram no tema "Texto multi estilo" (pode passar uma só constante ou uma combinação):

Constante	Tipo	Valor	Comentário
ST 4D Expressions as sources	Inteiro longo	2	É devolvida a cadeia original das referências de expressões 4D
ST 4D Expressions as values	Inteiro longo	1	As referências de expressões 4D se devolvem em sua forma avaliada (funcionamento por padrão nos formulários)
ST References as spaces	Inteiro longo	0	Cada referência se devolve como um caractere espaço sem separação (funcionamento por padrão, utilizado pelos outros comandos)
ST Tags as plain text	Inteiro longo	64	O rótulo da etiqueta se devolve em texto plano. Por exemplo para o tag '<img src="test.jpg" alt="picture">my picture</img>', o texto plano é "my picture" (funcionamento por padrão nos formulários)
ST Tags as XML code	Inteiro longo	128	O código XML da etiqueta se devolve em texto plano. Por exemplo para o tag '<img src="test.jpg" alt="picture">my picture</img>', o texto plano é '<img src="test.jpg" alt="picture">my picture</img>'
ST Text displayed with 4D Expression sources	Inteiro longo	86	Devolve o texto tal e como se mostra nos formulários com a cadeia de origem das expressões 4D. Corresponde a combinação pré definida das constantes 2+4+16+64.
ST Text displayed with 4D Expression values	Inteiro longo	85	Devolve o texto tal e como é mostrado nos formulários com as expressões 4D em sua forma avaliada. Corresponde a combinação pré definida das constantes 1+4+16+64.
ST URL as labels	Inteiro longo	4	A etiqueta visível dos URLs se devolve, por exemplo "Visite nosso web site" (funcionamento por padrão nos formulários)
ST URL as links	Inteiro longo	8	É devolvido o link, por exemplo "http://www.4d.com"
ST User links as labels	Inteiro longo	16	É devolvida a etiqueta visível do link usuário (funcionamento por padrão nos formulários)
ST User links as links	Inteiro longo	32	É devolvido o conteúdo do link usuário

Nota: Dado que o texto plano segue sendo o mesmo, independentemente dos valores passados no parâmetro modoRef, o parâmetro modoRef opcional só é útil quando o texto contém referências.

Exemplo 1

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];ST 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@")

Exemplo 2

Dado o seguinte texto localizado na área multi estilo "MyArea":

<span>It is now <span style="-d4-ref:'Current time:C178'"> </span> <a href="http://www.4d.com">Go to the 4D site</a> or <span style="-d4-ref-user:'openW'">Open a window</span></span>

Este texto é mostrado:

É executado o seguinte código:

 $txt :=ST Get plain text(*;"myArea";ST References as spaces)

  // $txt = "agora    ou " (espaços)

 $txt :=ST Get plain text(*;"myArea";ST 4D Expressions as values)

  // $txt = "atualmente 15:48:19  ou  "

 $txt :=ST Get plain text(*;"myArea";ST 4D Expressions as sources)

  // $txt = "é agora a hora atual ou  "

 $txt :=ST Get plain text(*;"myArea";ST URL as links)

  //$txt = "é agora http://www.4d.com or  "

 $txt :=ST Get plain text(*;"myArea";ST Text displayed with 4D Expression values)

  //$txt = "é agora 15:48:19 ir ao site de 4D ou abrir uma janela"

 $txt :=ST Get plain text(*;"myArea";ST Text displayed with 4D Expression sources)

  //$txt = "é atualmente Hora atual ir ao site de 4D ou abrir uma janela"

 $txt :=ST Get plain text(*;"myArea";ST User links as labels)

  //$txt = "é agora ou Abrir uma janela"

 $txt :=ST Get plain text(*;"myArea";ST User links as links)

  //$txt = "é agora ou openW"

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.