4D v17

WP Get selection

Página Inicial

 
4D v17
WP Get selection

WP Get selection 


 

WP Get selection ( {* ;} wpArea ) -> Resultado 
Parâmetro Tipo   Descrição
Operador in Se especificado, wpArea é um nome de objeto de formulário (string). Se omitido, wpArea é um campo de objeto ou variável
wpArea  String in Nome de objeto de formulário (se * é especificado) ou variável de objeto 4D Write Pro ou campo (se * for omitido)
Resultado  Objeto in Faixa de objeto

O novo comando WP Get selection devolve um novo objeto de faixa de texto (faixaObj) baseado no texto selecionado atualmente na área wpArea de 4D Write Pro.

Se passar o parâmetro opcional *, indica que wpArea é um nome de objeto de formulário (string). Se não passar este parâmetro, indica que wpArea é uma variável ou campo objeto 4D Write Pro. Se não for passada uma área 4D Write Pro no parâmetro wpArea, se devolve uma faixaObj vazio.

Nota: este comando só pode ser utilizada se wpArea estiver associada com um objeto de formulário (ou seja, é mostrada no formulário).

Se for selecionada uma imagem ancorada (imagem em uma localização fixa) em wpArea, WP Get selection devolve um objeto de referência de imagem e não um objeto de faixa (para saber mais, consulte a descrição do comando WP Add picture. Do contrário, WP Get selection  devolve um novo objRange. Para saber mais, consulte Comandos de seleção de faixa.

Exemplo  

Se quiser obter o texto selecionado de uma área 4D Write Pro:

 $range:=WP Get selection(*;"WParea")



Ver também 

WP Create paragraph range
WP Create picture range
WP Create range

 
PROPRIEDADES 

Produto: 4D
Tema: Linguagem 4D Write Pro
Número 1340

 
HISTÓRIA 

Criado por: 4D v15 R4
Modificado: 4D v16 R6

 
ARTICLE USAGE

Referência 4D Write Pro ( 4D v17)