Pages traduites Pages à traduire Pages en cours de traduction
A propos
 

Ceci est une ancienne révision du document !


g


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

(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 : GUI.GetAtScreenXY


AsType

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 : GUI.Controls


BringToFront

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 : GUIControl.SendToBack


Clickable

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 : GUIControl.Enabled


Enabled

(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 : GUIControl.Clickable, GUIControl.Visible


Height

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 : GUIControl.SetSize, GUIControl.Width


ID

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 : GUIControl.OwningGUI, GUI.ID




OwningGUI

readonly GUI* GUIControl.OwningGUI
Retourne le GUI qui contient le contrôle.

Retourne un GUI, ce qui vous permet d'utiliser toutes les fonctions et propriétés des Interfaces 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 : GUIControl.ID, GUI.ID


SendToBack

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 : GUIControl.BringToFront


SetPosition

(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 : GUIControl.Enabled, GUI.SetPosition, GUIControl.SetSize, GUIControl.X, GUIControl.Y


SetSize

(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 : GUIControl.Height, GUIControl.SetPosition, GUI.SetSize, GUIControl.Width,


Visible

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 : GUIControl.Enabled


Width

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 : GUIControl.Height, GUIControl.SetSize


X

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 : GUIControl.SetPosition, GUIControl.Y


Y

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 : GUIControl.SetPosition, GUIControl.X

 
guicontrol.1349972491.txt.gz · Dernière modification: 11/10/2012 18:21 par 129.199.163.10
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki