WP Selection range

4D v19

WP Selection range


WP Selection range ( {* ;} wpArea ) -> Resultado

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

Compatibilidade

WP Selection range era chamada WP Get selection em versões anteriores de 4D Write Pro. Foi renomeada para ter mais claridade.

Descrição

O novo comando WP Selection range 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 Selection range 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 Selection range 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 Selection range(*;"WParea")

Ver também

WP Paragraph range
WP Picture range
WP Text range