[[ags|{{:contents.gif}}]] [[scripting|{{:up.gif}}]] [[textbox|{{:back.gif}}]] [[inventoryitem|{{:forward.gif}}]] ---- =====Fonctions et propriétés des Hotspots===== ====GetAtScreenXY==== //(Anciennement fonction globale GetHotspotAt, désormais obsolète)//\\ \\ static Hotspot* Hotspot.GetAtScreenXY(int x, int y) Retourne le hotspot se trouvant aux coordonnées (X,Y) à l'ECRAN. S'il n'y a aucun hotspot à cet endroit, ou si des coordonnées invalides ont été spécifiées, la variable Hotspot* représentant le hotspot 0 sera retourné.\\ \\ **NOTE :** Les coordonnées sont celles de l'ECRAN, PAS celles de la PIECE. Cela signifie que dans une pièce plus grande que l'écran, les coordonnées que vous passerez seront relatives à la position actuelle de l'écran, et ne seront PAS les coordonnées absolues de la pièce. Ceci signifie qu'il convient d'utiliser cette fonction avec les coordonnées du curseur.\\ \\ Exemple : if (Hotspot.GetAtScreenXY(mouse.x, mouse.y) == hPorte) Display("La souris survole la porte."); else if (Hotspot.GetAtScreenXY(mouse.x, mouse.y) != hotspot[0]) Display("La souris survole quelque chose (mais pas la porte) !"); else Display("La souris ne survole aucun hostpot."); affichera un message selon ce que survole le curseur de la souris.\\ \\ //Voir Aussi :// [[Game#GetLocationName|Game.GetLocationName]], [[Game#GetLocationType|GetLocationType]]\\ ---- ====GetProperty==== //(Anciennement GetHotspotProperty, désormais obsolète)//\\ \\ Hotspot.GetProperty(string propriété) Retourne la valeur de la propriété personnelle PROPRIETE du hotspot.\\ \\ Cette commande ne fonctionne qu'avec les propriétés numériques (retourne un nombre), et avec les booléennes (retourne 1 si la case est cochée, sinon 0).\\ \\ Utilisez la fonction équivalente GetTextProperty pour obtenir une propriété textuelle.\\ \\ Exemple : if (hotspot[1].GetProperty("Valeur") > 200) Display("La valeur du Hotspot 1 est supérieure à 200 !"); afficher le message si la propriété "Valeur" du hotspot 1 est supérieure à 200.\\ \\ //Voir Aussi :// [[Hotspot#GetTextproperty (hotspot)|Hotspot.GetTextpropriété]]\\ \\ ---- ====GetTextProperty==== //(Anciennement GetHotspotPropertyText, désormais obsolète)// //(Anciennement Hotspot.GetPropertyText, désormais obsolète)//\\ \\ String Hotspot.GetTextProperty(string propriété) Retourne la valeur de la propriété personnelle PROPRIETE du hotspot.\\ \\ Cette commande ne fonctionne qu'avec les propriétés textuelles. Le texte de la propriété sera retourné par cette fonction.\\ \\ Utilisez la fonction équivalente GetProperty pour obtenir une propriété numérique.\\ \\ Exemple : String description = hotspot[2].GetTextProperty("Description"); Display("Description du Hotspot 2 : %s", description); récupérera la "description" du hostpot 2 et l'affichera.\\ \\ //Voir Aussi :// [[Hotspot#Getproperty (hotspot)|Hotspot.Getpropriété]]\\ \\ \\ \\ ---- ====RunInteraction==== //(Anciennement RunHotspotInteraction, désormais obsolète)//\\ \\ Hotspot.RunInteraction(CursorMode) Lancera l'événement associé au mode du curseur passé dans la liste des interactions, comme si le joueur avait cliqué sur le hotspot avec le mode de curseur spécifié. Peut être utile avec le parseur de texte pour simuler un clic de souris si un texte spécifique est entré.\\ \\ Exemple : hPorte.RunInteraction(eModeLook); lancera le code contenu dans l'interaction "Look At Hotspot" pour le hotspot hPorte.\\ \\ //Voir Aussi :// [[Game#ProcessClick|ProcessClick]], [[Character#RunInteraction|Character.RunInteraction]], [[Object#RunInteraction|Object.RunInteraction]]\\ \\ ---- ====Enabled==== //(Anciennement DisableHotspot, désormais obsolète)// //(Anciennement EnableHotspot, désormais obsolète)//\\ \\ bool Hotspot.Enabled Active/Désactive le hotspot spécifié. Si vous définissez cette propriété à //false//, toutes les zones de l'écran qui correspondaient auparavant au hotspot seront alors considérées comme de type 0 (aucun hotspot). Vous pouvez ensuite réactiver le hotspot en donnant la valeur //true// à la propriété.\\ \\ Ce réglage persiste dans le jeu ; cela signifie que le hotspot ne sera pas réinitialisé lorsque le joueur entrera une nouvelle fois dans la pièce.\\ \\ La valeur par défaut de cette propriété est toujours //true//.\\ \\ Exemple : hArbreBrun.Enabled = false; désactivera le hotspot hArbreBrun.\\ \\ //Voir Aussi :// [[Region#Enabled|Region.Enabled]], [[Room#RemoveWalkableArea|RemoveWalkableArea]], [[Room#RestoreWalkableArea|RestoreWalkableArea]]\\ \\ ---- ====ID==== readonly int Hotspot.ID Retourne le numéro d'identification de ce hotspot. Ceci vous permet d'utiliser de l'ancien code ayant recourt à des fonctions utilisant les numéros des hotspots.\\ \\ Exemple : Display("Le numéro du hotspot hPorte est le numéro %d.", hPorte.ID); Display("Le hotspot 3 a pour numéro %d.", hotspot[3].ID); affichera le numéro d'identification du hotspot hPorte, puis affichera le numéro d'identification du hotspot 3 (qui sera évidemment 3).\\ \\ //Voir Aussi :// [[Hotspot#GetAtScreenXY (hotspot)|Hotspot.GetAtScreenXY]]\\ \\ ---- ====Name==== //(Anciennement GetHotspotName, désormais obsolète)// //(Anciennement Hotspot.GetName, désormais obsolète)//\\ \\ readonly String Hotspot.Name; Retourne le nom du hotspot.\\ \\ Cette propriété est en lecture seule ; il n'est pour le moment pas possible de changer le nom du hotspot en cours de jeu.\\ \\ Exemple : Display("Le nom du hotspot 3 est %s.", hotspot[3].Name); récupérera puis affichera le nom du hotspot 3.\\ \\ //Voir Aussi :// [[Game#GetLocationName|Game.GetLocationName]]\\ \\ ---- ====WalkToX==== //(Anciennement GetHotspotPointX, désormais obsolète)//\\ \\ readonly int Hotspot.WalkToX Retourne la coordonnée de pièce X du point d'accès au hotspot (walk-to point). Si le hotspot n'en a pas, retourne -1.\\ \\ Exemple : player.Walk(hTable.WalkToX, hTable.WalkToY, eBlock, eWalkableAreas); déplacera le personnage joueur au point d'accès ("walk-to point") du hotspot hTable.\\ \\ //Voir Aussi :// [[Hotspot#WalkToY propriété|Hotspot.WalkToY]], [[Game#MoveCharacterToHotspot|MoveCharacterToHotspot]]\\ \\ ---- ====WalkToY==== //(Anciennement GetHotspotPointY, désormais obsolète)//\\ \\ readonly int Hotspot.WalkToY Retourne la coordonnée de pièce Y du point d'accès au hotspot (walk-to point). Si le hotspot n'en a pas, retourne -1.\\ \\ Exemple : player.Walk(hTable.WalkToX, hTable.WalkToY, eBlock, eWalkableAreas); déplacera le personnage joueur au point d'accès ("walk-to point") du hotspot hTable.\\ \\ // Voir Aussi : // [[Hotspot#WalkToX propriété|Hotspot.WalkToX]], [[Game#MoveCharacterToHotspot|MoveCharacterToHotspot]]\\ \\ {{tag>français}}