4D v20
WP INSERT PICTURE
- 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 INSERT PICTURE
| WP INSERT PICTURE ( objFaixa ; imagem ; modo {; atualizarFaixa} ) | ||||||||
| Parâmetro | Tipo | Descrição | ||||||
| objFaixa | Objeto |
|
objeto Faixa | |||||
| imagem | Imagem |
|
Campo ou variável Imagem, ou rota para o arquivo imagem em disco | |||||
| modo | Inteiro longo |
|
Modo de inserção | |||||
| atualizarFaixa | Inteiro longo |
|
Modo de atualização de Faixa | |||||
O comando WP INSERT PICTURE insere a imagem no objFaixa de acordo com o modo de inserção especificado. A imagem se insertará como um carácter em objFaixa.
Em objFaixa, passe um objeto faixa padrão 4D Write Pro.
- uma range, ou
- um elemento (tabela / fila / parágrafo / corpo / cabeçalho / rodapé / imagem inline / seção/ subseção), ou
- um documento 4D Write Pro.
Em imagem, pode passar:
- seja um campo ou variável imagem 4D,
- ou uma string que contenha uma rota a um arquivo imagem armazenado no disco, expressado utilizando a sintaxe de sistema.
Se utilizar uma string, pode passar uma rota de acesso completa, ou uma rota relativa ao arquivo de estrutura do banco de dados. Também pode passar um nome de arquivo, em cujo caso o arquivo deve estar localizado junto ao arquivo de estrutura do banco de dados. Se passar um nome de arquivo, é necessário indicar a extensão do arquivo.
Todo formato imagem suportado por 4D pode ser utilizado (ver Imagens). Pode obter a lista de formatos imagem disponíveis utilizando o comando PICTURE CODEC LIST. Se a imagem encapsula vários formatos (codecs), 4D Write Pro só mantém um formato para visualizar e um formato para a impressão (se for diferente) no documento; os "melhores" formatos são selecionados automaticamente.
No parâmetro modo, passe uma das seguintes constantes para indicar o modo de inserção a utilizar na imagem no documento:
| Constante | Tipo | Valor | Comentário |
| wk append | Inteiro longo | 2 | Insere conteúdos ao final da faixa e atualiza a faixa para conter tanto os conteúdos anteriores quanto os inseridos. |
| wk prepend | Inteiro longo | 1 | Conteúdos inseridos no início da faixa e atualiza a faixa para conter os conteúdos anteriores e os inseridos |
| wk replace | Inteiro longo | 0 | Substituir e atualizar conteúdos da faixa; a nova faixa contèm os conteúdos inseridos. |
- Se targetObj for uma range, pode usar o parâmetro rangeUpdate para passar uma das constantes abaixo para especificar se a imagem inserida está incluída na range resultante:
Constante Tipo Valor Comentário wk exclude from range Inteiro longo 1 Insere conteùdos ao fim da faixa e atualiza a faixa para menter apenas conteúdos anteriores. wk include in range Inteiro longo 0 Insere conteúdos ao início da faixa e atualiza a faixa para manter apenas conteúdos anteriores
Se não passar um parâmetro rangeUpdate, como padrão a imagem inserida é incluida na range resultado.
- Se targetObj não for uma range, rangeUpdate é ignorada.
No exemplo abaixo, um usuário seleciona a imagem que deseja inserir no objeto de faixa e se lhe avisará se esta imagem não puder ser inserida:
C_OBJECT($wpRange)
$wpRange:=WP Get selection([EXAMPLES]wpDoc)
C_BOOLEAN($fail)
$fail:=False
//pedir ao usuário escolher uma imagem no disco que deseje inserir
$imgRef:=Open document("")
//se o usuário não cancelar
If(OK=1)
//se o arquivo for um arquivo de imagem suportado
If(Is picture file(document))
// insere imagem selecionada pelo usuário
WP INSERT PICTURE($wpRange;document;wk replace)
Else
$fail:=True
End if
Else
$fail:=True
End if
//se a inserção falhar, alerta ao usuário
If($fail)
ALERT("Picture insertion failed")
End if
Produto: 4D
Tema: Linguagem 4D Write Pro
Número
1437
Criado por: 4D v16
Modificado: 4D v17 R5
Referência 4D Write Pro ( 4D v20)
