Files
XCEngine/docs/api/XCEngine/Components/GameObject/DetachFromParent.md

27 lines
588 B
Markdown
Raw Normal View History

2026-03-26 16:45:24 +08:00
# GameObject::DetachFromParent
2026-04-03 16:11:48 +08:00
把当前对象从父节点分离,并保持世界空间变换。
2026-03-26 16:45:24 +08:00
```cpp
void DetachFromParent();
```
2026-04-03 16:11:48 +08:00
## 行为说明
2026-03-26 16:45:24 +08:00
2026-04-03 16:11:48 +08:00
当前实现很直接:
2026-03-26 16:45:24 +08:00
2026-04-03 16:11:48 +08:00
- 如果当前没有父节点,直接返回
- 否则调用 `SetParent(nullptr, true)`
2026-03-26 16:45:24 +08:00
2026-04-03 16:11:48 +08:00
因此它的真实语义是:
2026-03-26 16:45:24 +08:00
2026-04-03 16:11:48 +08:00
- 把对象提升为根对象,或在无场景时变成无父独立对象
- 保持当前世界空间位置/旋转/缩放
- 同步更新场景根列表与层级激活态传播
2026-03-26 16:45:24 +08:00
## 相关文档
2026-04-03 16:11:48 +08:00
- [SetParent](SetParent.md)
- [GetParent](GetParent.md)
- [DetachChildren](DetachChildren.md)