4D Doc Center : SET WINDOW RECT

4D v14.3

SET WINDOW RECT


SET WINDOW RECT ( esquerda ; superior ; direita ; inferior {; janela}{; *} )

Parâmetro	Tipo	Descrição
esquerda	Inteiro longo	Coordenada global esquerda da área de conteúdo da janela
superior	Inteiro longo	Coordenada global superior da área de conteúdo da janela
direita	Inteiro longo	Coordenada global direita da área de conteúdo da janela
inferior	Inteiro longo	Coordenada global inferior da área de conteúdo da janela
janela	WinRef	Número de referência da Janela, ou a janela ativa do processo atual, se omitido
*	Operador	Se omitido (padrão) = muda janela para o fundo Se passado = não muda o nível da janela

Descrição

O comando SET WINDOW RECT modifica as coordenadas globais da janela cujo número de referência for passado em janela. Se a janela não existir, o comando não faz nada.

Se omitir o parâmetro janela, SET WINDOW RECT se aplica a janela do primeiro plano do processo atual.

Este comando pode redimensionar e mover a janela, dependendo das novas coordenadas que forem passadas.

As coordenadas devem ser expressas com relação à esquina superior esquerda da área de conteúdo da janela da aplicação (em Windows) ou da tela principal (em Macintosh). As coordenadas indicam o retângulo correspondente à área de conteúdo da janela (excluindo as barras de títulos e as margens).

Aviso: utilize este comando com precaução, poderia mover uma janela mais além dos limites da janela principal (em Windows) ou da tela (em Macintosh). Para evitar isto, utilize comandos como Screen width e Screen height para verificar as novas coordenadas da janela.

Por padrão, executar este comando, automaticamente move a janela designada pelo parâmetro janela ao primeiro plano (se o parâmetro for usado). Você pode desativar isso passando o parâmtero * como o último parâmetro. neste caso, o comando não vai mais mudar o nível original (coordenada "z") da janela.

Este comando não afeta os objetos de formulário. Se a janela contiver um formulário, os objetos do formulário não são movidos ou redimensionados pelo comando (sem importar suas propriedades). Apenas se modifica a janela. Para modificar uma janela de formulário considerando suas propriedades de redimensionamento e os objetos que contém, deve utilizar o comando RESIZE FORM WINDOW.

Exemplo 1

Ver o exemplo do comando WINDOW LIST.

Exemplo 2

Dada a janela abaixo:

Depois da execução da seguinte linha:

SET WINDOW RECT(100;100;300;300)

A janela aparece desta forma: