Separador

4D v20 R7

Separador

Usos

Um separador divide um formulário em duas áreas, permitindo-lhe ao usuário aumentar ou reduzir as áreas movendo o separador. Um separador pode ser horizontal ou vertical. O separador leva em consideração as propriedades de redimensionamento dos objetos, o qual permite personalizar completamente a interface. Um separador pode ou não ser com uma barra de rolagem.

O separador geralmente é utilizado em formulários de saída de modo que as colunas possam ser redimensionadas:

Estas são algumas das características gerais dos separadores:

É possível colocar tantos separadores quanto você quiser em qualquer tipo de formulário e utilizar uma combinação de separadores horizontais e verticais em um mesmo formulário.
Um separador pode cruzar um objeto. Este objeto será redimensionado quando o separador se mova.
Os limites dos separadores são calculados de modo que os objetos que se movem permaneçam completamente visíveis no formulário ou não passem debaixo ou ao lado de outro separador. Quando a propriedade Movimentador estiver associada a um separador, seu movimento para a direita ou para baixo não encontra limites.
Se você redimensionar um formulário utilizando um separador, as novas dimensões do formulário serão salvas enquanto o formulário é exibido. Uma vez que o formulário é fechado, as dimensões iniciais são restauradas.

Uma vez inserido, o separador aparece como uma linha. É possível modificar seu estilo de borda para obter uma linha mais fina ou mudar sua cor. Da mesma forma, é possível utilizar um botão invisível como separador com a ação padrão Separador automático (ver Ações padrões)

Interação com as propriedades dos objetos vizinhos

Em um formulário, os separador interatuam com os objetos que os rodeiam de acordo com as opções de redimensionamento destes objetos.

Opções de redimensionamento dos objetos	Objeto(s) sobre o separador horizontal ou à direita do separador vertical (1)	Objeto(s) abaixo do separador horizontal ou à direita do separador vertical
		separador no “Impulsor”	separador “Impulsor”
Nenhum	Permanece como está	se movem com o separador (conservam sua posição relativa) até o próximo limite. O limite, quando se movem para baixo ou para direita, é a margem da janela ou outro separador.	se movem com o separador (conservam sua posição relativa) indefinidamente. Não se aplicam limites (ver o próximo parágrafo)
Aumentar	Mantém sua posição original mas são redimensionados de acordo com a nova posição do separador
Mover	Se movem com o separador

(1) Não é possível arrastar o separador além do lado direito (horizontal) ou inferior (vertical) de um objeto localizado nesta posição.

Nota: Um objeto completamente dentro de um retângulo que define o separador se move ao mesmo tempo que o separador.

Propriedade Impulsor

A propriedade Impulsor está disponível para os objetos separadores no tema “Opções de redimensionamento” da lista de propriedades.
Quando um objeto separador tem esta propriedade, todos os objetos situados à direita (separador vertical) ou abaixo (separador horizontal) são movidos ao mesmo tempo que o separador, sem limite.

Este é o resultado da rolagem de separador “impulsor”:

Quando esta propriedade não se aplica aos separadores, o resultado é o seguinte:

Esta propriedad está selecionada como padrão para os novos bancos.

Lidar com os separadores usando programação

É possível associar um método de objeto a um separador. Este método será chamado pelo evento On Clicked durante toda a rolagem.

Uma variável de tipo Inteiro longo está associada a cada separador. Esta variável pode ser utilizada em seus métodos de objeto e/ou formulário. Seu valor indica a posição atual do separador, em pixels, relativo a sua posição inicial.

Se o valor for negativo: o separador foi movido para cima ou para a esquerda.
Se o valor for positivo: o separador foi movido para baixo ou para a direita,
Se o valor for igual a 0: o separador foi movido a sua posição inicial.

Da mesma forma é possível mover o separador por programação: você só tem que definir o valor da variável associada. Por exemplo, se um separador vertical está associado à variável separa1 e você executa a seguinte declaração: separa1 := -10, o separador se moverá 10 pixels à esquerda, como se o usuário o fizesse manualmente.

A movimentação é efetuada ao final da execução do método de objeto ou de formulário que contenha a instrução. A ação Separador automático permite criar separadores personalizados em seus formulários. É possível atribuir esta ação a um objeto de tipo botão invisível. Quando se atribui esta ação padrão a um botão invisível, o botão atua exatamente como um separador. Se, por exemplo, você cola uma imagem no botão invisível, é possível criar uma interface personalizada para seus separadores. Para maiores informações, consulte o parágrafo Botões.