Cette page vous donne les différences entre la révision choisie et la version actuelle de la page.
ags56 16/11/2008 00:54 | ags56 05/05/2011 11:31 version actuelle | ||
---|---|---|---|
Ligne 2: | Ligne 2: | ||
---- | ---- | ||
- | =====GUI Button functions and properties===== | + | =====Fonction et propriétés des boutons (GUI Button)===== |
- | + | ||
- | \\ | + | |
- | + | ||
- | + | ||
- | ---- | + | |
====Animate (button)==== | ====Animate (button)==== | ||
- | // (Formerly known as AnimateButton, which is now obsolete) // \\ \\ | + | // (Anciennement AnimateButton, désormais obsolète) // \\ \\ |
- | Button.Animate(int view, int loop, int delay, RepeatStyle) | + | Button.Animate(int vue, int sequence, int delai, RepeatStyle) |
- | Animates a GUI button by playing the specified view loop on it. This could be | + | Anime un bouton GUI en jouant la séquence de la vue spécifiées. Ceci peut être |
- | useful for Sierra-style death animations and other effects.\\ \\ | + | utile pour des animations de mort dans le style Sierra ou pour d'autres effets.\\ \\ |
- | LOOP from VIEW will be played on the button. The DELAY specifies the speed of | + | La SEQUENCE de la VUE sera jouée sur le bouton. Le DELAI spécifie la vitesse de |
- | the animation - larger numbers are slower. This has the same values you use | + | l'animation - plus le nombre est haut, plus l'animation est lente. Cette fonction |
- | with the Character.Animate and Object.Animate commands.\\ \\ | + | prend les mêmes paramètres que les commandes Character.Animate et Object.Animate.\\ \\ |
- | REPEAT determines whether the animation will loop repeatedly, or just play once and stop | + | REPEAT détermine si l'animation sera jouée en boucle de façon répétée, ou ne sera jouée |
- | with the last frame showing (eOnce or eRepeat are the possible values).\\ \\ | + | qu'une fois et s'arrêtera sur la dernière image (les valeurs possibles sont eReapeat ou eOnce).\\ \\ |
- | You can abort an animation at any time by setting the button's NormalGraphic property, or | + | Vous pouvez arrêter une animation à tout moment en redéfinissant la propriété NormalGraphic du bouton, |
- | starting a new animation on the same button.\\ \\ | + | ou en lançant une nouvelle animation sur ce même bouton.\\ \\ |
- | ** NOTE: ** This command destroys the button's normal, pushed and mouseover images. If you | + | ** NOTE : ** Cette commande détruit les images normale, pressée et survolée du bouton. |
- | want to return the button to normal usage after playing an animation, you will have to set | + | Si vous voulez retrouver une utilisation normale du bouton après une animation, vous devrez |
- | the Graphic properties to restore the images.\\ \\ | + | redéfinir ses propriétés Graphic pour retrouver les images.\\ \\ |
- | ** NOTE: ** This command does not support flipped view frames. Any frames marked as "Flipped" | + | ** NOTE : ** Cette commande ne supporte pas les images d'animation retournées. Toute image |
- | will in fact be drawn normally when on a button.\\ \\ | + | marquée comme "Flipped" ("//Inversée//") sera en fait dessinée normalement sur un bouton.\\ \\ |
- | Example: | + | Exemple : |
- | btnDeathAnim.Animate(6, 2, 4, eRepeat); | + | btnAnimMort.Animate(6, 2, 4, eRepeat); |
- | + | ||
- | will animate the 'btnDeathAnim' button using loop 2 of view 6, with a delay of 4 | + | |
- | cycles per frame, and repeat the animation continually.\\ \\ | + | |
- | // See Also: // [[ags56#Button.NormalGraphic|Button.NormalGraphic]]\\ \\ | + | |
+ | 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 : // [[ags56#NormalGraphic|Button.NormalGraphic]]\\ \\ | ||
Ligne 44: | Ligne 38: | ||
bool Button.ClipImage; | bool Button.ClipImage; | ||
- | Gets/sets whether the button clips its image to the button boundaries.\\ \\ | + | Retourne/Définit si le bouton rogne l'image à son cadre.\\ \\ |
- | For example, if the button is sized 30x30, but its Graphic is a 50x50 image, then | + | Par exemple, si le bouton a une taille de 30x30, mais que son graphique est une image |
- | this property controls whether the image is allowed to spill over the edge of the button.\\ \\ | + | de 50x50, alors cette propriété définit si l'image est autorisée à déborder ou non du |
- | The default is false, ie. the image is not clipped.\\ \\ | + | cadre du bouton.\\ \\ |
- | Setting this to true can be useful in that it ensures that the button's image is not larger | + | Vaut //false// par défaut, c'est-à-dire que l'image n'est pas rognée.\\ \\ |
- | than the button's clickable area, which can cause confusion when it happens.\\ \\ | + | Définir cette valeur à //true// peut être utile pour vous assurer que l'image du bouton n'est |
- | Example: | + | pas plus large que la zone cliquable du bouton, ce qui pourrait entraîner des confusions.\\ \\ |
+ | Exemple : | ||
btnOK.ClipImage = true; | btnOK.ClipImage = true; | ||
- | sets the // btnOK // button so that its image will be restrained to the button's clickable area.\\ \\ | + | restreindra la taille visible de l'image à la zone cliquable du bouton //btnOK//.\\ \\ |
- | // See Also: // [[ags56#Button.Graphic|Button.Graphic]]\\ \\ | + | // Voir aussi : // [[ags56#Graphic|Button.Graphic]]\\ \\ |
Ligne 65: | Ligne 60: | ||
FontType Button.Font | FontType Button.Font | ||
- | Gets/sets the font used by the button to display text.\\ \\ | + | Retourne/Définit la police utilisée par le bouton pour afficher du texte.\\ \\ |
- | The font number must correspond to one of the fonts from the Fonts pane in the AGS Editor.\\ \\ | + | Le numéro de police doit correspondre à une des polices dans l'onglet Fonts (//Polices//) de l'éditeur AGS.\\ \\ |
- | Example: | + | Exemple : |
- | btnOK.Font = eFontMain; | + | btnOK.Font = eFontPrincipale; |
- | will change the // btnOK // button to use Font "Main".\\ \\ | + | changer la police utilisée par le bouton //btnOK// pour la police "Principale".\\ \\ |
- | // See Also: // [[ags58#Label.Font|Label.Font]], [[ags61#TextBox.Font|TextBox.Font]]\\ \\ | + | // Voir aussi : // [[ags58#Label.Font|Label.Font]], [[ags61#TextBox.Font|TextBox.Font]]\\ \\ |
Ligne 79: | Ligne 74: | ||
====Graphic property (button)==== | ====Graphic property (button)==== | ||
- | // (Formerly part of GetButtonPic, which is now obsolete) // \\ \\ | + | // (Anciennement compris dans GetButtonPic, désormais obsolète) // \\ \\ |
readonly int Button.Graphic; | readonly int Button.Graphic; | ||
- | Gets the current image on a GUI button. If a value less than 1 is returned, | + | Retourne l'image actuelle du bouton. Si la valeur retournée est inférieure à 1, |
- | then no image is currently displayed on the button.\\ \\ | + | alors aucune image n'est actuellement affichée sur le bouton.\\ \\ |
- | This property is read-only; in order to set the image, you must use one of the | + | Cette propriété est en lecture seule ; pour définir l'image, vous devez utiliser |
- | [[ags56#Button.NormalGraphic|NormalGraphic]], | + | une des propriétés |
- | [[ags56#Button.MouseOverGraphic|MouseOverGraphic]] or | + | [[ags56#NormalGraphic|NormalGraphic]], |
- | [[ags56#Button.PushedGraphic|PushedGraphic]] properties.\\ \\ | + | [[ags56#MouseOverGraphic|MouseOverGraphic]] ou |
- | Example: | + | [[ags56#PushedGraphic|PushedGraphic]].\\ \\ |
+ | Exemple : | ||
- | Display("The button is currently using sprite %d.", btnPlay.Graphic); | + | Display("Le bouton utilise actuellement la sprite numéro %d.", btnJouer.Graphic); |
- | will display btnPlay's current sprite number.\\ \\ | + | affichera le numéro de sprite actuel de //btnJouer//.\\ \\ |
- | // See Also: // [[ags56#Button.ClipImage|Button.ClipImage]], | + | // Voir aussi : // [[ags56#ClipImage|Button.ClipImage]], |
- | [[ags56#Button.MouseOverGraphic|Button.MouseOverGraphic]], | + | [[ags56#MouseOverGraphic|Button.MouseOverGraphic]], |
- | [[ags56#Button.NormalGraphic|Button.NormalGraphic]], | + | [[ags56#NormalGraphic|Button.NormalGraphic]], |
- | [[ags56#Button.PushedGraphic|Button.PushedGraphic]]\\ \\ | + | [[ags56#PushedGraphic|Button.PushedGraphic]]\\ \\ |
Ligne 104: | Ligne 100: | ||
====MouseOverGraphic property (button)==== | ====MouseOverGraphic property (button)==== | ||
- | // (Formerly part of GetButtonPic, which is now obsolete) // | + | // (Anciennement compris dans GetButtonPic, désormais obsolète) // |
- | // (Formerly part of SetButtonPic, which is now obsolete) // \\ \\ | + | // (Anciennement compris dans SetButtonPic, désormais obsolète) // \\ \\ |
int Button.MouseOverGraphic; | int Button.MouseOverGraphic; | ||
- | Gets/sets the button's mouse-over sprite. This can be -1, which indicates that the button | + | Retourne/Définit la sprite de survol du bouton. Ceci peut valoir -1, ce qui indique que le bouton |
- | does not have a mouse-over graphic.\\ \\ | + | n'a pas de graphique particulier lorsque la souris le survole.\\ \\ |
- | Example: | + | Exemple : |
- | Display("The button's mouse-over image is sprite %d.", btnPlay.MouseOverGraphic); | + | Display("Le bouton utilise la sprite numéro %d lorsque la souris le survole.", btnJouer.MouseOverGraphic); |
- | will display btnPlay's mouse-over sprite number.\\ \\ | + | affichera le numéro de la sprite de survol de //btnJouer//.\\ \\ |
- | // See Also: // [[ags56#Button.Graphic|Button.Graphic]], | + | // Voir aussi : // [[ags56#Graphic|Button.Graphic]], |
- | [[ags56#Button.NormalGraphic|Button.NormalGraphic]], | + | [[ags56#NormalGraphic|Button.NormalGraphic]], |
- | [[ags56#Button.PushedGraphic|Button.PushedGraphic]]\\ \\ | + | [[ags56#PushedGraphic|Button.PushedGraphic]]\\ \\ |
Ligne 126: | Ligne 122: | ||
====NormalGraphic property (button)==== | ====NormalGraphic property (button)==== | ||
- | // (Formerly part of GetButtonPic, which is now obsolete) // | + | // (Anciennement compris dans GetButtonPic, désormais obsolète) // |
- | // (Formerly part of SetButtonPic, which is now obsolete) // \\ \\ | + | // (Anciennement compris dans SetButtonPic, désormais obsolète) // \\ \\ |
int Button.NormalGraphic; | int Button.NormalGraphic; | ||
- | Gets/sets the button's normal sprite (ie. the graphic used when the button is not pushed | + | Retourne/Définit la sprite normale du bouton (c'est-à-dire l'image utilisée lorsque le bouton |
- | and the mouse is not over it).\\ \\ | + | n'est ni pressée ni survolé par la souris).\\ \\ |
- | Note that setting this to a different sprite will change the button's size to match the size of the new sprite.\\ \\ | + | Notez que changer cette propriété aura pour effet de redimensionner le bouton de façon à ce que sa taille corresponde |
- | Example: | + | à celle de la nouvelle sprite.\\ \\ |
+ | Exemple : | ||
- | Display("The button's normal image is sprite %d.", btnPlay.NormalGraphic); | + | Display("L'image normale du bouton est la sprite numéro %d.", btnJouer.NormalGraphic); |
- | will display btnPlay's normal sprite number.\\ \\ | + | afficher le numéro de sprite normale du bouton //btnJouer//.\\ \\ |
- | // See Also: // [[ags56#Button.ClipImage|Button.ClipImage]] | + | // Voir aussi : // [[ags56#ClipImage|Button.ClipImage]] |
- | [[ags56#Button.Graphic|Button.Graphic]], | + | [[ags56#Graphic|Button.Graphic]], |
- | [[ags56#Button.MouseOverGraphic|Button.MouseOverGraphic]], | + | [[ags56#MouseOverGraphic|Button.MouseOverGraphic]], |
- | [[ags56#Button.PushedGraphic|Button.PushedGraphic]], | + | [[ags56#PushedGraphic|Button.PushedGraphic]], |
- | [[ags56#Button.TextColor|Button.TextColor]]\\ \\ | + | [[ags56#TextColor|Button.TextColor]]\\ \\ |
Ligne 151: | Ligne 148: | ||
====PushedGraphic property (button)==== | ====PushedGraphic property (button)==== | ||
- | // (Formerly part of GetButtonPic, which is now obsolete) // | + | // (Anciennement compris dans GetButtonPic, désormais obsolète) // |
- | // (Formerly part of SetButtonPic, which is now obsolete) // \\ \\ | + | // (Anciennement compris dans SetButtonPic, désormais obsolète) // \\ \\ |
int Button.PushedGraphic; | int Button.PushedGraphic; | ||
- | Gets/sets the button's pushed sprite (ie. the graphic used when the button is pushed | + | Retourne/Définit la sprite du bouton pressé (c'est-à-dire l'image utilisée lorsque l'utilisateur |
- | in by the user). This can be -1, which indicates that the button does not have a pushed | + | clique sur le bouton). Ceci peut valoir -1, auquel cas le bouton n'a pas d'image particulière |
- | image.\\ \\ | + | lorsque l'utilisateur clique dessus.\\ \\ |
- | Example: | + | Exemple : |
- | Display("The button's pushed image is sprite %d.", btnPlay.PushedGraphic); | + | Display("Le bouton utilise la sprite numéro %d lorsqu'on clique dessus.", btnJouer.PushedGraphic); |
- | will display btnPlay's pushed sprite number.\\ \\ | + | affichera le numéro de sprite de //btnJouer// lorsqu'on clique dessus.\\ \\ |
- | // See Also: // [[ags56#Button.Graphic|Button.Graphic]], | + | // Voir aussi : // [[ags56#Graphic|Button.Graphic]], |
- | [[ags56#Button.MouseOverGraphic|Button.MouseOverGraphic]], | + | [[ags56#MouseOverGraphic|Button.MouseOverGraphic]], |
- | [[ags56#Button.NormalGraphic|Button.NormalGraphic]]\\ \\ | + | [[ags56#NormalGraphic|Button.NormalGraphic]]\\ \\ |
Ligne 174: | Ligne 171: | ||
====Text property (button)==== | ====Text property (button)==== | ||
- | // (Formerly known as SetButtonText, which is now obsolete) // | + | // (Anciennement SetButtonText, désormais obsolète) // |
- | // (Formerly known as Button.GetText, which is now obsolete) // | + | // (Anciennement Button.GetText, désormais obsolète) // |
- | // (Formerly known as Button.SetText, which is now obsolete) // \\ \\ | + | // (Anciennement Button.SetText, désormais obsolète) // \\ \\ |
String Button.Text; | String Button.Text; | ||
- | Gets/sets the text displayed on the button.\\ \\ | + | Retourne/Définit le texte affiché sur le bouton.\\ \\ |
- | Example: | + | Exemple : |
- | Display("Button displayed: %s", btnController.Text); | + | Display("Le bouton affichait : %s", btnControleur.Text); |
- | btnController.Text = "Enable jibble"; | + | btnControleur.Text = "Activer truc"; |
- | will display the old text, then change button btnController to read 'Enable jibble'.\\ \\ | + | affichera l'ancien texte affiché sur //btnControleur// avant de le changer en 'Activer truc'.\\ \\ |
- | // See Also: // [[ags56#Button.NormalGraphic|Button.NormalGraphic]], [[ags58#Label.Text|Label.Text]]\\ \\ | + | // Voir aussi : // [[ags56#NormalGraphic|Button.NormalGraphic]], [[ags58#Label.Text|Label.Text]]\\ \\ |
Ligne 199: | Ligne 196: | ||
int Button.TextColor; | int Button.TextColor; | ||
- | Gets/sets the text colour used to display the button's text. \\ \\ | + | Retourne/Définit la couleur utilisée pour afficher le texte du bouton.\\ \\ |
- | If the button is displaying an image rather than text, then this property has no effect.\\ \\ | + | Si le bouton affiche une image plutôt que du texte, alors cette propriété n'a pas d'effet.\\ \\ |
- | Example: | + | Exemple : |
- | btnRestart.TextColor = 15; | + | btnRecommencer.TextColor = 15; |
- | will change button 'btnRestart' to have white text.\\ \\ | + | écrira le texte de 'btnRecommencer' en blanc.\\ \\ |
- | // See Also: // [[ags56#Button.NormalGraphic|Button.NormalGraphic]] | + | // Voir aussi : // [[ags56#NormalGraphic|Button.NormalGraphic]] |
- | {{tag>anglais}} | + | {{tag>français}} |