4D Doc Center : GET OBJECT RECT

4D v14.3

GET OBJECT RECT


GET OBJECT RECT ( {* ;} objeto ; esquerda ; superior ; direita ; inferior )

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 Campo ou Variável (se * é omitido)
esquerda	Inteiro longo	Coordenadas da esquerda do objeto
superior	Inteiro longo	Coordenadas superiores do objeto
direita	Inteiro longo	Coordenada direita do objeto
inferior	Inteiro longo	Coordenadas inferiores do objeto

Descrição

O comando OBJECT GET COORDINATES devolve as coordenadas esquerda, superior, direita e inferior (em pontos) nas variáveis ou campos dos objetos do formulário atual definido pelos parâmetros * e objeto.

Se passa o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (uma string de caracteres). Se não passa o parâmetro opcional *, indica que objeto é um campo ou uma variável. Neste caso, não é passada uma string mas uma 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 caractere arroba (“@”) para selecionar mais de um objeto, as coordenadas devolvidas serão as do retângulo formado por todos os objetos envolvidos.

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

Se o objeto não existe ou se não se chama o comando no contexto de um formulário, as coordenadas retornadas são (0;0;0;0).

Exemplo

Assumamos que quer obter as coordenadas de um retângulo formado por todos os objetos que começam por “botão”:

OBJECT GET COORDINATES(*;"botão@";esquerda;superior;direita;inferior)