[[ags|{{:contents.gif}}]] [[ags28#topic39|{{:up.gif}}]] [[ags54#GUIFuncsAndProps|{{:back.gif}}]] [[ags56#topic53|{{:forward.gif}}]] ---- =====Fonctions et propriétés des contrôles de GUI (GUI control)===== Cette section liste les fonctions et propriétés communes à tous les types de contrôles GUI. Chaque type de contrôle (Button, ListBox, etc.) possède également sa section spécifique.\\ \\ ---- ====GetAtScreenXY (GUI control)==== // (Anciennement GetGUIObjectAt, désormais obsolète) // \\ \\ static GUIControl* GUIControl.GetAtScreenXY(int x, int y) Vérifie s'il y a un contrôle GUI aux coordonnées (X,Y) de l'écran. Retourne l'objet contrôle s'il y en a un, ou //null// sinon. Vous voudrez probablement utiliser cette fonction avec GetGUIAtLocation.\\ \\ Exemple : GUIControl *leControle = GUIControl.GetAtScreenXY(mouse.x, mouse.y); if (leControle == lstPartiesSauvees) { Display("La souris survole la liste Parties Sauvées."); } else if (leControle == null) { Display("La souris ne survole pas de contrôle."); } else { GUI *surGui = leControle.OwningGUI; Display("La souris survole le contrôle numéro %d du GUI numéro %d.", theControl.ID, onGui.ID); } affichera le contrôle que survole la souris.\\ \\ // Voir aussi : // [[ags54#GUI.GetAtScreenXY|GUI.GetAtScreenXY]]\\ \\ ---- ====AsType properties (GUI controls)==== Button* GUIControl.AsButton; InvWindow* GUIControl.AsInvWindow; Label* GUIControl.AsLabel; ListBox* GUIControl.AsListBox; Slider* GUIControl.AsSlider; TextBox* GUIControl.AsTextBox; Convertie un pointeur GUIControl* générique en une variable du type correct, et la retourne. Si le contrôle n'est pas du type requis, retourne //null//.\\ \\ Exemple : Button *leBouton = gBarreIcones.Controls[2].AsButton; if (leBouton == null) { Display("Le contrôle 2 n'est pas un bouton !!!!"); } else { leButton.NormalGraphic = 44; } tentera d'attribuer la sprite 44 comme NormalGraphic au Bouton 2 du GUI BarreIcones, mais si ce n'est en fait pas un bouton, affichera une image.\\ \\ // Voir aussi : // [[ags54#GUI.Controls|GUI.Controls]]\\ \\ ---- ====BringToFront (GUI controls)==== GUIControl.BringToFront() Place le contrôle au-dessus de tous les autres. Ceci vous permet de réarranger l'ordre d'affichage des contrôle dans le GUI.\\ \\ ** S'applique à ** \\ \\ Hérité par Button, InvWindow, Label, ListBox, Slider and TextBox.\\ \\ Exemple : btnGrosBouton.BringToFront(); placera le bouton // btnGrosBouton // au-dessus de tous les autres contrôle du GUI.\\ \\ // Voir aussi : // [[ags55#SendToBack|GUIControl.SendToBack]]\\ \\ ---- ====Clickable property (GUI controls)==== bool GUIControl.Clickable Retourne/Définit si l'on peut cliquer sur le contrôle du GUI.\\ \\ Cette propriété détermine si le joueur peut cliquer avec la souris sur le contrôle. Si elle est définie à //false//, alors tout clic de souris traversera le contrôle pour trouver se qui se trouve derrière. Contrairement à la propriété Enabled (//Activé//), donner false à Clickable n'altère pas l'apparence du contrôle.\\ \\ Notez que désactiver le contrôle en définissant Enabled à false remplace ce réglage -- c'est-à-dire que si Enabled vaut false, alors le joueur ne pourra pas cliquer sur le contrôle, indépendamment du réglage de la propriété //Clickable//.\\ \\ Gardez aussi à l'esprit que si vous donnez false à //Clickable// alors, s'il y a un contrôle derrière celui-ci, c'est lui qui sera activé par le clic. D'autre part, si //Enabled// vaut false alors le contrôle "absorbe" le clic de la souris et rien ne se passe.\\ \\ ** S'applique à ** \\ \\ Hérité par Button, InvWindow, Label, ListBox, Slider and TextBox.\\ \\ Exemple : btnSauverPartie.Clickable = false; rendra le bouton //btnSauverPartie// non-cliquable.\\ \\ // Voir aussi : // [[ags55#Enabled|GUIControl.Enabled]]\\ \\ ---- ====Enabled property (GUI controls)==== // (Anciennement SetGUIObjectEnabled, désormais obsolète) // \\ \\ bool GUIControl.Enabled Active ou désactive le contrôle de GUI.\\ \\ Normalement, vous vos contrôles de GUI (boutons, ascenseurs, etc.) sont activés en permanence sauf lors d'une cutscene (//cinématique//), durant lesquelles ils sont désactivés. Cette commande vous permet de désactiver explicitement un contrôle par le script.\\ \\ Si vous donnez //true//, le contrôle sera activé ; donnez //false// pour le désactiver.\\ \\ Que vous l'activiez ou non, il sera **toujours** désactivé lors d'une cutscene bloquante, ainsi que tous les autres contrôles.\\ \\ Lorsqu'un contrôle est désactivé, il ne répondra pas aux clics de souris. Si c'est un bouton, ses images de survol et de pression ne seront pas affichées. Le contrôle sera dessiné selon les réglages du jeu "When GUI Disabled" ("//Lorsque GUI Désactivé//"), comme d'habitude.\\ \\ ** S'applique à ** \\ \\ Hérité par Button, InvWindow, Label, ListBox, Slider and TextBox.\\ \\ Exemple : btnSauverPartie.Enabled = false; désactivera le bouton //btnSauverPartie//.\\ \\ // Voir aussi : // [[ags55#Clickable|GUIControl.Clickable]], [[ags55#Visible|GUIControl.Visible]]\\ \\ ---- ====Height property (GUI controls)==== int GUIControl.Height; Retourne/Définit la hauteur du contrôle de GUI. Ceci vous permet de redimensionner dynamiquement le contrôle du GUI lors de l'exécution du jeu.\\ \\ ** S'applique à ** \\ \\ Hérité par Button, InvWindow, Label, ListBox, Slider and TextBox.\\ \\ Exemple : btnConfirmer.Height = 20; fera que le bouton //btnConfirmer// fera 20 pixels de haut.\\ \\ // Voir aussi : // [[ags55#SetSize|GUIControl.SetSize]], [[ags55#Width|GUIControl.Width]]\\ \\ ---- ====ID property (GUI controls)==== readonly int GUIControl.ID Retourne le numéro ID du contrôle de GUI. Ceci est le numéro de l'objet contrôle dans l'éditeur de GUI, et est pratique si vous devez gérer du code ancien qui utilise le numéro du contrôle plutôt que son nom d'objet.\\ \\ ** S'applique à ** \\ \\ Hérité par Button, InvWindow, Label, ListBox, Slider and TextBox.\\ \\ Exemple : SetGUIObjectEnabled(lstSauvegardes.OwningGUI.ID, lstSauvegardes.ID, 1); lstSauvegardes.Enabled = false; utilise la fonction obsolète SetGUIObjectEnabled pour activer la liste lstSauvegardes, puis utilise la propriété actuelle équivalente pour la désactiver.\\ \\ // Voir aussi : // [[ags55#OwningGUI|GUIControl.OwningGUI]], [[ags54#GUI.ID|GUI.ID]]\\ \\ \\ \\ ---- ====OwningGUI property (GUI controls)==== readonly GUI* GUIControl.OwningGUI Retourne le GUI qui contient le contrôle.\\ \\ Retourne un GUI, ce qui vous permet d'utiliser toutes [[ags54#GUIFuncsAndProps|fonctions et propriétés de GUI]] habituelles.\\ \\ ** S'applique à ** \\ \\ Hérité par Button, InvWindow, Label, ListBox, Slider and TextBox.\\ \\ Exemple : GUI *legui = lstSauvegardes.OwningGUI; legui.Visible = false; lstSauvegardes.OwningGUI.Visible = true; efface le GUI qui contient la liste lstSauvegardes, puis l'affiche à nouveau en utilisant une approche sans pointeur intermédiaire.\\ \\ // Voir aussi : // [[ags55#ID|GUIControl.ID]], [[ags54#GUI.ID|GUI.ID]]\\ \\ ---- ====SendToBack (GUI controls)==== GUIControl.SendToBack() Place ce contrôle à l'arrière-plan. Ceci vous permet de réarranger l'ordre d'affichage des contrôle dans le GUI.\\ \\ ** S'applique à ** \\ \\ Hérité par Button, InvWindow, Label, ListBox, Slider and TextBox.\\ \\ Exemple : btnGrosBouton.SendToBack(); placera le bouton //btnGrosBouton// derrière tous les autres contrôle du GUI.\\ \\ // Voir aussi : // [[ags55#BringToFront|GUIControl.BringToFront]]\\ \\ ---- ====SetPosition (GUI controls)==== // (Anciennement SetGUIObjectPosition, désormais obsolète) // \\ \\ GUIControl.SetPosition(int x, int y) Déplace le coin supérieur gauche du contrôle de GUI à (X,Y). Ces coordonnées sont relatives au GUI qui contient le contrôle.\\ \\ Ceci vous permet de déplacer dynamiquement les contrôles de GUI à l'écran durant l'exéuction du jeu, et pourrait être assez utile avec GUI.SetSize si vous voulez proposer un GUI redimensionnable dynamiquement.\\ \\ ** S'applique à ** \\ \\ Hérité par Button, InvWindow, Label, ListBox, Slider and TextBox.\\ \\ Exemple : btnConfirmer.SetPosition(40, 10); déplacera le bouton //btnConfirmer// pour le positionner à (40,10) dans le GUI.\\ \\ // Voir aussi : // [[ags55#Enabled|GUIControl.Enabled]], [[ags54#GUI.SetPosition|GUI.SetPosition]], [[ags55#SetSize|GUIControl.SetSize]], [[ags55#X|GUIControl.X]], [[ags55#Y|GUIControl.Y]]\\ \\ ---- ====SetSize (GUI controls)==== // (Anciennement SetGUIObjectSize, désormais obsolète) // \\ \\ GUIControl.SetSize(int largeur, int hauteur) Redimensionne le contrôle de GUI spécifié à LARGEUR x HAUTEUR.\\ \\ Ceci vous permet de redimensionner dynamiquement les contrôles de GUI à l'écran durant l'exécution du jeu et pourrait être assez utile avec GUI.SetSize et GUIControl.SetPosition si vous voulez créer un GUI dynamiquement redimensionnable.\\ \\ ** S'applique à ** \\ \\ Hérité par Button, InvWindow, Label, ListBox, Slider and TextBox.\\ \\ Exemple : invMain.SetSize(160, 100); redimensionne le contrôle // invMain // à la taille 160 x 100.\\ \\ // Voir aussi : // [[ags55#Height|GUIControl.Height]], [[ags55#SetPosition|GUIControl.SetPosition]], [[ags54#GUI.SetSize|GUI.SetSize]], [[ags55#Width|GUIControl.Width]],\\ \\ ---- ====Visible property (GUI controls)==== bool GUIControl.Visible Retourne/Définit si le contrôle de GUI est visible. Vaut //true// par défaut, mais vous pouvez donner la valeur //false// afin d'enlever temporairement le contrôle du GUI.\\ \\ Tant ce contrôle est invisible, il n'est pas affiché à l'écran, et ne répond plus aux clics ou autres actions de l'utilisateur.\\ \\ ** S'applique à ** \\ \\ Hérité par Button, InvWindow, Label, ListBox, Slider and TextBox.\\ \\ Exemple : btnPartiesSauvees.Visible = false; rendra le bouton //btnPartiesSauvees// invisible.\\ \\ // Voir aussi : // [[ags55#Enabled|GUIControl.Enabled]]\\ \\ ---- ====Width property (GUI controls)==== int GUIControl.Width; Retourne/Définit la largeur du contrôle du GUI. Ceci vous permet de redimensionner dynamiquement vos contrôles de GUI durant l'exécution du jeu.\\ \\ ** S'applique à ** \\ \\ Hérité par Button, InvWindow, Label, ListBox, Slider and TextBox.\\ \\ Exemple : btnConfirmer.Width = 110; donne une largeur de 110 pixels au bouton //btnConfirm//.\\ \\ // Voir aussi : // [[ags55#Height|GUIControl.Height]], [[ags55#SetSize|GUIControl.SetSize]]\\ \\ ---- ====X property (GUI controls)==== int GUIControl.X; Retourne/Définit la position X du contrôle de GUI. Ceci spécifie son bord droit, et est relatif au GUI qui contient le contrôle.\\ \\ Ceci vous permet de déplacer dynamiquement les contrôles dans le GUI durant l'exécution du jeu.\\ \\ ** S'applique à ** \\ \\ Hérité par Button, InvWindow, Label, ListBox, Slider and TextBox.\\ \\ Exemple : btnConfirmer.X = 10; déplacera le bouton //btnConfirmer// afin de le positionner à 10 pixels à partir de la gauche du GUI.\\ \\ // Voir aussi : // [[ags55#SetPosition|GUIControl.SetPosition]], [[ags55#Y|GUIControl.Y]]\\ \\ ---- ====Y property (GUI controls)==== int GUIControl.Y; Retourne/Définit la position Y du contrôle de GUI. Ceci spécifie le bord du haut, et est relatif au GUI qui contient le contrôle.\\ \\ Ceci vous permet de déplacer dynamiquement les contrôles dans le GUI durant l'exécution du jeu.\\ \\ ** S'applique à ** \\ \\ Hérité par Button, InvWindow, Label, ListBox, Slider and TextBox.\\ \\ Exemple : btnConfirmer.Y = 20; déplacera le bouton //btnConfirmer// afin de le positionner à 20 pixels à partir du haut du GUI.\\ \\ // Voir aussi : // [[ags55#SetPosition|GUIControl.SetPosition]], [[ags55#X|GUIControl.X]] {{tag>français}}