Ceci est une ancienne révision du document !
int Dialog.DisplayOptions(optional DialogOptionSayStyle)Présente les options de ce dialogue à l'utilisateur et attend qu'il en sélectionne une. Le numéro de l'option sélectionné est retourné.
int resultat = dVieilHomme.DisplayOptions(); if (resultat == DIALOG_PARSER_SELECTED) { Display("Quelque chose a été entré dans l'analyseur de texte !"); } else { Display("C'est l'option numéro %d qui a été choisie.", resultat); }
affichera les options du dialogue dOldMan et affichera un message selon ce que
le joueur a sélectionné.
Compatibilité : Supporté par AGS 3.0.2 et les versions plus récentes.
Voir aussi : Dialog.Start,
Parser.ParseText
(Anciennement global function GetDialogOption, désormais obsolète)
Dialog.GetOptionState(int option)
Retourne si une option d'une conversation est disponible pour le joueur ou non.
OPTION correspond au numéro de l'option dans le dialogue, de 1 à la plus haut valeur
de l'option pour ce sujet.
La valeur retournée peut avoir les valeurs suivantes :
eOptionOff L'option est désactivée - le joueur ne la verra pas eOptionOn L'option est activée - le joueur peut la voir et l'utiliser eOptionOffForever L'option est désactivée en permanence - aucune commande ne peut la réactiver.
Ce sont les mêmes valeurs que celles passées à Dialog.SetOptionState.
Exemple :
if (dJoeEnerve.GetOptionState(2) != eOptionOn) Display("C'est désactivé !");
affichera un message si l'option 2 du dialogue dJoeEnerve n'est pas actuellement accessible.
Voir aussi : Dialog.SetOptionState
String Dialog.GetOptionText(int option)Retourne le texte de l'option de dialogue spécifiée.
String texteOption = dJoeDupont.GetOptionText(3); Display("L'option 3 du dialogue dJoeDupont est %s!", texteOption);
affichera le texte de la troisième option du dialogue dJoeDupont.
Compatibilité : Supporté par AGS 3.0.2 et les versions plus récentes.
Voir aussi : Dialog.OptionCount,
Dialog.GetOptionState
readonly int Dialog.ID;Retourne le numéro ID du dialogue tel qu'affiché dans l'éditeur.
Display("dPecheur est le dialogue numéro %d !", dPecheur.ID);
affichera le numéro ID du dialogue dFisherman.
Compatibilité : Supporté par AGS 3.1.0 et les versions plus récentes.
readonly int Dialog.OptionCount;Retourne le nombre d'option que contient ce dialogue.
Display("dPecheur a %d options !", dPecheur.OptionCount);
affichera le nombre d'options dans le dialogue dFisherman.
Compatibilité : Supporté par AGS 3.0.2 et les versions plus récentes.
Voir aussi : Dialog.GetOptionText,
Dialog.GetOptionState
(Anciennement fonction globale SetDialogOption, désormais obsolète)
Dialog.SetOptionState(int option, DialogOptionState)
Active/Désactive une option dans une conversation.
Ceci vous permet d'ajouter des options supplémentaires à une conversation
une fois que le joueur a accompli certaines choses.
OPTION est le numéro de l'option dans le sujet, de 1 à la plus haute valeur
d'option pour ce sujet.
DialogOptionState indique ce qui doit arriver à cette option. Elle peut prendre
les valeurs suivantes :
eOptionOff L'option est désactivée - le joueur ne la verra pas eOptionOn L'option est activée - le joueur peut la voir et l'utiliser eOptionOffForever L'option est désactivée en permanence - aucune commande ne peut la réactiver.
Elles sont équivalentes aux commandes de dialogue option-off, option-on
et option-off-forever.
Exemple :
if (GetGlobalInt(10)==1) dialog[4].SetOptionState(2, eOptionOn);
activera l'option 2 du sujet numéro 4 si la variable entière globale 10 vaut 1.
Voir aussi : Dialog.GetOptionState,
Dialog.Start, StopDialog
(Anciennement global function RunDialog, désormais obsolète)
Dialog.Start()
Lance une conversation à partir du sujet spécifié.
NOTE : La conversation ne démarrera pas immédiatement ; plutôt, elle sera
exécutée lorsque la fonction de script courante sera achevée.
Si vous utilisez cette commande depuis une fonction dialog_request, elle
aura pour effet de lancer ce nouveau sujet une fois que le script sera terminé.
Exemple :
dMarchand.Start();
lancera le sujet de conversation nommé dMarchand.
Voir aussi : Dialog.DisplayOptions,
Dialog.SetOptionState
StopDialog ()Cette commande ne peut être utilisée que depuis une fonction dialog_request. Elle dit à AGS que lorsque dialog_request est terminée, l'intégralité de la conversation devrait s'arrêter plutôt que continuer à exécuter le script du dialogue.
function dialog_request (int dr) { if (dr==1) { cEgo.AddInventory(iAffiche); StopDialog(); }
donnera l'objet d'inventaire iAffiche au joueur puis terminera la conversation.
Voir aussi : Dialog.SetOptionState