TouchScreenButton¶
Inherits: Node2D < CanvasItem < Node < Object
触摸屏设备的按钮,供游戏使用。
描述¶
TouchScreenButton允许你为触摸设备创建屏幕上的按钮。其为游戏使用,比如在必须触摸才能移动的设备。与Button不同,TouchScreenButton原生支持多点触摸。几个TouchScreenButton可以通过触摸输入同时被按下。
这个节点继承自Node2D。与Control节点不同,你不能在它上面设置锚点。如果要创建菜单或用户界面,可用Button节点代替。为了使按钮节点对触摸事件作出反应,可在项目设置中启用模拟鼠标选项。
可将TouchScreenButton配置为只在触摸设备上可见,有助你同时为桌面和移动设备开发游戏。
属性¶
|
||
|
||
|
||
|
||
|
方法¶
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 |
|
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 |
|
Setter |
set_shape_centered(value) |
Getter |
is_shape_centered() |
如果true
,按钮的形状会在提供的纹理中居中。如果没有使用纹理,这个属性就没有效果。
bool shape_visible
Default |
|
Setter |
set_shape_visible(value) |
Getter |
is_shape_visible() |
如果true
,按钮的形状是可见的。
VisibilityMode visibility_mode
Default |
|
Setter |
set_visibility_mode(value) |
Getter |
get_visibility_mode() |
按钮的可见性模式。有关可能的值,参阅VisibilityMode。
方法说明¶
bool is_pressed ( ) const
如果这个按钮当前被按下,则返回true
。