ImGuiFileDialog 使用教程

项目介绍

ImGuiFileDialog 是一个基于 Dear ImGui 的文件选择对话框库。它允许用户在应用程序中集成一个简单且高度可定制的文件对话框。该库支持多种文件对话类型，如打开文件、保存文件，并提供了排序功能和文件过滤器。

项目快速启动

安装步骤

1. 克隆项目仓库到本地：

   git clone https://github.com/aiekick/ImGuiFileDialog.git
   cd ImGuiFileDialog
   

2. 将 ImGuiFileDialog 添加到你的项目目录：

   mkdir lib
   cd lib
   git clone https://github.com/aiekick/ImGuiFileDialog
   git checkout master
   

3. 在你的项目中包含 ImGuiFileDialog 头文件和源文件：

   #include "lib/ImGuiFileDialog/ImGuiFileDialog.h"
   

4. 在你的构建系统中添加 ImGuiFileDialog 源文件。例如，如果你使用 CMake：

   add_executable(my_project_name lib/ImGuiFileDialog/ImGuiFileDialog.cpp main.cpp)
   

示例代码

以下是一个简单的示例，展示如何在应用程序中使用 ImGuiFileDialog 打开一个文件对话框：

#include "ImGuiFileDialog.h"

// 声明变量
bool m_fileDialogOpen = false;
ImGuiFileDialogInfo m_fileDialogInfo;

// 在绘制循环中
if (ImGui::Button("Open File")) {
    m_fileDialogOpen = true;
    m_fileDialogInfo.type = ImGuiFileDialogType_OpenFile;
}

if (ImGui::FileDialog(&m_fileDialogOpen, &m_fileDialogInfo)) {
    // 处理文件对话框结果
    std::string resultPath = m_fileDialogInfo.resultPath;
    // 处理文件路径
}

应用案例和最佳实践

文件过滤器

你可以通过设置文件过滤器来限制用户可以选择的文件类型：

m_fileDialogInfo.fileFilterFunc = [](const std::string& filename) {
    return filename.find(".json") != std::string::npos;
};

自定义对话框

ImGuiFileDialog 支持高度自定义，包括自定义按钮和图标。你可以通过修改 ImGuiFileDialogConfig.h 文件来实现这些自定义设置。

典型生态项目

ImGuiFileDialog 可以与以下项目结合使用，以增强文件管理功能：

1. Dear ImGui：ImGuiFileDialog 是基于 Dear ImGui 构建的，因此与 Dear ImGui 的集成非常紧密。
2. ImGuiFontStudio：用于创建自定义图标字体，可以与 ImGuiFileDialog 结合使用，以提供更好的用户界面体验。

通过这些项目的结合使用，你可以创建一个功能强大且用户友好的文件管理界面。