OverlayIt: ovi_NewWindow

ovi_NewWindow

ovi_NewWindow (left;top;right;bottom;windowLevel;overlayRef) <- errorCode
Parameter		Type	Description
->	left	Numeric	Coordonnée globale gauche de la fenêtre
->	top	Numeric	Coordonnée globale haut de la fenêtre
->	right	Numeric	Coordonnée globale droite de la fenêtre
->	bottom	Numeric	Coordonnée globale bas de la fenêtre
->	windowLevel	Numeric	Niveau de la fenêtre overlay
<-	overlayRef	Long	Référence de la fenêtre overlay
<-	errorCode	Long	Code d'erreur (0 = pas d'erreur)

La routine crée une nouvelle fenêtre de type overlay. Les coordonnées sont exprimées en coordonnées globales par rapport à l’écran. windowLevel est le niveau initial de la fenêtre. Ce paramètre peut être changé plus tard en utilisant la routine ovi_GetSetWindowLevel. Le niveau est un paramètre important. Les valeurs possibles sont :

Valeur	Constante
0	koviLEVEL_Utility
1	koviLEVEL_Toolbar
2	koviLEVEL_Overlay

Le niveau koviLEVEL_Utility est le niveau par defaut. Si vous passez une valeur de constante inconnue, le plugin utilise koviLEVEL_Utility. Voici la conduite pour chaque niveau

koviLEVEL_Utility: la fenêtre overlay est au-dessus des autres fenêtres, y compris des fenêtres qui appartiennent à d’autres applications. Seules la barre menu et les icones du Dock sont au-dessus de la fenêtre. 4D agit comme d’habitude
koviLEVEL_Toolbar: la fenêtre est au-dessus de 4D, mais derrière les fenêtres flottantes et " modales".
koviLEVEL_Overlay: la fenêtre est au-dessus de tout, y compris de la barre menu et les icones du Dock. REMARQUE IMPORTANTE: avec ce niveau, 4D ne répond pas aux évènements évènements souris, évènements clavier, … Ce niveau ne devra être utilisé que temporairement

La fenêtre est invisible au début. Vous pouvez fixer ses paramètres (couleurs, message) et ensuite la rendre visible (ovi_GetSetVisible).
Si la création de la fenêtre a marché overlayRef contient une référence vers la fenêtre, sinon il contient 0. Cette référence doit être utilisée avec toutes les autres routines du plugin. Remarquez qu’elle ne peut pas être utilisée avec les commandes 4D du thème " Windows ", mais que vous pouvez obtenir une référence de fenêtre Mac normale de l’overlay en appelant ovi_GetWindowRef

NOTE TECHNIQUE IMPORTANTE : pour garder trace des fenêtre créées et éviter que 4D ne les ferme autoritairement pour diverses raisons, OverlayIt utilise un process externe lancé au démarrage. Ce process est immédiatement suspendu et n’est réactivé que lorsque l’on quitte 4D. Ainsi, il n’utilise aucun temps CPU, a présence est indécelable. Cela peut être facilement vérifié en créant plusieurs fenêtres, en travaillant pendant quelques temps. En ouvrant l’Explorateur d’Exécution, vous pourrez constater que le temps d’utilisation du process reste à 0.