WP Insert picture
WP Insert picture ( targetObj ; picture ; mode {; rangeUpdate} ): Object
WP Insert picture ( targetObj ; pictureFileObj; mode {; rangeUpdate}): Object
Parâmetro | Tipo | Descrição | |
---|---|---|---|
targetObj | Object | → | Range or element or 4D Write Pro document |
picture | Imagem | → | Campo de imagem ou variável, ou caminho para o arquivo de imagem no disco |
pictureFileObj | 4D. File | → | Um objeto de arquivo representando um arquivo de imagem. |
mode | Integer | → | Modo de inserção |
rangeUpdate | Integer | → | Modo de atualização de intervalo |
Resultado | Object | ← | Object referencing the picture |
Descrição
O comando WP Insert picture insere uma imagem ou um pictureFileObj no targetObj especificado de acordo com os parâmetros modo de inserção passada e rangeUpdate, e retorna uma referência ao elemento imagem. !-- FIM REF--> A imagem será inserida como um caractere no targetObj.
Em targetObj, você pode passar:
- Um intervalo
- Um elemento (tabela / linha / parágrafo / corpo / cabeçalho / rodapé / imagem em linha / seção / subseção)
- Um documento 4D Write Pro
Para o segundo parâmetro, você também pode passar:
- Em picture:
- Um campo de imagem ou variável
- Uma string que contém um caminho para um arquivo de imagem armazenado no disco, na sintaxe do sistema. Se você usar uma string, você poderá passar um nome completo ou um nome de caminho relativo ao arquivo de estrutura do banco de dados. You can also pass a file name, in which case the file must be located next to the database structure file. Se você passar um nome de arquivo, você deve indicar a extensão do arquivo.
- Em pictureFileObj: um objeto
File
que representa um arquivo imagem.
Qualquer formato imagem suportado por 4D pode ser usado. Você pode obter a lista de formatos de imagens disponíveis usando o comando PICTURE CODEC LIST. If the picture encapsulates several formats (codecs), 4D Write Pro only keeps one format for display and one format for printing (if different) in the document; the "best" formats are automatically selected.
No parâmetro modo, passe uma das seguintes constantes para indicar o modo de inserção a ser usado na imagem no documento:
Parâmetros | Tipo | Valor | Comentário |
---|---|---|---|
wk append | Integer | 2 | Insert contents at end of target |
wk prepend | Integer | 1 | Insert contents at beginning of target |
wk replace | Integer | 0 | Replace target contents |
Se targetObj for um intervalo, você poderá usar opcionalmente o parâmetro rangeUpdate para passar uma das seguintes constantes para especificar se a imagem inserida está ou não incluída no intervalo resultante:
Parâmetros | Tipo | Valor | Comentário |
---|---|---|---|
wk exclude from range | Integer | 1 | Imagem não incluída no intervalo atualizado |
wk include in range | Integer | 0 | Imagem incluída no intervalo atualizado (padrão) |
Se você não passar um parâmetro rangeUpdate, por padrão a imagem inserida é incluída no intervalo resultante.
- Se targetObj não for um intervalo, rangeUpdate será ignorado.
Exemplo 1
No exemplo a seguir, um usuário seleciona a imagem que deseja inserir no objeto de intervalo e será avisado se não for possível inserir essa imagem:
var $wpRange : Object
$wpRange:=WP Get selection([EXAMPLES]wpDoc)
var $fail : Boolean
$fail:=False
//ask user to choose a picture on the disk that they want to insert
$imgRef:=Open document("")
//if user does not cancel
If(OK=1)
//if the file is a supported picture file
If(Is picture file(document))
// insert picture selected by user
WP Insert picture($wpRange;document;wk replace)
Else
$fail:=True
End if
Else
$fail:=True
End if
//if the insertion failed, alert the user
If($fail)
ALERT("Picture insertion failed")
End if
Exemplo 2
You want to insert a picture in the body of the documment:
var $file : 4D.File
var $pictRef : Object
$file:=File("/RESOURCES/NovelCover1.jpg")
WParea:=WP New
$pictRef:=WP Insert picture(WParea; $file; wk replace)