4D v20
WP Get frame
- 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 Bookmark range
- WP COMPUTE FORMULAS
- WP DELETE BOOKMARK
- WP DELETE FOOTER
- WP DELETE HEADER
- WP DELETE PICTURE
- WP DELETE STYLE SHEET
- WP DELETE SUBSECTION
- WP DELETE TEXT BOX
- WP EXPORT DOCUMENTUpd
- WP EXPORT VARIABLEUpd
- WP Find all
- WP Find next
- WP Find previous
- WP FREEZE FORMULAS
- WP GET ATTRIBUTES
- WP Get body
- WP GET BOOKMARKS
- WP Get breaks
- WP Get data context
- WP Get element by ID
- WP Get elements
- WP Get footer
- WP Get formulas
- WP Get frame
- WP Get header
- WP Get links
- WP Get page count
- WP Get position
- WP Get section
- WP Get sections
- WP Get style sheet
- WP Get style sheets
- WP Get subsection
- WP Get text
- WP Get view properties
- WP Import document
- WP IMPORT STYLE SHEETS
- WP INSERT BREAK
- WP INSERT DOCUMENT
- WP INSERT FORMULA
- WP INSERT PICTURE
- WP Insert table
- WP Is font style supported
- WP New
- WP NEW BOOKMARK
- WP New footer
- WP New header
- WP New style sheet
- WP New subsection
- WP New text box
- WP Paragraph range
- WP Picture range
- WP PRINT
- WP RESET ATTRIBUTES
- WP SELECT
- WP Selection range
- WP SET ATTRIBUTES
- WP SET DATA CONTEXT
- WP SET FRAME
- WP SET LINK
- WP SET TEXT
- WP SET VIEW PROPERTIES
- WP Table append row
- WP TABLE DELETE COLUMNS
- WP TABLE DELETE ROWS
- WP Table get cells
- WP Table get columns
- WP Table get rows
- WP Table insert columns
- WP Table insert rows
- WP Table range
- WP Text range
- WP USE PAGE SETUP
- Atributos 4D Write Pro
WP Get frame
| WP Get frame ( {* ;} wpArea {; textBoxID} ) -> 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 * for especificado) ou variável ou campo de objeto 4D Write Pro | |||||
| textBoxID | String |
|
ID of the text box (only filled if a text box has the focus) | |||||
| Resultado | Inteiro longo |
|
o Frame onde o cursor está atualmente estabelecido | |||||
O comando WP Get frame devolve o marco no qual se encontra atualmente o cursor na área 4D Write Pro wpArea.
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 um campo objeto 4D Write Pro.
Nota: Este comando pode ser usado se wpArea for associado com um objeto formulário (ou seja, é exibido no formulário/página atual).
O valor devolvido pode ser comparado com uma das constantes abaixo do tema Constantes 4D Write Pro:
| Constante | Tipo | Valor | Comentário |
| wk body | Inteiro longo | 0 | Body frame da sessão |
| wk current section default footer | Inteiro longo | 10 | Rodapé principal da seção (disponível só se não houver rodapé de sub-seção ativo) |
| wk current section default header | Inteiro longo | 9 | Cabeçalho principal da seção (disponível só se não houver cabeçalho de subseção ativo) |
| wk current section first footer | Inteiro longo | 4 | Rodapé da primeira página da seção |
| wk current section first header | Inteiro longo | 3 | Cabeçalho da primeira página da seção |
| wk current section left footer | Inteiro longo | 6 | Rodapé das páginas esquerdas da seção |
| wk current section left header | Inteiro longo | 5 | Cabeçalho das páginas esquerdas da seção |
| wk current section right footer | Inteiro longo | 8 | Rodapé das páginas direitas da seção |
| wk current section right header | Inteiro longo | 7 | Cabeçalho das páginas direitas da seção |
| wk text box | Inteiro longo | 11 | caixa de texto |
Se o cursor estiver no momento em um elemento caixa de texto, a id do elemento da caixa de texto é devolvida no parâmetro textBoxID. Em todos os outros casos, este parâmetro se devolve vazio.
Se quiser ter certeza de que o usuàrio tenha colocado o cursor em um marco cabeçalho ou rodapé:
var $frameGet Integer</p><p>$frameGet: :=WP Get frame(*;"WParea")
If($frameGet=wk body)|($frameGet=wk text box)
ALERT("Please select a footer or a header.")
End if
Produto: 4D
Tema: Linguagem 4D Write Pro
Número
1519
Criado por: 4D v16 R5
Modificado: 4D v19 R8
Referência 4D Write Pro ( 4D v20)
