WP INSERT PICTURE

4D v16

WP INSERT PICTURE


WP INSERT PICTURE ( objFaixa ; imagem ; modo {; atualizarFaixa} )

Parâmetro	Tipo	Descrição
objFaixa	Objeto	objeto Faixa
imagem	Imagem, String	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

Descrição

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. Um objFaixa é uma parte de um documento 4D Write Pro; pode ser criado utilizando os comandos , WP Get bookmark range ou WP Get range.

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 Introdução a 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.

No parâmetro actRango opcional, pode passar uma das seguintes constantes para especificar se a imagem inserida está incluida ou não na faixa:

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 actFaixa, como padrão a imagem inserida está incluida na faixa.

Exemplo

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

Ver também

WP INSERT DOCUMENT