Gerenciar Imagens

Página Inicial

4D v19

Referência 4D Write Pro

Gerenciar Imagens

Adicionar imagens

Agregar imagenes a um documento 4D Write Pro pode ser feita de múltiplas maneiras dependendo de suas necessidades:

para agregar uma imagem de fundo, use o atributo wk background image com o comando WP SET ATTRIBUTES
para agregar uma imagem inserida (inline), ou seja, inserida no fluxo de texto como un caractere, use o comando WP INSERT PICTURE ou o comando ST INSERT EXPRESSION
para agregar uma imagem ancorada na página (atrás ou na frente do texto), use WP Add picture e defina o atributo wk anchor layout.

A forma em que agrega uma imagem determina a capa na qual está colocada, como se ilustra no diagrama abaixo:

Imagens de fundo

As imagens podem ser configuradas como fundo dos documentos 4D Write Pro e os elementos de documento (tabelas, parágrafos, seções, cabeçalhos/rodapés de página, etc.).

Aqui há um exemplo que mostra duas maneiras diferentes en que se pode usar uma imagem como fundo de um documento:

As imagens de fundo podem ser definidas por programação ou mediante o menu contextual. Para saber mais, consulte a seção Fundo no artigo Utilizar uma área 4D Write Pro.

Posição e exibição das imagens ancoradas

As imagens ancoradas são agregadas com uma posição absoluta, na frente e atrás do texto, e também são ancoradas a página ou partes específicas de um documento (ou seja, cabeçalho, rodapé, seções). Estabelecer uma posição absoluta para uma imagem se realiza com os comandos WP Add picture e WP SET ATTRIBUTES.

As posições das imagens ancoradas podem ser modificadas com os atributos abaixo específicos ou ações padrão:

Propriedade (constante)	Ação padrão
wk anchor layout	anchorLayout
wk anchor horizontal offset
wk anchor horizontal align	anchorHorizontalAlign
wk anchor vertical offset
wk anchor vertical align	anchorVerticalAlign
wk anchor origin	anchorOrigin
wk anchor page	anchorPage
wk anchor section	anchorSection
	moveToBack
	moveToFront

Todas as imagens ancoradas são mostradas unicamente no modo de visualização de página. Não são mostradas se:

estão ancorados a um cabeçalho ou rodapé que não for visível;
o modo de vista é Rascunho;
estão centradas ou ancoradas em seções e a opção Mostrar HTML WYSIWYG está marcada;
a opção "Mostrar fundo" não está selecionada.

Expressões de Imagem

Pode inserir expressões 4D que devolvam imagens em suas áreas 4D Write Pro. As expressões podem ser variáveis, campos, métodos projeto(*), atributos de objeto ou elementos de coleção.

Pode ver a referência de uma expressão na ponta da imagem (*):

(*)Como não há texto associado com uma imagem ancorada, sua referência de expressão não pode ser mostrada.

Todos os atributos imagem podem ser aplicados a expressões imagem (wk image e os atributos wk image url apenas podem ser lidos). Entretanto, lembre que, dado que as imagens têm atributos específicos, 4D Write Pro deve avaliar a expressão ao menos uma vez para detectar que seu resultado seja uma imagem e manejá-la como uma expressão de imagem. Isto significa que quando for inserida uma expressão de imagem com WP INSERT FORMULA, WP COMPUTE FORMULAS deve ser chamada antes de definir todo atributo imagem.

Se a imagem resultante da expressão não pode ser calculada ou carregada, 4D Write Pro mostra a imagem de marco negro como padrão:

Nota: da mesma forma que com outras expressões, as expressões de imagem também são afetadas pelos comandos WP COMPUTE FORMULAS e WP FREEZE FORMULAS

Imagens ancoradas

As expressões imagem ancoradas são adicioinadas com o comando WP Add picture (sem o segundo parâmetro), seguido de um chamada ao comando WP SET ATTRIBUTEScom o seletor wk image formula

Exemplo:

 obImage:=WP Add picture(myDoc)

 WP SET ATTRIBUTES(obImage;wk image formula;Formula(m_buildPict))

Também pode inserir expressões de imagem usando WP SET ATTRIBUTES e wk image expression em imagens ancoradas existentes.

Nota de compatibilidade: wk image expression ainda pode ser usada para definir as expressões de imagem através de texto. Entretanto é recomendado usar wk image formula e objetos.

Chamar ao comando WP RESET ATTRIBUTES com wk image expression é similar a chamar a ST FREEZE EXPRESSIONS (no documento todo) na qual a expressão é limpada desde o atributo imagem. Entretanto, ST FREEZE EXPRESSIONS calcula a expressão antes de apagar, enquanto WP RESET ATTRIBUTES não faz isso. Se nunca tiver calculado uma expressão, se mostrará a imagem de marco negro pré-determinada.

