clickable_add_ext

语法:

clickable_add_ext(x, y, tpe, url, target, params, scale, alpha);


参数 描述
x 窗口中的 x 位置
y 窗口中的 y 位置
tpe 要使用的精灵的纹理页条目(使用 sprite_get_tpe)。
url 要链接的 URL(网站地址)或要运行的脚本。
target 这是打开 URL 的目标区域(请参阅说明)。
params 图标的各种参数(参见说明)。
scale 图标的比例(默认为 1)。
alpha 图标的图像 alpha(透明度) 值(默认值为 1)。


返回: Real(实数)


描述

使用此功函数,你可以创建一个自定义的可单击图标,该图标充当游戏画布外部的 “按钮”,但在浏览器窗口内。该函数将返回一个 id 值,该值必须存储在一个变量中,以便在引用新图标的所有其他按钮函数中使用。此函数对于防止浏览器在单击按钮时创建弹出窗口非常有用,因为它通过 GameMaker Studio 2 本身完成。

此函数与 clickable_add 函数完全相同,其中你必须设置相对于浏览器窗口的 (0, 0) 的位置,给出你希望按钮图标具有的精灵纹理页条目(参见:sprite_get_tpe),指定要打开的URL或要打开或运行的脚本(来自 GameMaker Studio 2 的资源树),然后设置要使用的目标和参数。但是,这个函数还有两个额外的选项,允许你将图标 alpha 从 0(完全透明)设置为1(完全不透明),以及图标的比例,图标比例是应用于所使用的精灵的倍数值。因此,值 1 是默认比例,而(例如)0.5 是一半比例,2 是双倍比例。

同样值得注意的是,如果你传入的 URL 参数是脚本的名称(即:它不是以 “http://” 开头),并且脚本名为 gmcallback_*,那么你可以直接输入 html5 事件。如果 GameMaker Studio 2 函数名称以 gmcallback_ 开头,则 进行模糊处理。


例如:

home_but = clickable_add_ext(32, 32, sprite_get_tpe(spr_MS_Home, 0), "http://macsweeney_games.com", "_blank", "width=700, height=500, menubar=0, toolbar=0, scrollbars=0", 2, 0.5);

上面的代码在游戏画布所在页面的 (32, 32) 位置创建了一个可单击的 DOM 图标。该图标使用的精灵为纹理页面中引用的 “spr_MS_Home”,当单击该图标时,它将为指定的 URL 打开一个新窗口,并带有该窗口的已定义属性。该按钮还将缩放到原始精灵大小的两倍,透明度为原图像的一半。