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	→	Intervalo ou elemento ou documento 4D Write Pro
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 à escala
Resultado	Object	←	Objeto referenciando a imagem

Descrição

O comando WP Insert picture insere uma picture ou um pictureFileObj no targetObj de acordo com os parâmetros mode e rangeUpdate , e retorna uma referência ao elemento imagem. 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. Você também pode passar um nome de arquivo, neste caso o arquivo deve estar localizado ao lado do arquivo de estrutura de banco de dados. 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. Se a imagem encapsular vários formatos (codecs), 4D Write Pro apenas mantém um formato para exibição e um formato para impressão (se 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 ser usado na imagem no documento:

Parâmetros	Tipo	Valor	Comentário
wk append	Integer	2	Inserir conteúdo no final do alvo
wk prepend	Integer	1	Inserir conteúdo no início do alvo
wk replace	Integer	0	Replace target contents

Se targetObj é um intervalo, você pode opcionalmente usar o parâmetro rangeUpdate para passar uma das seguintes constantes para especificar se a imagem inserida ou não está incluída no intervalo resultante:

Parâmetros	Tipo	Valor	Comentário
wk exclude from range	Integer	1	Imagem não incluída no intervalo de atualização
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 ele deseja inserir no intervalo e será avisado se esta imagem não puder ser inserida:

 var $wpRange : Object
 $wpRange:=WP Get selection([EXAMPLES]wpDoc)
 
 var $fail : Boolean
 $fail:=False
 
  //pede ao usuário para escolher uma imagem no disco que queiram inserir
 $imgRef:=Open document("")
  //sse usuário não cancelar
 If(OK=1)
  //se o arquivo não for um arquivo de imagem compatível
    If(Is picture file(document))
  // insere imagem selecionado 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, alerteo usuário
 If($fail)
    ALERT("Picture insertion failed")
 End if

Exemplo 2

Você quer inserir uma imagem no corpo da documentação:

var $file : 4D.File
var $pictRef : Object

$file:=File("/RESOURCES/NovelCover1.jpg")

WParea:=WP New
$pictRef:=WP Insert picture(WParea; $file; wk replace)

Veja também

WP Insert document body
WP Picture range