Inserir expressões de imagem

Expressões de imagem Inline são adicionadas com o comando WP INSERT FORMULA

Exemplos:

  //Insere uma variável de imagem

 WP INSERT FORMULA(wpRange;Formula($vpict);wk prepend)

 

  //Insere um campo

 WP INSERT FORMULA(wpRange;Formula([DOC]SamplePict);wk prepend)

 

  //Insere um método 4D

 WP INSERT FORMULA(wpRange;Formula(M_ComputeChart);wk prepend)

Propriedades de Imagens

Todas as imagens têm propriedades (atributos) como altura, largura, bordas, etc., que podem ser obtidas ou definidas através da linguagem 4D Write Pro (WP GET ATTRIBUTES e WP SET ATTRIBUTES) ou de ações padrão.

a lista completa de propriedades disponíveis para imagens é oferecida na página Atributos 4D Write Pro.
a seção Imagem contém atributos que são específicos das imagens somente.
a página Usando ações padrão também lista as propriedades de imagem disponíveis.

Referência de Imagem ou URL de imagem

Pode trabalhar com referências de imagens (variáveis de imagem, campos, expressões) ou URL de imagens (texto que representa um endereço local ou de rede da imagem).

Dois conjuntos de atributos lhe permitem definir se deseja estabelecer ou obter uma referência de imagem ou uma URL de imagem:

wk image, wk background image, wk list style image: para definir ou obter referências de imagem.
Quando obter uma imagem utilizando um dessos atributos, recebe uma imagem 4D, sem importar como a imagem foi definda.
wk image url, wk background image url, wk list style image url: para definir u obtener URLs de imágenes.
Quando obter uma imagem utilizando um desses atributos, recebe um texto. Se a imagem tiver sido definida através de uma referência (por exemplo, uma variável de imagem), uma URL local é obtida seguido da imagem em Base64.

Exemplo:

 $range:=WP Get selection(WPArea) //obtém a imagem selecionada pelo usuário

 $range:=WP Picture range($range) //cria uma range

 $url:="http://doc.4d.com/image/logo/poweredby4D_web.png"

 

 WP SET ATTRIBUTES($range;wk image;$url) //define uma referência de imagem desde uma URL

 

  //obtém la imagem

 C_PICTURE(vPictureGet)

 WP GET ATTRIBUTES($range;wk image;vPictureGet) //vPictureGet contém uma imagem

 C_TEXT(vPictureURLGet)

 WP GET ATTRIBUTES($range;wk image url;vPictureURLGet) //vPictureURLGet=$url

Recuperar imagens

Os comandos abaixo podem ser usados para devolver imagens:

WP Picture range - aplica so a imagens inseridas inline
WP Selection range - só aplica as imagens selecionadas pelo usuário

Apagando Imagens

Pode remover imagens inline ou ancoradas com:

Ações Mouse/teclado
o comando WP DELETE PICTURE

Ações Mouse/teclado

As imagens podem ser manipuladas com o mouse ou o teclado. As ações disponíveis incluem:

SELECT
- As imagens na capa frontal podem ser selecionadas clicando nelas;
- As imagens de fundo podem ser selecionadas pressionando CTRL + clicando na imagem (Windows) ou COMANDO + clique (Mac);
- Só pode ser selecionada uma única imagem com uma posição absoluta: não é possível a seleção múltipla.

MOVE
- As imagens podem ser movidas e mudar de tamanho com o mouse; (as imagens inline sinderidas não podem ser arrastadas para fora do documento).

INSERT
- Se as imagens com uma posição absoluta são coladas em modo Rascunho, são mostradas inline inseridas no começo da seleção do teclado atual.

CUT/PASTE/COPY
- As imagens podem ser copiadas a área de transferência, ou cortar/colar enquanto são selecionadas.
- Colar uma imagem com uma posição absoluta no modo Página colará a imagem na primeira página selecionada e vai ancorar a essa página, sem importar a configuração de ancoragem da página original; as imagens coladas se manterão seus deslocamentos, a menos que se colem em um modo diferente ao original (por exemplo, se a imagem se copia em modo Página e se cola em modo Aninhado, os deslocamentos são restabelecidos em 0).

DELETE - As imagens podem ser apagadas enquanto são selecionadas com:
- Tecla DELETE, ou
- atalho de teclado para a ação Clear

Ver também

WP Add picture
WP DELETE PICTURE
WP Picture range