4D v14.3

ST Get plain text

Página Inicial

 
4D v14.3
ST Get plain text

ST Get plain text 


 

ST Get plain text ( {* ;} objeto {; refMode} ) -> Resultado 
Parâmetro Tipo   Descrição
Operador in Se especificado, objeto é um nome de objeto (string), se omitido, objeto é uma variável ou campo.
objeto  Objeto de formulário in Nome de objeto (se * é especificado) ou Variável ou campo (se * é omitido)
refMode  Inteiro longo in Mode for handling references found in the text
Resultado  Texto in Texto sem tags

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.

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@")

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"

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.

 
PROPRIEDADES 

Produto: 4D
Tema: Texto multi estilo
Número 1092

Este comando modifica a variável sistema OK

 
HISTÓRIA 

New
Criado por: 4D v12
Modificado: 4D v12.1
Modificado: 4D v14
Renomear: 4D v14

 
VER TAMBÉM 

ST Get text
ST SET PLAIN TEXT
ST SET TEXT
TEXT TO ARRAY

 
PALAVRAS CHAVES 

multi-style, multistyle, multi style

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)

Inherited from : OBJECT Get plain text ( 4D v12.4)