Ceci est une ancienne révision du document !
(Anciennement ListBoxAdd, désormais obsolète)
ListBox.AddItem(string nouvelleLigne)
Ajoute NOUVELLELIGNE à la liste spécifiée. La ligne sera ajoutée à la fin
de la liste.
NOTE: Les listes ont une limite de 200 lignes. Si vous essayez d'en ajouter plus que ça,
cette fonction retournera false et la ligne ne sera pas ajoutée.
Exemple :
String entree = txtEntreeJoueur.Text; lstChoix.AddItem(entree);
récupérera l'entrée de l'utilisateur et l'ajoutera à la liste.
Voir aussi : ListBox.Clear,
ListBox.FillDirList,
ListBox.InsertItemAt,
ListBox.Items,
ListBox.RemoveItem
(Anciennement ListBoxClear, désormais obsolète)
ListBox.Clear()
Supprime toutes les lignes de la liste spécifiée.
Exemple :
lstCarnet.Clear();
supprimera toutes les lignes de la liste lstCarnet .
Voir aussi : ListBox.AddItem
(Anciennement ListBoxDirList, désormais obsolète)
ListBox.FillDirList(string filemask)
Remplit la liste avec une série des noms de fichiers correspondant
à FILEMASK dans le répertoire courant. Ceci peut être utile si vous
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 :
lstPartiesSauvees.FillDirList("agssave.*");
remplira la liste avec les parties sauvegardées. Notez que vous utiliseriez plutôt
FillSaveGameList pour cette de tâche.
Voir aussi : ListBox.AddItem, ListBox.Clear,
ListBox.FillSaveGameList
(Anciennement ListBoxSaveGameList, désormais obsolète)
ListBox.FillSaveGameList()
Remplit la liste spécifiée avec les parties sauvegardées, triées correctement
de la plus récente (en haut) à la moins récente (en bas).
La propriété SaveGameSlots est mise à jour pour contenir
le numéro du bloc de sauvegarde de chaque index dans la liste, vous pouvez donc faire :
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 :
lstPartiesSauvees.FillSaveGameList();
will fill listbox lstPartiesSauvees with the list of the saved games.
Voir aussi : ListBox.FillDirList,
ListBox.ItemCount,
ListBox.SaveGameSlots,
ListBox.SelectedIndex
ListBox.GetItemAtLocation(int x, int y)Détermine quelle ligne dans la liste est aux coordonnées (X,Y). Ceci vous permet de trouver quelle ligne la souris survole, par exemple.
int index = lstOptions.GetItemAtLocation(mouse.x, mouse.y); 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.
Voir aussi : ListBox.SelectedIndex
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é.
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.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 à 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.FillDirList
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.
lstTest.ScrollDown();
fait défiler la liste lstTest d'un cran vers le bas.
Voir aussi : ListBox.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.
lstTest.ScrollUp();
fait défiler la liste lstTest d'un cran vers le haut.
Voir aussi : ListBox.ScrollDown
FontType ListBox.FontRetourne/Définit la police utilisée par la liste spécifiée.
lstPartiesSauvees.Font = eFontSpeech;
fera utiliser la police “Speech” à la liste lstPartiesSauvees .
Voir aussi : Label.Font, TextBox.Text
bool ListBox.HideBorderRetourne/Définit si les bordures de la liste sont cachées.
lstPartiesSauvees.HideBorder = true;
cachera les bordures entourant la liste des Parties Sauvées.
Voir aussi : ListBox.HideScrollArrows
bool ListBox.HideScrollArrowsRetourne/Définit si les flèches de défilement sont cachées ou non.
lstPartiesSauvees.HideScrollArrows = true;
cachera les flèches de défilement pré-fournies de la liste.
Voir aussi : ListBox.HideBorder
(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
(Anciennement ListBoxGetItemText, désormais obsolète)
(Anciennement ListBox.GetItemText, 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.
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.ItemCount,
ListBox.AddItem
readonly int ListBox.RowCountRetourne 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.
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.ScrollDown,
ListBox.ScrollUp
(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.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.
(Anciennement ListBoxSetTopItem, désormais obsolète)
int ListBox.TopItem
Retourne/Définit la ligne du haut dans la liste. La ligne du haut est la première ligne
visible dans la liste, qui varie donc lorsque vous la faîtes défiler vers le haut ou vers le bas.
Les valeurs pour TopItem commencent à 0 pour la première ligne de la liste.
Exemple :
lstPartiesSauvees.TopItem = 0;
fera automatiquement défiler la liste lstPartiesSauvees tout en haut.