4D v17
WP Create range
- Referência 4D Write Pro
-
- Linguagem 4D Write Pro
-
- Sobre objetos 4D Write Pro
- Utilizar os comandos do tema Objeto (Formulários)
- Utilizar os comandos do tema Texto com estilo
- Accessar texto e atributos de imagem por programação
- Constantes 4D Write Pro
- WP Add picture
- WP CREATE BOOKMARK
- WP Create paragraph range
- WP Create picture range
- WP Create range
- WP Create table rangeNew
- WP DELETE BOOKMARK
- WP EXPORT DOCUMENT
- WP EXPORT VARIABLE
- WP GET ATTRIBUTES
- WP Get body
- WP Get bookmark range
- WP GET BOOKMARKS
- WP Get element by IDNew
- WP Get elementsNew
- WP Get footer
- WP Get frame
- WP Get header
- WP Get page count
- WP Get positionNew
- WP Get selection
- WP Get textNew
- WP Import document
- WP INSERT BREAKUpd
- WP INSERT DOCUMENT
- WP INSERT PICTURE
- WP Insert table
- WP Is font style supported
- WP New
- WP PRINT
- WP RESET ATTRIBUTES
- WP SELECT
- WP SET ATTRIBUTES
- WP SET FRAME
- WP SET TEXTNew
- WP Table append row
- WP Table get cellsUpd
- WP Table get columns Upd
- WP Table get rowsUpd
- WP USE PAGE SETUP
- Atributos 4D Write Pro
WP Create range
| WP Create 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 | |||||
WP Create range recebeu o nome WP Get range em versões anteriores de 4D Write Pro. Foi renomeado para maior clareza.
O novo comando WP Create 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.
Um 4D Write Pro objeto de faixa de texto pode ser usado para manejar atributos numa seleção de texto (com os comandos WP GET ATTRIBUTES e WP SET ATTRIBUTES). Para saber mais consulte o parágrafo Comandos de seleção de faixa.
- uma faixa, ou
- um elemento de referência (cabeçalho / rodapé / corpo / tabela / parágrafo / imagem ancorada ou inline), ou
- um documento 4D Write Pro
Se nenhum objeto válido for passado no parâmetro targetObj, uma rangeObj vazia for retornada.
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.
Se passar um objeto de cabeçalho ou rodapé em wpArea, faixaInicio e faixaFim será relativo ao cabeçalho ou rodapé. Por exemplo, se um cabeçalho for passado, , wk start text designa o caractere que inicia o cabeçalho e wk end text o caractere que termina o cabeçalho.
Nota: Se pssar um cabeçalho, rodapé ou referência de corpo em wpArea, a faixa retornada é relativa aos conteúdos de texto do corpo, cabeçalho ou rodapét. O objeto faixa mantém uma referência interna ao copor, cabeçalho ou rodapé pai.
Se executar:
$range2:=WP Get range([SAMPLE]WP;wk start text;12)
WP SELECT(*;"WParea";$range2)...o resultado é:
WP Get body
WP Get bookmark range
WP Get header
WP Get selection
WP SELECT
Produto: 4D
Tema: Linguagem 4D Write Pro
Número
1341
Criado por: 4D v15 R4
Modificado: 4D v16 R5
Renomear: 4D v16 R5
Referência 4D Write Pro ( 4D v17)
