docs/api/XCEngine/Components/GameObject/IsActive.md

# GameObject::IsActive

返回对象自身的 `activeSelf` 状态。

```cpp
bool IsActive() const;
```

## 行为说明

这个接口只读 `m_activeSelf`，不考虑父对象状态。

因此：

- 返回 `true` 不代表对象一定在运行
- 只要父链中有对象失活，[IsActiveInHierarchy](IsActiveInHierarchy.md) 仍可能返回 `false`

## 返回值

- `true` - 对象自身处于激活状态。
- `false` - 对象自身被显式关闭。

## 相关文档

- [SetActive](SetActive.md)
- [IsActiveInHierarchy](IsActiveInHierarchy.md)
refactor api documentation structure 2026-03-26 16:45:24 +08:00			`# GameObject::IsActive`

docs: expand gameobject helper docs 2026-04-03 16:11:48 +08:00			返回对象自身的 `activeSelf` 状态。
refactor api documentation structure 2026-03-26 16:45:24 +08:00
			```cpp
			`bool IsActive() const;`
			```

docs: expand gameobject helper docs 2026-04-03 16:11:48 +08:00			`## 行为说明`
refactor api documentation structure 2026-03-26 16:45:24 +08:00
docs: expand gameobject helper docs 2026-04-03 16:11:48 +08:00			这个接口只读 `m_activeSelf`，不考虑父对象状态。
refactor api documentation structure 2026-03-26 16:45:24 +08:00
docs: expand gameobject helper docs 2026-04-03 16:11:48 +08:00			`因此：`
refactor api documentation structure 2026-03-26 16:45:24 +08:00
docs: expand gameobject helper docs 2026-04-03 16:11:48 +08:00			- 返回 `true` 不代表对象一定在运行
			- 只要父链中有对象失活，[IsActiveInHierarchy](IsActiveInHierarchy.md) 仍可能返回 `false`
refactor api documentation structure 2026-03-26 16:45:24 +08:00
docs: expand gameobject helper docs 2026-04-03 16:11:48 +08:00			`## 返回值`
refactor api documentation structure 2026-03-26 16:45:24 +08:00
docs: expand gameobject helper docs 2026-04-03 16:11:48 +08:00			- `true` - 对象自身处于激活状态。
			- `false` - 对象自身被显式关闭。
refactor api documentation structure 2026-03-26 16:45:24 +08:00
			`## 相关文档`

docs: expand gameobject helper docs 2026-04-03 16:11:48 +08:00			`- [SetActive](SetActive.md)`
			`- [IsActiveInHierarchy](IsActiveInHierarchy.md)`