[[Propriétés des barres de défilement (GUI Slider)]]
Pages traduites Pages à traduire Pages en cours de traduction
A propos
 
Piste:

Différences

Cette page vous donne les différences entre la révision choisie et la version actuelle de la page.

slider 07/10/2012 16:21 slider 11/10/2012 16:15 version actuelle
Ligne 1: Ligne 1:
[[ags|{{:contents.gif}}]] [[scripting|{{:up.gif}}]] [[listbox|{{:back.gif}}]] [[textbox|{{:forward.gif}}]] [[ags|{{:contents.gif}}]] [[scripting|{{:up.gif}}]] [[listbox|{{:back.gif}}]] [[textbox|{{:forward.gif}}]]
---- ----
-=====Fonctions et propriétés des listes (GUI List Box)===== 
 +=====Propriétés des barres de défilement (GUI Slider)=====
-====AddItem==== +====BackgroundGraphic====
- // (Anciennement ListBoxAdd, désormais obsolète) // \\ \\ +
   
-  ListBox.AddItem(string nouvelleLigne)+  int Slider.BackgroundGraphic;
-Ajoute NOUVELLELIGNE à la liste spécifiée. La ligne sera ajoutée à la fin +Retourne/Définit la sprite utilisée pour l'arrière-plan de la barre. Cette image est répétée tout 
-de la liste.\\ \\  +le long de la barre.\\ \\  
- ** NOTE: **  Les listes ont une limite de 200 lignes. Si vous essayez d'en ajouter plus que ça, +Vous pouvez passer 0, ce qui dessinera l'arrière-plan gris par défaut pour les barres de défilement.\\ \\
-cette fonction retournera //false// et la ligne ne sera pas ajoutée.\\ \\ +
Exemple : Exemple :
   
