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 | Text | → | Nome de objeto de formulário (se * é especificado) ou variável de objeto 4D Write Pro ou campo (se * for omitido) |
| Resultado | Object | ← | Faixa de objeto |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
comando WP Selection range devolve um novo objeto faixa ou um objeto imagem baseado no conteúdo atualmente selecionado na área wpArea 4D Write Pro.
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")