(Anciennement AnimateButton, désormais obsolète)

Button.Animate(int vue, int sequence, int delai, RepeatStyle)

Anime un bouton GUI en jouant la séquence de la vue spécifiées. Ceci peut être utile pour des animations de mort dans le style Sierra ou pour d'autres effets.

La SEQUENCE de la VUE sera jouée sur le bouton. Le DELAI spécifie la vitesse de l'animation - plus le nombre est haut, plus l'animation est lente. Cette fonction prend les mêmes paramètres que les commandes Character.Animate et Object.Animate.

REPEAT détermine si l'animation sera jouée en boucle de façon répétée, ou ne sera jouée qu'une fois et s'arrêtera sur la dernière image (les valeurs possibles sont eReapeat ou eOnce).

Vous pouvez arrêter une animation à tout moment en redéfinissant la propriété NormalGraphic du bouton, ou en lançant une nouvelle animation sur ce même bouton.

NOTE : Cette commande détruit les images normale, pressée et survolée du bouton. Si vous voulez retrouver une utilisation normale du bouton après une animation, vous devrez redéfinir ses propriétés Graphic pour retrouver les images.

NOTE : Cette commande ne supporte pas les images d'animation retournées. Toute image marquée comme “Flipped” (”Inversée”) sera en fait dessinée normalement sur un bouton.

Exemple :

btnAnimMort.Animate(6, 2, 4, eRepeat);

animera le bouton 'btnAnimMort' en utilisant la séquence 2 de la vue 6, avec un délai de 4 cycles par image, puis répétera l'animation continuellement.

Voir aussi : Button.NormalGraphic

---

bool Button.ClipImage;

Retourne/Définit si le bouton rogne l'image à son cadre.

Par exemple, si le bouton a une taille de 30×30, mais que son graphique est une image de 50×50, alors cette propriété définit si l'image est autorisée à déborder ou non du cadre du bouton.

Vaut false par défaut, c'est-à-dire que l'image n'est pas rognée.

Définir cette valeur à true peut être utile pour vous assurer que l'image du bouton n'est pas plus large que la zone cliquable du bouton, ce qui pourrait entraîner des confusions.

Exemple :

btnOK.ClipImage = true;

restreindra la taille visible de l'image à la zone cliquable du bouton btnOK.

Voir aussi : Button.Graphic

---

FontType Button.Font

Retourne/Définit la police utilisée par le bouton pour afficher du texte.

Le numéro de police doit correspondre à une des polices dans l'onglet Fonts (Polices) de l'éditeur AGS.

Exemple :

btnOK.Font = eFontPrincipale;

changer la police utilisée par le bouton btnOK pour la police “Principale”.

Voir aussi : Label.Font, TextBox.Font

---

(Anciennement compris dans GetButtonPic, désormais obsolète)

readonly int Button.Graphic;

Retourne l'image actuelle du bouton. Si la valeur retournée est inférieure à 1, alors aucune image n'est actuellement affichée sur le bouton.

Cette propriété est en lecture seule ; pour définir l'image, vous devez utiliser une des propriétés NormalGraphic, MouseOverGraphic ou PushedGraphic.

Exemple :

Display("Le bouton utilise actuellement la sprite numéro %d.", btnJouer.Graphic);

affichera le numéro de sprite actuel de btnJouer.

Voir aussi : Button.ClipImage, Button.MouseOverGraphic, Button.NormalGraphic, Button.PushedGraphic

---

(Anciennement compris dans GetButtonPic, désormais obsolète) (Anciennement compris dans SetButtonPic, désormais obsolète)

int Button.MouseOverGraphic;

Retourne/Définit la sprite de survol du bouton. Ceci peut valoir -1, ce qui indique que le bouton n'a pas de graphique particulier lorsque la souris le survole.

Exemple :

Display("Le bouton utilise la sprite numéro %d lorsque la souris le survole.", btnJouer.MouseOverGraphic);

affichera le numéro de la sprite de survol de btnJouer.

Voir aussi : Button.Graphic, Button.NormalGraphic, Button.PushedGraphic

---

(Anciennement compris dans GetButtonPic, désormais obsolète) (Anciennement compris dans SetButtonPic, désormais obsolète)

int Button.NormalGraphic;

Retourne/Définit la sprite normale du bouton (c'est-à-dire l'image utilisée lorsque le bouton n'est ni pressée ni survolé par la souris).

Notez que changer cette propriété aura pour effet de redimensionner le bouton de façon à ce que sa taille corresponde à celle de la nouvelle sprite.

Exemple :

Display("L'image normale du bouton est la sprite numéro %d.", btnJouer.NormalGraphic);

afficher le numéro de sprite normale du bouton btnJouer.

Voir aussi : Button.ClipImage Button.Graphic, Button.MouseOverGraphic, Button.PushedGraphic, Button.TextColor

---

(Anciennement compris dans GetButtonPic, désormais obsolète) (Anciennement compris dans SetButtonPic, désormais obsolète)

int Button.PushedGraphic;

Retourne/Définit la sprite du bouton pressé (c'est-à-dire l'image utilisée lorsque l'utilisateur clique sur le bouton). Ceci peut valoir -1, auquel cas le bouton n'a pas d'image particulière lorsque l'utilisateur clique dessus.

Exemple :

Display("Le bouton utilise la sprite numéro %d lorsqu'on clique dessus.", btnJouer.PushedGraphic);

affichera le numéro de sprite de btnJouer lorsqu'on clique dessus.

Voir aussi : Button.Graphic, Button.MouseOverGraphic, Button.NormalGraphic

---

(Anciennement SetButtonText, désormais obsolète) (Anciennement Button.GetText, désormais obsolète) (Anciennement Button.SetText, désormais obsolète)

String Button.Text;

Retourne/Définit le texte affiché sur le bouton.

Exemple :

Display("Le bouton affichait : %s", btnControleur.Text);
btnControleur.Text = "Activer truc";

affichera l'ancien texte affiché sur btnControleur avant de le changer en 'Activer truc'.

Voir aussi : Button.NormalGraphic, Label.Text

---

int Button.TextColor;

Retourne/Définit la couleur utilisée pour afficher le texte du bouton.

Si le bouton affiche une image plutôt que du texte, alors cette propriété n'a pas d'effet.

Exemple :

btnRecommencer.TextColor = 15;

écrira le texte de 'btnRecommencer' en blanc.

Voir aussi : Button.NormalGraphic