REGION

Icône du lien vers le conceptVoir également Icône du lien vers le conceptExemple

Gère l'affichage sur plusieurs écrans pour le client lourd.

  • Un affichage physique peut être divisé en un certain nombre d'écrans virtuels.
  • Sur les systèmes dotés d'une carte graphique multi-écrans (ou de plusieurs cartes graphiques), chaque région peut être configurée pour apparaître sur un écran physique différent.

Lorsqu'une fenêtre est ouverte sur un système multi-région, la position à laquelle elle s'ouvre est relative à la région sélectionnée.

Support client WebVue - Non applicable. Renvoie un code d'erreur si exécuté dans ce contexte.

Mode

Mnémonique

Syntaxe
1 SETSYSREGION 1
2 GETSYSREGION 2
3 SETREGION 1
4 GETREGION 2
5 SETSELECTION 3
6 GETSELECTION 2
7 GETSELECTIONMODE 2

Syntaxe 1

IntVal = REGION(Mode, Regions);

Type de retour : INTEGER

Argument

Définition

Regions

Nombre de régions (mode 1), ou une région particulière (mode 3). Type INTEGER

Type de retour : INTEGER.

Exécution

Mode

Mnémonique

Action

1

SETSYSREGION

Fixe dynamiquement le nombre de régions de l'écran, de 1 à 4.

3

SETREGION

Définit la région dans laquelle toutes les futures fenêtres ouvertes avec l'animation Chaînage Ouverture apparaîtront.

 

 

Retour : -1 si erreur, OK sinon.

Si vous exécutez un programme à partir d'une animation, vous pouvez obtenir la région dans laquelle se trouve le synoptique en utilisant GETARG("GETREGION")

Dim iRegion As Integer;

iRegion = GETARG("GETREGION");

Region ("SETREGION", iRegion);

Alarmdisplay("ACK_SELECTED", "Alarmwindow", "", "Alarm1");

Lors de l'utilisation de régions multiples, vous devez positionner la région avant l'exécution d'instructions qui interagissent avec l'IHM (WINDOW, ALARMDISPLAY, etc.).

Dim iRegion As Integer;

iRegion = 1;

Region ("SETREGION", iRegion);

Window("OPEN", "Alarmwindow", "");

Syntaxe 2

IntVal = REGION(Mode);

Type de retour : INTEGER.

Exécution

Mode

Mnémonique

Action

2

GETSYSREGION

Retourne la région courante ou -1 en cas d'erreur.

3

GETREGION

Retourne le mode sélection ou -1 en cas d'erreur.

6

GETSELECTION

Retour : -1 si erreur, OK sinon.

7

GETSELECTIONMODE

Retourne le mode sélection ou -1 en cas d'erreur.

Syntaxe 3

IntVal = REGION(Mode, Regions[, SubMode]);

Type de retour : INTEGER.

Argument

Définition

Regions

Nombre de régions. Type INTEGER

SubMode

Tout type numérique.

Exécution

Mode

Mnémonique

Action

5

SETSELECTION

Définit la région dans laquelle toutes les futures fenêtres ouvertes avec l'animation Chaînage Ouverture apparaîtront.

 

 

Le comportement dépend du Sous-Mode comme suit :

0 : la fenêtre est ouverte dans la même région que la fenêtre dans laquelle l'animation Chaînage Ouverture réside.
la fenêtre est toujours ouverte dans la région sélectionnée. La sélection est mémorisée même après que le système soit arrêté et redémarré. C'est l'option par défaut.
2 : la première animation Chaînage Ouverture sélectionnée après l'instruction ouvre la fenêtre dans la région sélectionnée. Par la suite les ouvertures se feront de la même manière que pour le SubMode0.

 

 

Retourne la région sélectionnée ou -1 en cas d'erreur.

Exemple

Pour un exemple, sélectionnez le lien Exemple ci-dessus.