4D Doc Center : OBJECT MOVE

4D v14.3

OBJECT MOVE


OBJECT MOVE ( {* ;} objeto ; moverH ; moverV {; redimH {; redimV {; *}}} )

Parâmetro	Tipo	Descrição
*	Operador	se especificado, objeto é um nome de objeto (string), se omitido, objeto é um uma variável
objeto	Objeto de formulário	Nome de objeto (se * é especificado) ou Variável (se * é omitido)
moverH	Inteiro longo	Valor do movimento horizontal do objeto (>0 - para a direita, <0 - para esquerda)
moverV	Inteiro longo	Valor do movimento vertical do objeto (>0 - para baixo, <0 - para cima)
redimH	Inteiro longo	Valor do redimensionamento horizontal do objeto
redimV	Inteiro longo	Valor do redimensionamento vrtical do objeto
*	Operador	se especificado = coordenadas absolutas e se omitido = coordenadas relativas

Descrição

O comando OBJECT MOVE permite mover os objetos no formulário atual, definido pelos parâmetros * e objeto, moveH píxels horizontalmente e moveV píxels verticalmente.

Também é possível (opcionalmente) redimensionar os objetos redimH píxels horizontalmente e redimV píxels verticalmente.

A direção de movimento e redimensionamento depende dos valores passados nos parâmetros moveH e moveV:

Se o valor es positivo, os objetos se movem e redimensionam para direita o para baixo, respectivamente.
Se o valor es negativo, os objetos se movem e redimensionam para esquerda e para cima, respectivamente.

Se passa o parâmetro opcional *, indica que o parâmetro objeto designa o nome de um objeto (uma string). Se não passa o parâmetro *, indica que o parâmetro objeto designa um campo ou uma variável. Neste caso, não passa uma string mas a referência de um campo ou de uma variável (campo ou variável de tipo objeto unicamente).

Se passa um nome de objeto no parâmetro objeto e utiliza o carácter arroba (“@”) para selecionar mais de um objeto, todos os objetos selecionados são movidos ou redimensionados.

Nota: desde a versão 6.5, é possível definir o modo de interpretação do caráctere arroba (“@”), quando se inclui em uma string de caracteres. Esta opção tem um impacto nos comandos “Propriedades dos objetos”. Por favor consulte o .

Automaticamente, os valores moveH, moveV, redimH e redimV modificam as coordenadas do objeto relativamente a sua posição anterior. Se quer que os parâmetros definam as coordenadas absolutas, passe o último parâmetro opcional *.

Este comando funciona nos seguintes contextos:

Formulários de entrada em modo entrada de dados,
Formulários mostrados utilizando o comando DIALOG,
Cabeçalhos e rodapés de página de formulários de saída mostrados pelos comandos MODIFY SELECTION ou DISPLAY SELECTION,
Formulários em curso de impressão.

Exemplo 1

A instrução a seguir move o botão “botão_1” 10 pixels a direita, 20 píxels para cima e aumenta o botão 30 píxels de largura e 40 de altura:

OBJECT MOVE(*;"botão_1";10;-20;30;40)

Exemplo 2

A seguinte instrução move o botão “botão_1” as seguintes coordenadas (10;20) (30;40):

OBJECT MOVE(*;"botão_1";10;20;30;40;*)