-  String entree = txtEntreeJoueur.Text; +  Display(";L'arrière-plan de sldSante est la sprite numéro %d", sldSante.BackgroundGraphic);
-  lstChoix.AddItem(entree);+
-récupérera l'entrée de l'utilisateur et l'ajoutera à la liste.\\ \\  +affiche le numéro de l'image d'arrière-plan de la barre  // sldSante //.\\ \\  
- // Voir aussi : //  [[ListBox#Clear|ListBox.Clear]], + // Compatibilité : //  Supporté par  ** AGS 3.1.0 **  et les versions plus récentes.\\ \\  
-[[ListBox#FillDirList|ListBox.FillDirList]], + // Voir aussi : //  [[Slider#HandleGraphic|Slider.HandleGraphic]]\\ \\
-[[ListBox#InsertItemAt|ListBox.InsertItemAt]], +
-[[ListBox#Items|ListBox.Items]], +
-[[ListBox#RemoveItem|ListBox.RemoveItem]]\\ \\ +
Ligne 29: Ligne 23:
---- ----
-====Clear==== +====HandleGraphic====
- // (Anciennement ListBoxClear, désormais obsolète) // \\ \\ +
   
-  ListBox.Clear()+  int Slider.HandleGraphic;
-Supprime toutes les lignes de la liste spécifiée.\\ \\ +Retourne/Définit la sprite utilisée pour dessiner le curseur sur la barre. Le curseur 
 +correspond à la position actuelle de défilement, et peut être glissé par le joueur.\\ \\  
 +L'image du curseur peut valoir 0, auquel cas ce sera un curseur gris par défaut.\\ \\
Exemple : Exemple :
   
-  lstCarnet.Clear();+  Display("Le curseur de sldSante est la sprite numéro %d", sldSante.HandleGraphic);
-supprimera toutes les lignes de la liste // lstCarnet // .\\ \\  +affiche le numéro de l'image du curseur de la barre de défilement // sldSante //.\\ \\  
- // Voir aussi : //  [[ListBox#AddItem|ListBox.AddItem]]\\ \\ + // Compatibilité : //  Supporté par  ** AGS 3.1.0 **  et les versions plus récentes.\\ \\  
 + // Voir aussi : //  [[Slider#BackgroundGraphic|Slider.BackgroundGraphic]], 
 +[[Slider#HandleOffset|Slider.HandleOffset]]\\ \\
Ligne 46: Ligne 43:
---- ----
-====FillDirList==== +====HandleOffset====
- // (Anciennement ListBoxDirList, désormais obsolète) // \\ \\ +
   
-  ListBox.FillDirList(string filemask)+  int Slider.HandleOffset;
-Remplit la liste avec une série des noms de fichiers correspondant +Retourne/Définit le décalage à utiliser pour l'image du curseur. Cette valeur est initialement 
-à FILEMASK dans le répertoire courant. Ceci peut être utile si vous +définie dans l'éditeur.\\ \\
-avez plusieurs fichiers de donnée et que le joueur peut choisir +
-lequel charger.\\ \\  +
-FILEMASK correspond à une expression de recherche DOS/Windows standard +
-telle que "*.dat" ou "data*.*".\\ \\  +
-Cette commande supporte le mot-clé $SAVEGAMEDIR$, qui vous permet d'accéder aux fichiers +
-du répertoire de sauvegardes. Ceci est spécialement important depuis le passage à Windows Vista, +
-où vous ne pouvez potentiellement pas accéder au dossier principal du jeu.\\ \\ +
Exemple : Exemple :
   
-  lstPartiesSauvees.FillDirList("agssave.*");+  sldSante.HandleOffset = 2;
-remplira la liste avec les parties sauvegardées. Notez que vous utiliseriez plutôt +dessinera le curseur de la barre // sldSante //  après 2 pixels sur sa droite.\\ \\  
-FillSaveGameList pour cette de tâche.\\ \\  + // Compatibilité : //  Supporté par  ** AGS 3.1.0 **  et les versions plus récentes.\\ \\  
- // Voir aussi : //  [[ListBox#AddItem|ListBox.AddItem]], [[ListBox#Clear|ListBox.Clear]], + // Voir aussi : //  [[Slider#HandleGraphic|Slider.HandleGraphic]]\\ \\
-[[ListBox#FillSaveGameList|ListBox.FillSaveGameList]]\\ \\ +
Ligne 73: Ligne 61:
---- ----
-====FillSaveGameList==== +====Max====
- // (Anciennement ListBoxSaveGameList, désormais obsolète) // \\ \\ +
   
-  ListBox.FillSaveGameList()+  int Slider.Max;
-Remplit la liste spécifiée avec les parties sauvegardées, triées correctement +Retourne/Définit la valeur maximum de la barre de GUI spécifiée.\\ \\  
-de la plus récente (en haut) à la moins récente (en bas).\\ \\  +En changeant le maximum, la valeur de la barre de défilement sera ajustée 
-La propriété [[ListBox#SaveGameSlots|SaveGameSlots]] est mise à jour pour contenir +si nécessaire de façon à rester dans l'intervalle Min - Max.\\ \\  
-le numéro du bloc de sauvegarde de chaque index dans la liste, vous pouvez donc faire : +Une erreur survient si vous essayez de définir le maximum à une valeur inférieure au minimum.\\ \\
-   +
-  int index = lstPartiesSauvees.SelectedIndex; +
-  RestoreGameSlot(lstPartiesSauvees.SaveGameSlots[index]); +
- +
- ** NOTE : **  La liste de parties sauvegardées ne gère que 50 parties. Si ListBox.ItemCount +
-retourne 50 et que vous avez un dialogue de sauvegarde, vous pourrez demander à l'utilisateur +
-de choisir de remplacer un fichier existant plutôt que créer une nouvelle sauvegarde.\\ \\ +
Exemple : Exemple :
   
-  lstPartiesSauvees.FillSaveGameList();+  sldSante.Max = 200;
-will fill listbox  // lstPartiesSauvees // with the list of the saved games.\\ \\  +donne la valeur maximum 200 à la barre de défilement // sldSante //.\\ \\  
- // Voir aussi : //  [[ListBox#FillDirList|ListBox.FillDirList]], + // Voir aussi : //  [[Slider#Min|Slider.Min]], 
-[[ListBox#ItemCount|ListBox.ItemCount]], +[[Slider#Value|Slider.Value]]\\ \\
-[[ListBox#SaveGameSlots|ListBox.SaveGameSlots]], +
-[[ListBox#SelectedIndex|ListBox.SelectedIndex]]\\ \\ +
Ligne 103: Ligne 81:
---- ----
-====GetItemAtLocation====+====Min====
   
-  ListBox.GetItemAtLocation(int x, int y)+  int Slider.Min;
-Détermine quelle ligne dans la liste est aux coordonnées (X,Y). +Retourne/Définit la valeur minimum de la barre de GUI spécifiée.\\ \\  
-Ceci vous permet de trouver quelle ligne la souris survole, par exemple.\\ \\  +En changeant le minimum, la valeur de la barre de défilement sera ajustée 
-Retourne le numéro de la ligne (où la première vaut 0), ou -1 si les coordonnées spécifiées +si nécessaire de façon à rester dans l'intervalle Min - Max.\\ \\  
-ne correspondent à aucune ligne ou son hors de la liste.\\ \\ +Une erreur survient si vous essayez de définir le minimum à une valeur supérieure au maximum.\\ \\
Exemple : Exemple :
   
-  int index = lstOptions.GetItemAtLocation(mouse.x, mouse.y); +  sldSante.Min = 0;
-  if (index < 0) { +
-    Display("La souris ne survole aucune ligne !"); +
-  } +
-  else { +
-    String ligneSelectionnee = lstOptions.Items[index]; +
-    Display("La souris survole la ligne '%s'.", selectedItem); +
-  }+
-affichera le texte de la ligne que la souris survole actuellement.\\ \\  +donnera la valeur minimum 0 à la barre de défilement //sldSante//.\\ \\  
- // Voir aussi : //  [[ListBox#SelectedIndex|ListBox.SelectedIndex]]\\ \\ + // Voir aussi : //  [[Slider#Max|Slider.Max]], 
 +[[Slider#Value|Slider.Value]]\\ \\
Ligne 129: Ligne 101:
---- ----
-====InsertItemAt==== +====Value==== 
-   + // (Anciennement GetSliderValue, désormais obsolète) // 
-  ListBox.InsertItemAt(int index, string nouvelleLigne) +
- +
-Intsère NOUVELLELIGNE dans la liste spécifiée. La ligne sera insérée **avant** celle +
-dont l'index est spécifié.\\ \\  +
-Les indices des listes vont de 0 (première ligne) à ItemCount - 1 (dernière ligne). +
-La nouvelle ligne sera insérée avant l'index que vous spécifiez.\\ \\  +
- ** NOTE : **  Les listes ont une limite de 200 lignes. Si vous essayez d'en ajouter davantage, +
-cette fonction retournera //false// et la ligne ne sera pas ajoutée.\\ \\  +
-Exemple : +
-   +
-  lstChoices.AddItem("Première ligne"); +
-  lstChoices.AddItem("Deuxième ligne"); +
-  lstChoices.InsertItemAt(1, "Troisième ligne"); +
- +
-insérera la Troisième Ligne entre la Première (index 0) et la Seconde (index 1).\\ \\  +
- // Voir aussi : //  [[ListBox#AddItem|ListBox.AddItem]], +
-[[ListBox#RemoveItem|ListBox.RemoveItem]]\\ \\  +
- +
- +
- +
----- +
- +
-====RemoveItem==== +
- // (Anciennement ListBoxRemove, désormais obsolète) // \\ \\  +
-   +
-  ListBox.RemoveItem(int ligne) +
- +
-Supprime la LIGNE de la liste spécifiée. LIGNE correspond à l'index de la ligne à supprimer +
-dans la liste, en commençant à 0 pour la première.\\ \\  +
-Si vous voulez supprimer toutes les lignes de la liste, utilisez [[ListBox#Clear|ListBox.Clear]] à la place.\\ \\  +
- ** NOTE : **  Appeler cette fonction fait que les autres lignes dans la liste sont renumérotés, assurez-vous +
-donc de ne pas garder d'anciennes références par ListBox.SelectedIndex et les autres fonctions lorsque vous +
-utilisez cette commandes.\\ \\  +
-Exemple : +
-   +
-  lstTest.AddItem("Première ligne"); +
-  lstTest.AddItem("Deuxième ligne"); +
-  lstTest.RemoveItem(0); +
- +
-la liste ne contiendra plus que "Deuxième ligne".\\ \\  +
- // Voir aussi : //  [[ListBox#Clear|ListBox.Clear]], [[ListBox#FillDirList|ListBox.FillDirList]]\\ \\  +
- +
- +
- +
----- +
- +
-====ScrollDown==== +
-   +
-  ListBox.ScrollDown() +
- +
-Fait défiler la liste d'un cran vers le bas. Si elle se trouve déjà tout en bas, rien ne se passe.\\ \\  +
-Exemple : +
-   +
-  lstTest.ScrollDown(); +
- +
-fait défiler la liste //lstTest// d'un cran vers le bas.\\ \\  +
- // Voir aussi : //  [[ListBox#ScrollUp|ListBox.ScrollUp]]\\ \\  +
- +
- +
- +
----- +
- +
-====ScrollUp==== +
-   +
-  ListBox.ScrollUp() +
- +
-Fait défiler la liste d'un cran vers le haut. Si elle se trouve déjà tout en haut, rien ne se passe.\\ \\  +
-Exemple : +
-   +
-  lstTest.ScrollUp(); +
- +
-fait défiler la liste //lstTest// d'un cran vers le haut.\\ \\  +
- // Voir aussi : //  [[ListBox#ScrollDown|ListBox.ScrollDown]]\\ \\  +
- +
- +
- +
----- +
- +
-====Font==== +
-   +
-  FontType ListBox.Font +
- +
-Retourne/Définit la police utilisée par la liste spécifiée.\\ \\  +
-Exemple : +
-   +
-  lstPartiesSauvees.Font = eFontSpeech; +
- +
-fera utiliser la police "Speech" à la liste // lstPartiesSauvees //.\\ \\  +
- // Voir aussi : //  [[Label#Font|Label.Font]], [[TextBox#TextBox.Text|TextBox.Text]]\\ \\  +
- +
- +
- +
----- +
- +
-====HideBorder==== +
-   +
-  bool ListBox.HideBorder +
- +
-Retourne/Définit si les bordures de la liste sont cachées.\\ \\  +
-Notez que cacher les bordures a pour effet implicite de cacher également les flèches de défilement de la liste.\\ \\  +
-Exemple : +
-   +
-  lstPartiesSauvees.HideBorder = true; +
- +
-cachera les bordures entourant la liste des Parties Sauvées.\\ \\  +
- // Voir aussi : //  [[ListBox#HideScrollArrows|ListBox.HideScrollArrows]]\\ \\  +
- +
- +
- +
----- +
- +
-====HideScrollArrows==== +
-   +
-  bool ListBox.HideScrollArrows +
- +
-Retourne/Définit si les flèches de défilement sont cachées ou non.\\ \\  +
-Vu que l'apparence des flèches de défilement n'est pas personnalisable, vous pourriez vouloir +
-utiliser cette propriété pour les cacher afin de proposer vos propres flèches à l'aide +
-de boutons de GUI.\\ \\  +
- ** NOTE : **  Si le réglage "Hide Border" ("//Cacher Bordures//") de la liste est activé, +
-alors les flèches seront assi cachées, puisque "Hide Border" contient "Hide Scroll Arrows" ("//Cacher Flèches Défilement//"). +
-Vous n'avez besoin d'utiliser cette propriété que si vous voulez que les bordures soient visibles, mais pas les flèches.\\ \\  +
-Exemple : +
-   +
-  lstPartiesSauvees.HideScrollArrows = true; +
- +
-cachera les flèches de défilement pré-fournies de la liste.\\ \\  +
- // Voir aussi : //  [[ListBox#HideBorder|ListBox.HideBorder]]\\ \\  +
- +
- +
- +
----- +
- +
-====ItemCount==== +
- // (Anciennement ListBoxGetNumItems, désormais obsolète) // \\ \\  +
-   +
-  readonly int ListBox.ItemCount +
- +
-Retourne le nombre de lignes dans la liste spécifiée. Les indices de ligne vont de +
-0 à (nombreLignes - 1).\\ \\  +
-Cette propriété est en lecture seule. Pour changer le nombre de ligne, utilisez les méthodes +
-AddItem et RemoveItem.\\ \\  +
-Exemple : +
-   +
-  int sauvegardes = lstPartiesSauvees.ItemCount; +
- +
-donnera le nombre de parties sauvées comme valeur à la variable int SAUVEGARDES.\\ \\  +
- // Voir aussi : //  [[ListBox#Items|ListBox.Items]]\\ \\  +
- +
- +
- +
----- +
- +
-====Items==== +
- // (Anciennement ListBoxGetItemText, désormais obsolète) //  +
- // (Anciennement ListBox.GetItemText, désormais obsolète) //   + // (Anciennement SetSliderValue, désormais obsolète) // \\ \\
-  +
- // (Anciennement ListBox.SetItemText, désormais obsolète) // \\ \\  +
-   +
-  String ListBox.Items[index] +
- +
-Retourne/Définit le texte de la ligne INDEX de la liste.\\ \\  +
-Les lignes des listes sont numérotées à partir de 0, la première ligne a donc l'indice 0, +
-la seconde l'indice 1, etc. La plus haute valeur possible vaut ItemCount mois 1.\\ \\  +
-Si vous voulez ajouter une nouvelle ligne à la liste, utilisez la méthode [[ListBox#AddItem|ListBox.AddItem]].\\ \\  +
-Exemple : +
-   +
-  String texteLigneSelectionnee = lstOptions.Items[lstOptions.SelectedIndex]; +
- +
-récupérera le texte de la ligne sélectionnée dans la liste.\\ \\  +
- // Voir aussi : //  [[ListBox#SelectedIndex|ListBox.SelectedIndex]], +
-[[ListBox#ItemCount|ListBox.ItemCount]], +
-[[ListBox#AddItem|ListBox.AddItem]]\\ \\  +
- +
- +
- +
----- +
- +
-====RowCount==== +
-   +
-  readonly int ListBox.RowCount +
- +
-Retourne le nombre de lignes qui peuvent être affichées dans la liste. Cela dépend de la taille de la liste +
-et **ne dépend pas** du nombre de lignes qui sont véritablement contenues dans la liste.\\ \\  +
-Cette propriété est en lecture seule. Pour changer le nombre de lignes affichées, ajustez la taille de la liste.\\ \\  +
-Exemple : +
-   +
-  Display("Vous pouvez actuellement voir %d lignes dans la liste", lstPartiesSauvees.RowCount); +
- +
-affichera le nombre de lignes que la liste Parties Sauvées peut afficher simultanément.\\ \\  +
- // Voir aussi : //  [[ListBox#ItemCount|ListBox.ItemCount]], [[ListBox#ScrollDown|ListBox.ScrollDown]], +
-[[ListBox#ScrollUp|ListBox.ScrollUp]]\\ \\  +
- +
- +
- +
----- +
- +
-====SaveGameSlots==== +
- // (Anciennement global array savegameindex, désormais obsolète) // \\ \\  +
-   +
-  readonly int ListBox.SaveGameSlots[]; +
- +
-Contient le bloc de sauvegarde correspondant pour chaque ligne dans la liste.\\ \\  +
-Cela est nécessaire puisque la commande FillSaveGameList trie la liste des parties +
-sauvées pour placer la plus récente en premier. Ainsi, vous pouvez utiliser le tableau +
-pour faire correspondre chaque ligne à la sauvegarde correspondante.\\ \\  +
- ** NOTE : **  Vous devez utiliser la commande FillSaveGameList pour remplir ce tableau.\\ \\  +
-Exemple : +
-   +
-  int index = lstPartiesSauvees.SelectedIndex; +
-  RestoreGameSlot(lstPartiesSauvees.SaveGameSlots[index]); +
- +
-chargera la sauvegarde actuellement sélectionnée dans la liste, en supposant que FillSaveGameList +
-a été utilisé plus tôt.\\ \\  +
- // Voir aussi : //  [[ListBox#FillSaveGameList|ListBox.FillSaveGameList]], +
-[[ListBox#SelectedIndex|ListBox.SelectedIndex]]\\ \\  +
- +
- +
- +
----- +
- +
-====SelectedIndex==== +
- // (Anciennement ListBoxGetSelected, désormais obsolète) //   +
-  +
- // (Anciennement ListBoxSetSelected, désormais obsolète) // \\ \\  +
-   +
-  int ListBox.SelectedIndex +
- +
-Retourne/Définit l'indice de la liste de la ligne actuellement sélectionnée. +
-La première ligne est 0, la seconde 1, etc. Si aucune ligne n'est sélectionnée, +
-cette propriété vaut -1.\\ \\  +
-Vous pouvez lui donner la valeur -1 pour dé-sélectionner les lignes.\\ \\  +
-Exemple : +
-   +
-  String texteSelectionne = lstOptions.Items[lstOptions.SelectedIndex]; +
- +
-retournera le texte de la ligne sélectionnée dans la liste.\\ \\  +
- +
- +
- +
----- +
- +
-====TopItem==== +
- // (Anciennement ListBoxSetTopItem, désormais obsolète) // \\ \\ +
   
-  int ListBox.TopItem+  int Slider.Value;
-Retourne/Définit la ligne du haut dans la liste. La ligne du haut est la première ligne +Retourne/Définit la valeur de la barre de défilement spécifiée. 
-visible dans la liste, qui varie donc lorsque vous la faîtes défiler vers le haut ou vers le bas.\\ \\  +Vous utiliserez généralement ceci dans la fonction interface_click 
-Les valeurs pour TopItem commencent à 0 pour la première ligne de la liste.\\ \\ +pour déterminer à quelle valeur le joueur a placé le curseur de la barre, 
 +afin d'exécuter la commande appropriée.\\ \\  
 +En définissant cette valeur, la nouvelle valeur doit être comprise entre les valeurs 
 +MIN et MAX de la barre, telles que définies dans l'éditeur de GUI.\\ \\
Exemple : Exemple :
   
-  lstPartiesSauvees.TopItem = 0;+  SetMusicMasterVolume(sldVolume.Value);
-fera automatiquement défiler la liste // lstPartiesSauvees // tout en haut.+réglera le volume générale de la musique à la valeur de la barre de défilement // sldVolume //.\\ \\  
 + // Voir aussi : // [[Label#Text|Label.Text]]
{{tag>français}} {{tag>français}}
 
slider.txt · Dernière modification: 11/10/2012 16:15 par kitai
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki