Este é o site histórico da documentação 4D. As documentações estão sendo movidas progressivamente para developer.4d.com
- Referência 4D Write Pro
-
- Linguagem 4D Write Pro
- Apresentação
- Criar uma área 4D Write Pro
- Armazenar os documentos 4D Write Pro nos campos objeto 4D
- Utilizar uma área 4D Write Pro
- Imprimir documentos 4D Write Pro
- Gestão de fórmulas
- Importar documentos 4D Write
- Usando ações padrão
- Gerenciar Imagens
- Gerenciar tabelas
- Exportar em formato .docx
- Exportar para formatos HTML e MIME HTMLS
- Exportar para formato SVG
Gerenciar Imagens
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.
A visualização da imagem de fundo também pode se estabelecer por programação ou através do menu contextual. Lembre que os valores do modo de visualização de fundo definem preajustes da configuração de fundo, como se indica na descrição da constante:
Quando se utiliza como valor de wk image display mode, a imagen se alinha na parte superior esquerda da caixa de conteúdo, não se replica, se escala para ajustar-se à caixa de conteúdo e mantém sua relação de aspecto. Quando se utiliza como valor de wk background display mode, preestablece os atributos abaixo: Quando se utiliza como valor de wk image display mode, a imagem se centra na caixa de conteúdo, não se replica, se escala para ajustar-se à caixa de conteúdo e mantém sua relação de aspecto. Quando se utiliza como valor de wk background display mode, preestablece os atributos abaixo: Quando se utiliza como valor de wk image display mode, a imagen se alinha na parte superior esquerda da caixa de conteúdo, se replica e mantém seu tamanho original. Quando se utiliza como valor de wk background display mode, preestablece os atributos abaixo: Quando se utiliza como valor de wk image display mode, a imagem se centra na caixa de conteúdo, se replica e mantém seu tamanho original. Quando se utiliza como valor de wk background display mode, preestablece os atributos abaixo: Quando utiliza como valor de wk image display mode, a imagem se escala para se ajustar à caixa de conteúdo e não se replica. Quando se utiliza como valor de wk background display mode, se modificam os atributos abaixo: Quando for usada como valor de wk image display mode, a imagem se alinha na parte superior esquerda da caixa de conteúdo, não se replica e mantém seu tamanho original. Quando for utilizada como valor de wk background display mode, preestabelece os seguintes atributos: Quando usar como valor de wk image display mode, a imagem se centra na caixa de conteúdo, não se replica, e mantém seu tamanho original. Quando se utiliza como valor de wk background display mode, preestabelece os atributos:
Constante
Comentário
wk proportional
wk proportional centered
wk replicated
wk replicated centered
wk scaled to fit
wk truncated
wk truncated centered
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 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 |
As imagens ancoradas admitem o ajuste automático do texto quando se ancoram a um documento com opções como à esquerda, à direita, por cima ou por baixo, ou ao reder, oferecidas através da propriedade wk anchor layout ou a ação padrão anchorLayout. Leia esta entrada do blog para saber mais.
As imagens com ajuste de texto ancoradas ao corpo da página não afetam o cabeçalho nem ao rodapé (a imagem é mostrada na frente do cabeçalhoo ou do rodapé), do contrário, as imagens ancoradas ao cabeçalho e rodapé afetam ao corpo da página nem se sobrepõe com ele.
Nota: se quiser ancorar uma imagem com ajsute de texto ao cabeçalho ou rodapé, também deve definir o alinhamento vertical da imagem na parte superior.
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.
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.
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
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.
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)Se uma imagem estiver vazia (por exemplo, se não foi carregada, ou é resultado de uma expressão que não pôde ser computada, ou se usa um formato de imagem não compatível) como padrão 4D Write Pro exibe um retângulo negro
Pode remover os retângulos negros da visão atual usando:
- A opção "Mostrar imagens vazias ou não compatíveis" da lista de Propriedades Configurar propriedades de Vista, ou
- o comando WP SET VIEW PROPERTIES com o seletor wk visible empty images ou
- a ação padrão visibleEmptyImage (ver Usando ações padrão).
Também pode usar o seletor wk visible empty images com os comandos WP EXPORT DOCUMENT e WP EXPORT VARIABLE para remover os retângulos negros de conteúdos exportados
Note que quando esta opção for estabelecida, elementos de imagem faltando não serão exibidos mesmo que tenham bordas, altura, largura ou fundo; por isso podem impactar o layout de página para imagens inline.
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 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=$urlOs 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
Pode remover imagens inline ou ancoradas com:
- Ações Mouse/teclado
- o comando WP DELETE PICTURE
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
Produto: 4D
Tema: Gerenciar Imagens
Modificado: 4D v16 R6
Modificado: 4D v18 R2
Modificado: 4D v20 R5
Referência 4D Write Pro ( 4D v20 R7)
