4D v20
WP New text box
- 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 New text box
| WP New text box ( wpDoc ; pageNum ) -> Resultado | ||||||||
| Parâmetro | Tipo | Descrição | ||||||
| wpDoc | Objeto |
|
Documento 4D Write Pro | |||||
| pageNum | Número |
|
Número de página onde ancorar a caixa de texto | |||||
| Resultado | Objeto |
|
Objeto caixa de texto | |||||
O comando WP New text box cria e retorna um novo objeto caixa de texto na página pageNum de wpDoc.
Nota: Para saber mais sobre caixas de texto, veja o parágrafo Gerenciar caixas de texto.
No parâmetro wpDoc, passe um documento 4D Write Pro.
Em pageNum, passe o número de página para o qual a caixa de texto deve ser ancorada. Se pageNum < 0 o número de página 1 é usado (não se gera um erro).
O comando cria um novo elemento caixa de texto com os atributos padrão abaixo:
- width = 8 cm,
- height = auto,
- solid black border 1 pt,
- padding = 4 pt,
- margin = 0 pt,
- background color = white,
- id = "textBoxN" onde N é um número,
- ancorado na frente do corpo no canto esquerdo superior do retângulo de página (imagem, uma caixa de texto pode ser ancorada em modo embebido, ou a uma seção, a todas as seções ou uma subseção em modo página e ao fundo ou camada superior)
Ver a seção Atributos 4D Write Pro para descrição detalhada desses atributos. .
A nova caixa de texto é renderizada só na página pageNum, então não pode ser renderizada se:
- não houver página com o número de página passado
- o modo de exibição atual está embebido ou esboço
Entretanto, a caixa de texto ainda existe e é propriedade do documento mesmo se não renderizada.
Se quiser criar uma caixa de texto padrão:
$textBox:=WP New text box(WParea;1)Resultado:
Se quiser adicionar uma caixa de texto em um modelo de carta, para exibir o endereço do destinatário (que está armazenado no contexto):
// #1 create the text box
$textBox:=WP New text box(WParea;1)
// #2 define some text box attributes
WP SET ATTRIBUTES($textBox;wk id;"AddressArea")
WP SET ATTRIBUTES($textBox;wk anchor origin;wk paper box)
WP SET ATTRIBUTES($textBox;wk anchor horizontal align;wk left;wk vertical align;wk top)
WP SET ATTRIBUTES($textBox;wk anchor horizontal offset;$form.offsetX.values[$form.offsetX.index])
WP SET ATTRIBUTES($textBox;wk anchor vertical offset;$form.offsetY.values[$form.offsetY.index])
WP SET ATTRIBUTES($textBox;wk width;$form.width.values[$form.width.index])
WP SET ATTRIBUTES($textBox;wk height;$form.height.values[$form.height.index])
WP SET ATTRIBUTES($textBox;wk padding;$form.padding.values[$form.padding.index]) // margens interiores
WP SET ATTRIBUTES($textBox;wk border style;wk dashed;wk border color;"Blue";wk border width;"1pt";wk border radius;"10pt")
WP SET ATTRIBUTES($textBox;wk vertical align;wk center)
// #3: define as fórmulas dentro da caixa de texto
WP INSERT FORMULA($textBox;Formula(This.data.fullName);wk append)
WP INSERT BREAK($textBox;wk paragraph break;wk append)
WP INSERT FORMULA($textBox;Formula(This.data.fullAddress);wk append)
// #4: Dá estilo ao conteúdo da caixa de texto
WP SET ATTRIBUTES($textBox;wk font;"Arial";wk font bold;wk true;wk font size;"18pt")Result:
Produto: 4D
Tema: Linguagem 4D Write Pro
Número
1797
Criado por: 4D v19 R8
Referência 4D Write Pro ( 4D v20)
