4D Doc Center : Séparateurs

4D v14.3

Séparateurs

Utilisation

Un Séparateur divise un formulaire en deux zones. Il permet à l’utilisateur d’agrandir ou de réduire chaque zone en le déplaçant. Un séparateur peut être horizontal ou vertical. Le séparateur tient compte des propriétés de redimensionnement des objets, ce qui permet de personnaliser entièrement l’interface. Un séparateur peut être “pousseur” ou non.

L’utilisation type du séparateur est le formulaire de sortie dans lequel les colonnes peuvent être redimensionnées :

Les caractéristiques générales des séparateurs sont les suivantes :

Vous pouvez placer autant de séparateurs que vous voulez dans tout type de formulaire. De même, il est possible de mêler des séparateurs horizontaux et verticaux dans un même formulaire.
Un séparateur peut traverser un objet. Celui-ci sera redimensionné lors du déplacement du séparateur.
Les butées des séparateurs sont calculées de manière à ce que les objets déplacés restent entièrement visibles dans le formulaire ou ne passent pas sous/à côté d’un autre séparateur. Lorsque la propriété Pousseur est associée à un séparateur, son déplacement vers la droite ou vers le bas ne rencontre pas de butée.
Les redimensionnements effectués dans les formulaires à l’aide des séparateurs ne sont conservés que durant l’affichage du formulaire pour l’utilisateur courant, ils ne sont pas sauvegardés. Une fois le formulaire refermé, les dimensions initiales sont restaurées.

Une fois inséré, un séparateur se présente sous la forme d’un trait. Vous pouvez modifier son style de bordure afin d’obtenir un trait plus ou moins épais, ainsi que sa couleur. Vous pouvez également utiliser comme séparateur un bouton invisible avec l’action standard Séparateur automatique (cf. section Actions standard).

Interaction avec les propriétés des objets environnants

Dans un formulaire, les séparateurs interagissent sur les objets qui les entourent suivant les options de redimensionnement de ces objets :

Options de redimensionnement du ou des objet(s)	Objet(s) au-dessus du séparateur horizontal ou à gauche du séparateur vertical (1)	Objet(s) au-dessous du séparateur horizontal ou à droite du séparateur vertical
		Séparateur non “Pousseur”	Séparateur “Pousseur”
Aucune	restent tel que	sont déplacés avec le séparateur (conservent leur position relative) jusqu’à la butée suivante. La butée du déplacement vers le bas ou vers la droite est soit le bord de la fenêtre, soit un autre séparateur.	sont déplacés sans limites avec le séparateur (conservent leur position relative). Aucune butée n’est appliquée (cf. paragraphe suivant)
Agrandir	gardent leur position d’origine mais sont redimensionnés en fonction de la nouvelle position du séparateur
Déplacer	se déplacent avec le séparateur

(1) Un objet situé à cet emplacement sert de butée en cas de déplacement vers le haut (séparateur horizontal) ou vers la gauche (séparateur vertical) s’il ne comporte aucune option de redimensionnement.

Note : Un objet entièrement contenu dans le rectangle définissant le séparateur est déplacé en même temps que le séparateur lui-même.

Propriété Pousseur

La propriété Pousseur est disponible pour les objets séparateurs dans le thème “Redimensionnement” de la Liste des propriétés. Lorsqu’un objet séparateur dispose de cette propriété, tous les objets situés à sa droite (séparateur vertical) ou au-dessous (séparateur horizontal) sont poussés en même temps que lui, sans aucune butée.

Voici le résultat du déplacement d’un séparateur “pousseur” :

Lorsque cette propriété n’est pas appliquée au séparateur, le résultat est le suivant :

Cette propriété est cochée par défaut pour les nouvelles bases.

Gestion programmée des séparateurs

Vous pouvez associer une méthode objet à un séparateur. Cette méthode sera appelée avec l’événement Sur clic durant tout le déplacement.

Une variable de type Entier long est associée à chaque objet séparateur. Cette variable peut être utilisée dans vos méthodes objet et/ou formulaire. Elle prend pour valeur le déplacement courant, en pixels, du séparateur.

si elle est négative : le déplacement a été effectué vers le haut ou vers la gauche,
si elle est positive : le déplacement a été effectué vers le bas ou vers la droite,
si elle est égale à 0 : le séparateur a été relâché à son emplacement d’origine.

Vous pouvez également déplacer le séparateur par programmation : il suffit de modifier la valeur de la variable associée. Imaginons par exemple qu’un séparateur vertical soit associé à la variable sépara1. Si vous écrivez sépara1:=-10, le séparateur sera déplacé de 10 pixels vers la gauche — comme si l’utilisateur l’avait fait manuellement. Le déplacement s’effectue au terme de l’exécution de la méthode objet ou formulaire contenant l’instruction.

L’action standard Séparateur automatique (cf. section Actions standard), associée à un objet de type Bouton invisible, vous permet de créer des séparateurs personnalisés dans vos formulaires. Pour plus d’informations sur ce type de bouton, reportez-vous à la section Boutons.