WP Add picture
WP Add picture ( wpDoc {; picture} ) : Object
WP Add picture ( wpDoc {; picturePath} ) : Object
WP Add picture ( wpDoc {; pictureFileObj} ) : Object
Parâmetro | Tipo | Descrição | |
---|---|---|---|
wpDoc | Object | → | Documento 4D Write Pro |
picture | Imagem | → | Imagem 4D |
picturePath | Text | → | Caminho da imagem |
pictureFileObj | 4D. File | → | Objeto 4D.File representando um arquivo de imagem |
Resultado | Object | ← | Objeto referenciando a imagem |
Descrição
O comando WP Adicionar imagem ancora a imagem passada como parâmetro em um local fixo dentro do wpDoc especificado e retorna sua referência. A referência retornada pode ser passada para o comando WP SET ATTRIBUTES para mover a imagem para qualquer local em wpDoc (página, seção, cabeçalho, rodapé, etc.) com uma camada, tamanho, etc.
Em wpDoc, passe o nome de um objeto documento 4D Write Pro.
Para o segundo parâmetro opcional, você também pode passar:
- Em picture: uma imagem 4D
- Em picturePath: Uma string contendo um caminho para um arquivo de imagem armazenado no disco (sintaxe do sistema). Você pode passar um nome completo ou um nome de caminho relativo ao arquivo de estrutura de 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ê precisará indicar a extensão do arquivo.
- Em PictureFileObj: um objeto
4D.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.
- Se a imagem for omitida, uma referência de imagem válida é retornada, e uma imagem vazia é adicionada. Isto permite que você chame WP SET ATTRIBUTES com o seletor wk image expression para preencher a imagem com uma expressão 4D. Se a expressão não puder ser avaliada ou não retornar uma imagem válida, uma imagem vazia (imagem preta padrão) é exibida.
Por padrão, a imagem adicionada é:
- Incorporado por trás do texto
- Exibido no canto superior esquerdo da caixa de papel
- Exibido em todas as páginas
O local, camada (inline, front-behind de texto), visibilidade e quaisquer propriedades da imagem podem ser modificadas usando o comando WP SET ATTRIBUTES ou através de ações padrão (veja Usando ações 4D Write Pro padrão).
Nota: o comando WP Selection range retorna um objeto referência de imagem se uma imagem ancorada for selecionada e um objeto alcance se uma imagem em linha for selecionada. Você pode determinar se um objeto selecionado é um objeto de imagem verificando o atributo wk type
:
- Value = 2: o objeto selecionado é um objeto imagem.
- Value = 0: o objeto selecionado é um objeto intervalo.
Exemplo 1
Se quiser adicionar uma imagem com configurações padrão usando um caminho de arquivo.
var $obPict : Object
$obPict:=WP Add picture(myDoc;"/PACKAGE/Pictures/Saved Pictures/Sunrise.jpg")
O resultado é:
Exemplo 2
Você quer adicionar uma imagem redimensionada, centralizada e ancorada ao cabeçalho:
var $obImage : Object
var $myPictureFile : 4D.File
$myPictureFile:=File("/PACKAGE/Pictures/Saved Pictures/Sunrise.jpg")
$obImage:=WP Add picture(myDoc;$myPictureFile)
WP SET ATTRIBUTES($obImage;wk anchor origin;wk header box)
WP SET ATTRIBUTES($obImage;wk anchor horizontal align;wk center)
WP SET ATTRIBUTES($obImage;wk anchor vertical align;wk center)
WP SET ATTRIBUTES($obImage;wk width;"650px";wk height;"120px")
O resultado é:
Exemplo 3
Se quiser usar uma expressão de campo para adicionar uma imagem ancorada para um documento que exibe algum texto da base de dados:
QUERY([Flowers];[Flowers]Common_Name="tulip")
WP SET TEXT(myDoc;[Flowers]Description;wk append) //inserir texto
var $obImage : Object
$obImage:=WP Add picture(myDoc)
WP SET ATTRIBUTES($obImage;wk image formula;Formula([Flowers]Image))