探索与创造:ImGuiFileDialog——优雅的文件选择对话框库
项目地址:https://gitcode.com/gh_mirrors/im/ImGuiFileDialog
1、项目介绍
ImGuiFileDialog是一个专为Dear ImGui设计的文件选择对话框库,它的核心目标是提供一个定制化程度极高的界面,让你可以根据文件类型添加自定义控件。这个项目由aiekick开发并维护,支持Windows、Linux和MacOS平台,并且兼容Emscripten,可在Web环境中运行。
2、项目技术分析
ImGuiFileDialog基于Dear ImGui,并紧密跟随其主分支和Docking分支进行更新,目前版本对应于ImGui 1.90.1。它不需要单独编译,可以直接将源代码整合到你的项目中,简化了集成过程。在Windows环境下,项目依赖于dirent v1.23来实现目录操作。
项目结构清晰,分为Master
分支(库本身)和DemoApp
分支(演示应用),方便开发者理解和使用。CMake构建系统也已整合,轻松集成到各种项目中。
3、项目及技术应用场景
如果你正在开发一个使用Dear ImGui的图形界面工具或游戏引擎,那么ImGuiFileDialog能够帮助你创建功能强大的文件选择界面。例如,你可以:
- 自定义文件选择面板,根据文件扩展名显示特定的组件。
- 实现多选模式,通过Ctrl/Shift键选择多个文件。
- 在不同的操作系统上展示一致的用户体验。
- 轻松切换文件过滤器,通过预设或自定义规则筛选文件。
- 使用键盘导航、字符输入探索文件,以及快速访问路径中的某个元素。
- 集成缩略图查看,增强视觉体验。
4、项目特点
- C API:除了C++接口,还提供了C语言API,方便不同语言环境下的使用。
- 灵活的调用与显示分离:可以设置多个函数调用,但只需要一个显示函数。
- 自定义扩展:允许创建自定义面板,动态调整界面,甚至根据当前过滤器和用户数据呈现不同内容。
- 多种操作系统支持:包括Windows、Linux、MacOS和Web浏览器。
- 丰富的特性:支持模态对话框、文件和目录选择、过滤组、忽略大小写的过滤、确认覆盖等。
- 高度可配置性:验证按钮位置、宽度、反向顺序等均可定制。
- 目录书签和手动路径输入,提高用户交互性。
- 一键切换平行目录:在路径输入框中点击斜杠会弹出选项列表。
通过以下简单示例,您可以快速启动一个文件选择对话框:
if (ImGui::Button("Open File Dialog"))
ImGuiFileDialog::Instance()->OpenDialog("ChooseFileDlgKey", "Choose File", ".cpp,.h,.hpp", ".");
if (ImGuiFileDialog::Instance()->Display("ChooseFileDlgKey"))
{
if (ImGuiFileDialog::Instance()->IsOk())
{
std::string filePathName = ImGuiFileDialog::Instance()->GetFilePathName();
// 执行其他操作...
}
ImGuiFileDialog::Instance()->Close();
}
总之,ImGuiFileDialog是一个强大而直观的文件选择对话框库,它能以Dear ImGui的风格无缝融入你的项目,提升用户体验。立即加入并开始你的创新之旅吧!
ImGuiFileDialog File Dialog for Dear ImGui 项目地址: https://gitcode.com/gh_mirrors/im/ImGuiFileDialog