WP Get range

4D v16

WP Get range


WP Get range ( wpArea ; inicioFaixa ; fimFaixa ) -> Resultado

Parâmetro	Tipo	Descrição
wpArea	Objeto	Objeto variável ou campo 4D Write Pro
inicioFaixa	Inteiro longo	Início offset da faixa de texto
fimFaixa	Inteiro longo	Final offset da faixa texto
Resultado	Objeto	Faixa de objeto

Descrição

O novo comando WP Get range devolve um novo objeto de faixa de texto (objFaixa) que contem a seleção entre faixaInicio e faixaFim na área wpArea 4D Write Pro.

Passe um campo ou variável objeto 4D Write Pro em wpArea. Se não for passada em uma área 4D Write Pro válida no parâmetro wpArea, se devolve um objFaixa vazio.

Em faixaInicio e faixaFim, passe os valores correspondentes a posição dos primeiros e últimos caracteres a selecionar no documento. Pode passar wk start text em faixaInicio
para definir o começo do documento e wk end text em faixaFim para definir o final do documento. Lembre que um documento 4D Write Pro não só contém texto visível, como também as etiquetas de formato que são incluídas na faixa

O comando devolve um novo objFaixa. Um objFaixa é um objeto de faixa texto 4D Write Pro que pode ser utilizada para manejar os atributos de uma seleção de texto (com os novos comandos WP GET ATTRIBUTES e WP SET ATTRIBUTES). Contém 3 atributos de só leitura privados (wk range start, wk range end e wk range owner) que são utilizados para definir a faixa.

Exemplo

Se quiser selecionar uma faixa de 12 caracteres começando desde o principio do campo 4D Write Pro. O campo se mostra em um objeto de formulário:

Se executar:

 $range2:=WP Get range([SAMPLE]WP;wk start text;12)

 WP SELECT(*;"WParea";$range2)

...o resultado é:

Ver também

WP Get selection
WP SELECT