clickable_add(x, y, tpe, url, target, params);
| Argument | La description |
|---|---|
| x | La position x dans la fenêtre. |
| y | La position y dans la fenêtre. |
| tpe | L'entrée de la page de texture pour l'image-objet à utiliser (utiliser sprite_get_tpe ). |
| url | L'URL (adresse du site Web) à lier, ou le script à exécuter. |
| target | C'est la zone cible pour ouvrir l'URL (voir description). |
| params | Les différents paramètres de l'icône (voir description). |
Retours: Real
Avec cette fonction, vous pouvez créer une icône personnalisée, cliquable, qui agit comme un «bouton» en dehors du canevas du jeu, mais dans la fenêtre du navigateur elle-même. La fonction renverra une valeur d'identifiant qui doit être stockée dans une variable à utiliser dans toutes les autres fonctions de bouton faisant référence à la nouvelle icône. Cette fonction est très utile pour empêcher le navigateur de créer une fenêtre pop-up lorsque vous cliquez sur le bouton, car tout est fait via GameMaker: Studio lui-même.
Vous devez d'abord définir la position, qui est relative à la (0,0) de la fenêtre du navigateur (coin supérieur gauche), puis donner l'entrée de la page de texture pour l'image-objet que vous souhaitez voir figurer dans l'image (voir: sprite_get_tpe ). Vous pouvez ensuite spécifier une URL à ouvrir ou un script (à partir de l'arborescence de ressources de GameMaker: Studio ) à ouvrir ou à exécuter. Le paramètre "target" que vous spécifiez est identique à la valeur "nom" JavaScript standard lorsque vous utilisez le open() méthode (sachez que tout sauf '_self' peut entraîner le blocage du navigateur, ou demander à l'utilisateur s'il souhaite l'autoriser) et l'argument "params" est le même que le paramètre JavaScript "specs" pour contrôler les propriétés du nouveau fenêtre / onglet devrait s'afficher (tous les navigateurs ne peuvent pas supporter toutes les fonctionnalités). Si vous utilisez l'icône pour exécuter un script interne, ces deux derniers arguments peuvent être laissés comme des chaînes vides "".
Les cibles valides sont:
| Cible | La description |
|---|---|
| _blanc | Ouvre le document lié dans une nouvelle fenêtre ou un nouvel onglet. |
| _soi | Ouvre le document lié dans le même cadre que celui sur lequel il a été cliqué (c'est par défaut). |
| _parent | Ouvre le document lié dans le cadre parent. |
| _Haut | Ouvre le document lié dans tout le corps de la fenêtre. |
Les paramètres valides sont:
| Paramètres | La description |
|---|---|
| 'height = [ px ]' | La hauteur de la fenêtre, avec la valeur minimale étant 100. |
| 'width = [ px ]' | La largeur de la fenêtre, avec la valeur minimale étant 100. |
| 'left = [ px ]' | La position gauche de la fenêtre. |
| 'top = [ px ]' | La position supérieure de la fenêtre (IE uniquement). |
| 'location = [ booléen ]' | Affichage ou non du champ d'adresse (la valeur par défaut est 1) |
| 'menubar = [ booléen ]' | Affichage ou non de la barre de menu (la valeur par défaut est 1) |
| 'resizable = [ booléen ]' | Si la fenêtre est redimensionnable ou non (la valeur par défaut est 1). |
| 'scrollbars = [ booléen ]' | Affichage ou non des barres de défilement (la valeur par défaut est 1) |
| 'status = [ booléen ]' | Ajout ou non d'une barre d'état (la valeur par défaut est 1) |
| 'titlebar = [ booléen ]' | Si oui ou non pour afficher la barre de titre. Ceci est ignoré sauf si l'application appelante est une application HTML ou une boîte de dialogue de confiance (la valeur par défaut est 1); |
| 'toolbar = [ booléen ]' | Affichage ou non de la barre d'outils du navigateur (la valeur par défaut est oui) |
Il est également intéressant de noter que si l'argument URL que vous transmettez est le nom d'un script (c'est-à-dire: il ne commence pas par "http: //") ET que le script est appelé gmcallback_* alors vous pouvez obtenir des flux directs dans un événement html5. GameMaker: les noms de fonctions Studio ne sont pas masqués s'ils commencent par gmcallback_.
home_but = clickable_add(32, 32, sprite_get_tpe(spr_MS_Home, 0), "http://macsweeney_games.com", "_blank", "width=700, height=500, menubar=0, toolbar=0, scrollbars=0");
Le code ci-dessus crée une icône DOM cliquable à la position (32, 32) de la page sur laquelle le canevas de jeu s'exécute. L'icône utilise le sprite référencé à partir de la page de texture comme "spr_MS_Home" et lorsque vous cliquez dessus, l'icône ouvre une nouvelle fenêtre pour l'URL spécifiée et avec les propriétés définies pour cette fenêtre.