--- --- TGUI: include/TGUI/Widgets/FileDialog.hpp Source File
TGUI  1.x-dev
Loading...
Searching...
No Matches
FileDialog.hpp
1
2//
3// TGUI - Texus' Graphical User Interface
4// Copyright (C) 2012-2024 Bruno Van de Velde (vdv_b@tgui.eu)
5//
6// This software is provided 'as-is', without any express or implied warranty.
7// In no event will the authors be held liable for any damages arising from the use of this software.
8//
9// Permission is granted to anyone to use this software for any purpose,
10// including commercial applications, and to alter it and redistribute it freely,
11// subject to the following restrictions:
12//
13// 1. The origin of this software must not be misrepresented;
14// you must not claim that you wrote the original software.
15// If you use this software in a product, an acknowledgment
16// in the product documentation would be appreciated but is not required.
17//
18// 2. Altered source versions must be plainly marked as such,
19// and must not be misrepresented as being the original software.
20//
21// 3. This notice may not be removed or altered from any source distribution.
22//
24
25#ifndef TGUI_FILE_DIALOG_HPP
26#define TGUI_FILE_DIALOG_HPP
27
28#include <TGUI/CopiedSharedPtr.hpp>
29#include <TGUI/Widgets/Label.hpp>
30#include <TGUI/Widgets/Button.hpp>
31#include <TGUI/Widgets/EditBox.hpp>
32#include <TGUI/Widgets/ComboBox.hpp>
33#include <TGUI/Widgets/ListView.hpp>
34#include <TGUI/Widgets/ChildWindow.hpp>
35#include <TGUI/Widgets/Panel.hpp>
36#include <TGUI/Renderers/FileDialogRenderer.hpp>
37#include <TGUI/Filesystem.hpp>
38
39#if !TGUI_EXPERIMENTAL_USE_STD_MODULE
40 #include <tuple>
41#endif
42
44
45TGUI_MODULE_EXPORT namespace tgui
46{
47 class FileDialogIconLoader;
48
63 class TGUI_API FileDialog : public ChildWindow
64 {
65 public:
66
67 using Ptr = std::shared_ptr<FileDialog>;
68 using ConstPtr = std::shared_ptr<const FileDialog>;
69
70 static constexpr const char StaticWidgetType[] = "FileDialog";
71
79 FileDialog(const char* typeName = StaticWidgetType, bool initRenderer = true);
80
90 TGUI_NODISCARD static FileDialog::Ptr create(const String& title = "Open file", const String& confirmButtonText = "Open", bool allowCreateFolder = false);
91
95 FileDialog(const FileDialog& copy);
96
100 FileDialog(FileDialog&& copy) noexcept;
101
105 FileDialog& operator= (const FileDialog& right);
106
110 FileDialog& operator= (FileDialog&& right) noexcept;
111
119 TGUI_NODISCARD static FileDialog::Ptr copy(const FileDialog::ConstPtr& dialog);
120
125 TGUI_NODISCARD FileDialogRenderer* getSharedRenderer() override;
126 TGUI_NODISCARD const FileDialogRenderer* getSharedRenderer() const override;
127
133 TGUI_NODISCARD FileDialogRenderer* getRenderer() override;
134
152 TGUI_NODISCARD const std::vector<Filesystem::Path>& getSelectedPaths() const;
153
161 void setPath(const String& path);
162
170 void setPath(const Filesystem::Path& path);
171
177 TGUI_NODISCARD const Filesystem::Path& getPath() const;
178
184 void setFilename(const String& filename);
185
195 TGUI_NODISCARD const String& getFilename() const;
196
220 void setFileTypeFilters(const std::vector<std::pair<String, std::vector<String>>>& filters, std::size_t defaultFilterIndex = 0);
221
229 TGUI_NODISCARD const std::vector<std::pair<String, std::vector<String>>>& getFileTypeFilters() const;
230
238 TGUI_NODISCARD std::size_t getFileTypeFiltersIndex() const;
239
245 void setConfirmButtonText(const String& text = "Open");
246
252 TGUI_NODISCARD const String& getConfirmButtonText() const;
253
259 void setCancelButtonText(const String& text = "Cancel");
260
266 TGUI_NODISCARD const String& getCancelButtonText() const;
267
273 void setCreateFolderButtonText(const String& text = "Create Folder");
274
280 TGUI_NODISCARD const String& getCreateFolderButtonText() const;
281
287 void setAllowCreateFolder(bool allowCreateFolder);
288
294 TGUI_NODISCARD bool getAllowCreateFolder() const;
295
301 void setFilenameLabelText(const String& labelText = "Filename:");
302
308 TGUI_NODISCARD const String& getFilenameLabelText() const;
309
317 void setListViewColumnCaptions(const String& nameColumnText = "Name", const String& sizeColumnText = "Size", const String& modifiedColumnText = "Modified");
318
326 TGUI_NODISCARD std::tuple<String, String, String> getListViewColumnCaptions() const;
327
335 void setFileMustExist(bool enforceExistence);
336
342 TGUI_NODISCARD bool getFileMustExist() const;
343
352 void setSelectingDirectory(bool selectDirectories);
353
359 TGUI_NODISCARD bool getSelectingDirectory() const;
360
366 void setMultiSelect(bool multiSelect);
367
373 TGUI_NODISCARD bool getMultiSelect() const;
374
384 void setIconLoader(std::shared_ptr<FileDialogIconLoader> iconLoader);
385
391 TGUI_NODISCARD std::shared_ptr<FileDialogIconLoader> getIconLoader() const;
392
396 void keyPressed(const Event::KeyEvent& event) override;
397
407 bool canHandleKeyPress(const Event::KeyEvent& event) override;
408
412 void textEntered(char32_t key) override;
413
415 protected:
416
426 TGUI_NODISCARD Signal& getSignal(String signalName) override;
427
433 void rendererChanged(const String& property) override;
434
438 TGUI_NODISCARD std::unique_ptr<DataIO::Node> save(SavingRenderersMap& renderers) const override;
439
443 void load(const std::unique_ptr<DataIO::Node>& node, const LoadingRenderersMap& renderers) override;
444
446 // This function is called every frame with the time passed since the last frame.
448 bool updateTime(Duration elapsedTime) override;
449
451 // Makes a copy of the widget
453 TGUI_NODISCARD Widget::Ptr clone() const override;
454
456 private:
457
459 // Changes the directory that is shown in the dialog
461 void changePath(const Filesystem::Path& path, bool updateHistory);
462
464 // Updates the back and forward buttons when the path history changes
466 void historyChanged();
467
469 // Adds the files to the list view in the order shosen by the user
471 void sortFilesInListView();
472
474 // Stores the selected files and closes the dialog
476 void filesSelected(std::vector<Filesystem::Path> filenames);
477
479 // Updates whether the open/save button is enabled or disabled
481 void updateConfirmButtonEnabled();
482
484 // Handles a press of the open/save button
486 void confirmButtonPressed();
487
489 // Adds a button the File Dialog which allows the user to create a new folder
491 void addCreateFolderButton();
492
494 // Creates a folder in a given directory
496 void createFolder(const String& name);
497
499 // Handles a press of the create folder button
501 void createCreateFolderDialog();
502
504 // Destroys the create folder dialog
506 void destroyCreateFolderDialog();
507
509 // Check if the name of a new folder is valid
511 bool isValidFolderName(const String& name);
512
514 // Initializes the widget pointers after copying or loading the dialog
516 void identifyChildWidgets();
517
519 // Connects the signals of the child widgets
521 void connectSignals();
522
524 public:
525
529 SignalFileDialogPaths onFileSelect = {"FileSelected"};
530
532 Signal onCancel = {"Cancelled"};
533
535 protected:
536
537 Button::Ptr m_buttonBack;
538 Button::Ptr m_buttonForward;
539 Button::Ptr m_buttonUp;
540 EditBox::Ptr m_editBoxPath;
541 ListView::Ptr m_listView;
542 Label::Ptr m_labelFilename;
543 EditBox::Ptr m_editBoxFilename;
544 ComboBox::Ptr m_comboBoxFileTypes;
545 Button::Ptr m_buttonCancel;
546 Button::Ptr m_buttonConfirm;
547 Button::Ptr m_buttonCreateFolder;
548 bool m_allowCreateFolder = false;
549
550 bool m_createFolderDialogOpen = false;
551
552 Filesystem::Path m_currentDirectory;
553 std::vector<Filesystem::FileInfo> m_filesInDirectory;
554 std::vector<Texture> m_fileIcons; // Same order as m_filesInDirectory
555 std::size_t m_sortColumnIndex = 0;
556 bool m_sortInversed = false;
557
558 std::vector<Filesystem::Path> m_pathHistory;
559 std::size_t m_pathHistoryIndex = 0;
560
561 bool m_fileMustExist = true;
562 bool m_selectingDirectory = false;
563 bool m_multiSelect = false;
564
565 std::vector<std::pair<String, std::vector<String>>> m_fileTypeFilters;
566 std::size_t m_selectedFileTypeFilter = 0;
567
568 std::shared_ptr<FileDialogIconLoader> m_iconLoader;
569
570 std::vector<Filesystem::Path> m_selectedFiles;
571 };
572
574}
575
577
578#endif // TGUI_FILE_DIALOG_HPP
std::shared_ptr< Button > Ptr
Shared widget pointer.
Definition Button.hpp:41
Child window widget.
Definition ChildWindow.hpp:45
std::shared_ptr< ComboBox > Ptr
Shared widget pointer.
Definition ComboBox.hpp:52
Wrapper for durations.
Definition Duration.hpp:55
std::shared_ptr< EditBox > Ptr
Shared widget pointer.
Definition EditBox.hpp:51
File dialog widget.
Definition FileDialog.hpp:64
static TGUI_NODISCARD FileDialog::Ptr create(const String &title="Open file", const String &confirmButtonText="Open", bool allowCreateFolder=false)
Creates a new file dialog widget.
void setCancelButtonText(const String &text="Cancel")
Changes the text of the cancel button (e.g. to display it in a different language)
void setMultiSelect(bool multiSelect)
Changes whether multiple files can be selected.
void setFileTypeFilters(const std::vector< std::pair< String, std::vector< String > > > &filters, std::size_t defaultFilterIndex=0)
Changes the file filters which the user can select to only show files of a certain type.
TGUI_NODISCARD bool getSelectingDirectory() const
Returns whether the file dialog is used for selecting a file or for selecting a directory.
void setFileMustExist(bool enforceExistence)
Changes whether the file should exist or whether the filename can be a non-existent file.
TGUI_NODISCARD const String & getFilename() const
Returns the filename that is entered in the filename edit box.
TGUI_NODISCARD std::tuple< String, String, String > getListViewColumnCaptions() const
Returns the names of the list view columns.
TGUI_NODISCARD const Filesystem::Path & getPath() const
Returns the directory that is currently being shown in the file dialog.
TGUI_NODISCARD Signal & getSignal(String signalName) override
Retrieves a signal based on its name.
TGUI_NODISCARD const String & getConfirmButtonText() const
Return the text of the open/save button.
void setAllowCreateFolder(bool allowCreateFolder)
Adds or removes the create folder button.
void setConfirmButtonText(const String &text="Open")
Changes the text of the open/save button.
void load(const std::unique_ptr< DataIO::Node > &node, const LoadingRenderersMap &renderers) override
Loads the widget from a tree of nodes.
TGUI_NODISCARD FileDialogRenderer * getSharedRenderer() override
Returns the renderer, which gives access to functions that determine how the widget is displayed.
TGUI_NODISCARD const std::vector< Filesystem::Path > & getSelectedPaths() const
Returns the selected files/directories.
void setPath(const String &path)
Changes the directory for which the files are to be displayed.
std::shared_ptr< const FileDialog > ConstPtr
Shared constant widget pointer.
Definition FileDialog.hpp:68
TGUI_NODISCARD Widget::Ptr clone() const override
Makes a copy of the widget if you don't know its exact type.
std::shared_ptr< FileDialog > Ptr
Shared widget pointer.
Definition FileDialog.hpp:67
void setPath(const Filesystem::Path &path)
Changes the directory for which the files are to be displayed.
void setCreateFolderButtonText(const String &text="Create Folder")
Changes the text of the create folder button.
TGUI_NODISCARD bool getMultiSelect() const
Returns whether multiple files can be selected.
TGUI_NODISCARD bool getAllowCreateFolder() const
Return whether the file dialog allows the user to create a folder.
TGUI_NODISCARD const String & getFilenameLabelText() const
Return the text of the filename label.
static TGUI_NODISCARD FileDialog::Ptr copy(const FileDialog::ConstPtr &dialog)
Makes a copy of another file dialog.
void setIconLoader(std::shared_ptr< FileDialogIconLoader > iconLoader)
Sets a custom icon loader.
TGUI_NODISCARD const std::vector< std::pair< String, std::vector< String > > > & getFileTypeFilters() const
Returns the file filters which the user can select to only show files of a certain type.
bool canHandleKeyPress(const Event::KeyEvent &event) override
Called by the parent of the widget to check if keyPressed would process the event.
void setSelectingDirectory(bool selectDirectories)
Changes whether the file dialog is used for selecting a file or for selecting a directory.
void rendererChanged(const String &property) override
Function called when one of the properties of the renderer is changed.
TGUI_NODISCARD std::size_t getFileTypeFiltersIndex() const
Returns the index of the currently selected file filter.
TGUI_NODISCARD std::unique_ptr< DataIO::Node > save(SavingRenderersMap &renderers) const override
Saves the widget as a tree node in order to save it to a file.
TGUI_NODISCARD FileDialogRenderer * getRenderer() override
Returns the renderer, which gives access to functions that determine how the widget is displayed.
TGUI_NODISCARD const String & getCancelButtonText() const
Return the text of the cancel button.
TGUI_NODISCARD const String & getCreateFolderButtonText() const
Return the text of the create folder button.
void setFilenameLabelText(const String &labelText="Filename:")
Changes the text of the filename label (e.g. to display it in a different language)
void setFilename(const String &filename)
Sets the filename that is shown at the bottom of the file dialog.
TGUI_NODISCARD std::shared_ptr< FileDialogIconLoader > getIconLoader() const
Gets the icon loader that is currently being used.
FileDialog(FileDialog &&copy) noexcept
Move constructor.
void setListViewColumnCaptions(const String &nameColumnText="Name", const String &sizeColumnText="Size", const String &modifiedColumnText="Modified")
Changes the names of the list view columns (e.g. to display them in a different language)
FileDialog(const FileDialog &copy)
Copy constructor.
TGUI_NODISCARD bool getFileMustExist() const
Returns whether the file should exist or whether the filename can be a non-existent file.
Definition FileDialogRenderer.hpp:35
Object to represent paths on a filesystem.
Definition Filesystem.hpp:58
std::shared_ptr< Label > Ptr
Shared widget pointer.
Definition Label.hpp:45
std::shared_ptr< ListView > Ptr
Shared widget pointer.
Definition ListView.hpp:51
Signal to which the user can subscribe to get callbacks from.
Definition Signal.hpp:783
Signal to which the user can subscribe to get callbacks from.
Definition Signal.hpp:61
Wrapper class to store strings.
Definition String.hpp:96
std::shared_ptr< Widget > Ptr
Shared widget pointer.
Definition Widget.hpp:86
Namespace that contains all TGUI functions and classes.
Definition AbsoluteOrRelativeValue.hpp:38
KeyPressed event parameters.
Definition Event.hpp:168