GFMoveTweenAction¶
API Reference / Action Queue / 类索引
- 路径：
addons/gf/extensions/action_queue/actions/gf_move_tween_action.gd - 模块：
Action Queue - 继承：
GFVisualAction - API：
public - 类别：运行时句柄 (
runtime_handle) - 首次版本：
3.17.0
通用节点移动 Tween 动作。 将目标节点的指定位置属性缓动到目标值，适合卡牌、棋子、UI 面板等 常见表现动作。默认等待 Tween 完成后队列才会继续。
成员概览¶
| 类型 | 名称 | 签名 |
|---|---|---|
| 属性 | target |
var target: Node |
| 属性 | target_position |
var target_position: Variant |
| 属性 | duration |
var duration: float = 0.2 |
| 属性 | property_name |
var property_name: NodePath = ^"position" |
| 属性 | transition_type |
var transition_type: Tween.TransitionType = Tween.TRANS_CUBIC |
| 属性 | ease_type |
var ease_type: Tween.EaseType = Tween.EASE_OUT |
| 方法 | execute |
func execute() -> Variant: |
| 方法 | cancel |
func cancel() -> void: |
| 方法 | pause |
func pause() -> void: |
| 方法 | resume |
func resume() -> void: |
| 方法 | finish |
func finish() -> void: |
| 方法 | get_wait_guard_node |
func get_wait_guard_node() -> Node: |
属性¶
target¶
- API：
public
被移动的目标节点。
target_position¶
- API：
public
要写入的位置值，通常为 Vector2 或 Vector3。
结构：
target_position: Variant，可写入 property_name 的目标位置值，通常为 Vector2、Vector3 或 float。
duration¶
- API：
public
Tween 持续时间。
property_name¶
- API：
public
要缓动的属性名。
transition_type¶
- API：
public
Tween 过渡类型。
ease_type¶
- API：
public
Tween 缓动类型。
方法¶
execute¶
- API：
public
执行移动 Tween。
返回：需要等待时返回内部完成 Signal；目标无效、配置无效或瞬时写入时返回 null。
结构：
return: Variant，返回内部完成 Signal 或 null。
cancel¶
- API：
public
取消当前 Tween 并释放等待者。
pause¶
- API：
public
暂停当前 Tween。
resume¶
- API：
public
恢复当前 Tween。
finish¶
- API：
public
立即推进并完成当前 Tween。
get_wait_guard_node¶
- API：
public
获取用于保护等待生命周期的目标节点。
返回：有效目标节点；无效时返回 null。