WP Get text
WP Get text ( objAlvo {; expressoes} ) -> Resultado
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| objAlvo | Objeto | 🡒 | Range ou elemento ou documento 4D Write Pro |
| expressoes | Número | 🡒 | Instruções para avaliação de expressões |
| Resultado | Texto | 🡐 | Texto do objRange |
Descrição
O comando WP Get text recupera o conteúdo de texto de um documento 4D Write Pro dentro do objRange especificado.
WP Get text só devolve texto sem formato. Todo estilo aplicado (negrito, cursiva, etc.) será ignorado.
No parâmetro objRange, passe um objeto que contenha:
- uma range, ou
- um elemento (tabela / parágrafo / corpo / cabeçalho / rodapé), ou
- um documento 4D Write Pro
Nota:
- Se passar um documento 4D Write Pro em objAlvo, o comando só retorna o texto do elemento corpo do documento
- Se passar uma subseção em objRange, o comando retorna o texto da seção pai.
O parâmetro opcional expressões dá instruções para a avaliação de expresões 4D dentro de objRange.(para saber mais Gestão de fórmulas ). As opções são:
| Constante | Comentário |
|---|---|
| wk expressions as source | É devolvida a string original de referências de expressão 4D. |
| wk expressions as space | Cada referência é devolvida como um caractere de espaço não disruptivo. |
| wk expressions as value | As referências de expressão 4D são devolvidas em seu formulário avaliado. (Como padrão se a opção não for passada). |
Importante: somente o texto sem formato com wk expressions as space é consistente com os índices de range (faixa) de texto utilizados pelos comandos WP ou ST, já que os comandos WP e ST sempre assumem o tamanho de expressão= 1 caractere.
Notas:
- Se objRango contiver imágens, as imagens são ignoradas e devolvidas como caracteres espaciais ("").
- Se objRango contiver tabelas, o conteúdo de cada célula se trata como parágrafos individuais e são devolvidas como texto separado por abas. As filas estão separadas por retornos de carro.
Exemplo
Para recuperar o texto neste documento:
pode escrever:
$range:=WP Text range(myDoc2;wk start text;wk end text)
vText:=WP Get text($range;wk expressions as value) //devolve "Alô mundo! Hoje é: 06/03/18."
vText2:=WP Get text($range;wk expressions as source) //devolve "Alô mundo! Hoje é: Current date."
vText3:=WP Get text($range;wk expressions as space) //devolve "Alô mundo! Hoje é: ."
Ver também
Gestão de fórmulas
WP SET TEXT