4D v17

Gerenciar Imagens

Página Inicial

 
4D v17
Gerenciar Imagens

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:

Propriedade (constante)Ação padrão
wk anchor layoutanchorLayout
wk anchor horizontal offset
wk anchor horizontal alignanchorHorizontalAlign
wk anchor vertical offset
wk anchor vertical alignanchorVerticalAlign
wk anchor originanchorOrigin
wk anchor pageanchorPage
wk anchor sectionanchorSection
 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.

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:

 $range:=WP Get selection(WPArea) //obtém a imagem selecionada pelo usuário
 $range:=WP Create 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

Os comandos abaixo podem ser usados para  devolver imagens:

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 Create picture range

 
PROPRIEDADES 

Produto: 4D
Tema: Gerenciar Imagens

 
HISTÓRIA 

Modificado: 4D v16 R6

 
ARTICLE USAGE

Referência 4D Write Pro ( 4D v17)