TouchScreenButton

TouchScreenButton

Inherits: Node2D < CanvasItem < Node < Object

触摸屏设备的按钮，供游戏使用。

描述

TouchScreenButton允许你为触摸设备创建屏幕上的按钮。其为游戏使用，比如在必须触摸才能移动的设备。与Button不同，TouchScreenButton原生支持多点触摸。几个TouchScreenButton可以通过触摸输入同时被按下。

这个节点继承自Node2D。与Control节点不同，你不能在它上面设置锚点。如果要创建菜单或用户界面，可用Button节点代替。为了使按钮节点对触摸事件作出反应，可在项目设置中启用模拟鼠标选项。

可将TouchScreenButton配置为只在触摸设备上可见，有助你同时为桌面和移动设备开发游戏。

属性

String	action	`“”`
BitMap	bitmask
Texture	normal
bool	passby_press	`false`
Texture	pressed
Shape2D	shape
bool	shape_centered	`true`
bool	shape_visible	`true`
VisibilityMode	visibility_mode	`0`

方法

bool	is_pressed ( ) const

信号

pressed ( )

当按钮被按下时触发，即向下。

released ( )

当按钮被释放时触发，即向上。

枚举

enum VisibilityMode:

VISIBILITY_ALWAYS = 0 —- 始终可见。
VISIBILITY_TOUCHSCREEN_ONLY = 1 —- 仅在触摸屏上可以看到。

属性说明

String action

Default	`“”`
Setter	set_action(value)
Getter	get_action()

按钮的动作。动作可以用InputEventAction来处理。

BitMap bitmask

Setter	set_bitmask(value)
Getter	get_bitmask()

按钮的bit位掩码。

Texture normal

Setter	set_texture(value)
Getter	get_texture()

该按钮在正常状态下的纹理。

bool passby_press

Default	`false`
Setter	set_passby_press(value)
Getter	is_passby_press_enabled()

如果true，只要按下的手指进出按钮，就会发出 pressed 和released ]信号，即使压力开始于按钮的有效区域之外。

注意：这是一种 “pass-by” 的按压模式，而不是 “bypass”。

Texture pressed

Setter	set_texture_pressed(value)
Getter	get_texture_pressed()

按钮在被按下状态时的纹理。

Shape2D shape

Setter	set_shape(value)
Getter	get_shape()

该按钮的形状。

bool shape_centered

Default	`true`
Setter	set_shape_centered(value)
Getter	is_shape_centered()

如果true，按钮的形状会在提供的纹理中居中。如果没有使用纹理，这个属性就没有效果。

bool shape_visible

Default	`true`
Setter	set_shape_visible(value)
Getter	is_shape_visible()

如果true，按钮的形状是可见的。

VisibilityMode visibility_mode

Default	`0`
Setter	set_visibility_mode(value)
Getter	get_visibility_mode()

按钮的可见性模式。有关可能的值，参阅VisibilityMode。

方法说明

bool is_pressed ( ) const

如果这个按钮当前被按下，则返回true。