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}} |