Gerenciar 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:

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.

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:

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.

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.

(*)Lembre que chamar a um método projeto 4D como uma expressão exibe que o método tenha sido explicitamente permitido de antemão (ver Filtrar expressões contidas em um documento 4D Write Pro).

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 ST INSERT EXPRESSION, deve ser chamada ST COMPUTE EXPRESSIONS 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 ST COMPUTE EXPRESSIONS e ST FREEZE EXPRESSIONS.

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 expression.

Exemplo:

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

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.

Expressões de imagem Inline são adicionadas com o comando ST INSERT EXPRESSION.

Exemplos:

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.

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:

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

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