docs: sync editor viewport host docs

This commit is contained in:
2026-04-04 00:41:13 +08:00
parent 468dbfa7ac
commit 8abca3dec5
28 changed files with 2340 additions and 40 deletions

View File

@@ -0,0 +1,36 @@
# Application::CanReimportProjectAsset
判断给定项目路径当前是否支持显式重导。
```cpp
bool CanReimportProjectAsset(const std::string& assetPath) const;
```
## 当前行为
- `assetPath` 为空时直接返回 `false`
- 否则转发到:
```cpp
::XCEngine::Resources::ResourceManager::Get().CanReimportProjectAsset(assetPath.c_str())
```
## 返回值语义
当前返回 `true` 的前提是:
- Editor 已绑定有效项目根目录
- 传入路径非空
- 底层 `ResourceManager / AssetImportService` 能识别该路径对应的可导入资源类型
因此它更像“是否可以发起重导”的前置检查,而不是是否一定会导入成功的承诺。
## 当前用途
这个方法适合给菜单命令、项目浏览器右键菜单或批处理工具做启用态判断,避免对目录、未知 importer 或空路径直接发起重导。
## 相关文档
- [Application](Application.md)
- [ReimportProjectAsset](ReimportProjectAsset.md)
- [ResourceManager](../../Core/Asset/ResourceManager/ResourceManager.md)