Saltar para o conteúdo principal
Versão: Próximo

OBJECT MOVE

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

ParâmetroTipoDescrição
*Operador→se especificado, objeto é um nome de objeto (string), se omitido, objeto é um uma variável
objetoany→Nome de objeto (se * é especificado) ou Variável (se * é omitido)
moverHInteger→Valor do movimento horizontal do objeto (>0 - para a direita, <0 - para esquerda)
moverVInteger→Valor do movimento vertical do objeto (>0 - para baixo, <0 - para cima)
redimHInteger→Valor do redimensionamento horizontal do objeto
redimVInteger→Valor do redimensionamento vrtical do objeto
*Operador→se especificado = coordenadas absolutas e se omitido = coordenadas relativas

Esse comando não é seguro para thread e não pode ser usado em código adequado.

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;*)

Ver também​

OBJECT DUPLICATE
OBJECT GET COORDINATES
OBJECT SET COORDINATES