mirror of https://github.com/dcoredump/dexed.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
291 lines
13 KiB
291 lines
13 KiB
/*
|
|
==============================================================================
|
|
|
|
This file is part of the JUCE library.
|
|
Copyright (c) 2015 - ROLI Ltd.
|
|
|
|
Permission is granted to use this software under the terms of either:
|
|
a) the GPL v2 (or any later version)
|
|
b) the Affero GPL v3
|
|
|
|
Details of these licenses can be found at: www.gnu.org/licenses
|
|
|
|
JUCE is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
|
|
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
To release a closed-source product which uses JUCE, commercial licenses are
|
|
available: visit www.juce.com for more information.
|
|
|
|
==============================================================================
|
|
*/
|
|
|
|
#ifndef JUCE_FILEBROWSERCOMPONENT_H_INCLUDED
|
|
#define JUCE_FILEBROWSERCOMPONENT_H_INCLUDED
|
|
|
|
|
|
//==============================================================================
|
|
/**
|
|
A component for browsing and selecting a file or directory to open or save.
|
|
|
|
This contains a FileListComponent and adds various boxes and controls for
|
|
navigating and selecting a file. It can work in different modes so that it can
|
|
be used for loading or saving a file, or for choosing a directory.
|
|
|
|
@see FileChooserDialogBox, FileChooser, FileListComponent
|
|
*/
|
|
class JUCE_API FileBrowserComponent : public Component,
|
|
private FileBrowserListener,
|
|
private TextEditorListener,
|
|
private ButtonListener,
|
|
private ComboBoxListener, // (can't use ComboBox::Listener due to idiotic VC2005 bug)
|
|
private FileFilter
|
|
{
|
|
public:
|
|
//==============================================================================
|
|
/** Various options for the browser.
|
|
|
|
A combination of these is passed into the FileBrowserComponent constructor.
|
|
*/
|
|
enum FileChooserFlags
|
|
{
|
|
openMode = 1, /**< specifies that the component should allow the user to
|
|
choose an existing file with the intention of opening it. */
|
|
saveMode = 2, /**< specifies that the component should allow the user to specify
|
|
the name of a file that will be used to save something. */
|
|
canSelectFiles = 4, /**< specifies that the user can select files (can be used in
|
|
conjunction with canSelectDirectories). */
|
|
canSelectDirectories = 8, /**< specifies that the user can select directories (can be used in
|
|
conjuction with canSelectFiles). */
|
|
canSelectMultipleItems = 16, /**< specifies that the user can select multiple items. */
|
|
useTreeView = 32, /**< specifies that a tree-view should be shown instead of a file list. */
|
|
filenameBoxIsReadOnly = 64, /**< specifies that the user can't type directly into the filename box. */
|
|
warnAboutOverwriting = 128, /**< specifies that the dialog should warn about overwriting existing files (if possible). */
|
|
doNotClearFileNameOnRootChange = 256 /**< specifies that the file name should not be cleared upon root change. */
|
|
};
|
|
|
|
//==============================================================================
|
|
/** Creates a FileBrowserComponent.
|
|
|
|
@param flags A combination of flags from the FileChooserFlags enumeration, used to
|
|
specify the component's behaviour. The flags must contain either openMode
|
|
or saveMode, and canSelectFiles and/or canSelectDirectories.
|
|
@param initialFileOrDirectory The file or directory that should be selected when the component begins.
|
|
If this is File::nonexistent, a default directory will be chosen.
|
|
@param fileFilter an optional filter to use to determine which files are shown.
|
|
If this is nullptr then all files are displayed. Note that a pointer
|
|
is kept internally to this object, so make sure that it is not deleted
|
|
before the FileBrowserComponent object is deleted.
|
|
@param previewComp an optional preview component that will be used to show previews of
|
|
files that the user selects
|
|
*/
|
|
FileBrowserComponent (int flags,
|
|
const File& initialFileOrDirectory,
|
|
const FileFilter* fileFilter,
|
|
FilePreviewComponent* previewComp);
|
|
|
|
/** Destructor. */
|
|
~FileBrowserComponent();
|
|
|
|
//==============================================================================
|
|
/** Returns the number of files that the user has got selected.
|
|
If multiple select isn't active, this will only be 0 or 1. To get the complete
|
|
list of files they've chosen, pass an index to getCurrentFile().
|
|
*/
|
|
int getNumSelectedFiles() const noexcept;
|
|
|
|
/** Returns one of the files that the user has chosen.
|
|
If the box has multi-select enabled, the index lets you specify which of the files
|
|
to get - see getNumSelectedFiles() to find out how many files were chosen.
|
|
@see getHighlightedFile
|
|
*/
|
|
File getSelectedFile (int index) const noexcept;
|
|
|
|
/** Deselects any files that are currently selected.
|
|
*/
|
|
void deselectAllFiles();
|
|
|
|
/** Returns true if the currently selected file(s) are usable.
|
|
|
|
This can be used to decide whether the user can press "ok" for the
|
|
current file. What it does depends on the mode, so for example in an "open"
|
|
mode, this only returns true if a file has been selected and if it exists.
|
|
In a "save" mode, a non-existent file would also be valid.
|
|
*/
|
|
bool currentFileIsValid() const;
|
|
|
|
/** This returns the last item in the view that the user has highlighted.
|
|
This may be different from getCurrentFile(), which returns the value
|
|
that is shown in the filename box, and if there are multiple selections,
|
|
this will only return one of them.
|
|
@see getSelectedFile
|
|
*/
|
|
File getHighlightedFile() const noexcept;
|
|
|
|
//==============================================================================
|
|
/** Returns the directory whose contents are currently being shown in the listbox. */
|
|
const File& getRoot() const;
|
|
|
|
/** Changes the directory that's being shown in the listbox. */
|
|
void setRoot (const File& newRootDirectory);
|
|
|
|
/** Changes the name that is currently shown in the filename box. */
|
|
void setFileName (const String& newName);
|
|
|
|
/** Equivalent to pressing the "up" button to browse the parent directory. */
|
|
void goUp();
|
|
|
|
/** Refreshes the directory that's currently being listed. */
|
|
void refresh();
|
|
|
|
/** Changes the filter that's being used to sift the files. */
|
|
void setFileFilter (const FileFilter* newFileFilter);
|
|
|
|
/** Returns a verb to describe what should happen when the file is accepted.
|
|
|
|
E.g. if browsing in "load file" mode, this will be "Open", if in "save file"
|
|
mode, it'll be "Save", etc.
|
|
*/
|
|
virtual String getActionVerb() const;
|
|
|
|
/** Returns true if the saveMode flag was set when this component was created.
|
|
*/
|
|
bool isSaveMode() const noexcept;
|
|
|
|
/** Sets the label that will be displayed next to the filename entry box.
|
|
By default this is just "file", but you might want to change it to something more
|
|
appropriate for your app.
|
|
*/
|
|
void setFilenameBoxLabel (const String& name);
|
|
|
|
//==============================================================================
|
|
/** Adds a listener to be told when the user selects and clicks on files.
|
|
@see removeListener
|
|
*/
|
|
void addListener (FileBrowserListener* listener);
|
|
|
|
/** Removes a listener.
|
|
@see addListener
|
|
*/
|
|
void removeListener (FileBrowserListener* listener);
|
|
|
|
/** Returns a platform-specific list of names and paths for some suggested places the user
|
|
might want to use as root folders.
|
|
The list returned contains empty strings to indicate section breaks.
|
|
@see getRoots()
|
|
*/
|
|
static void getDefaultRoots (StringArray& rootNames, StringArray& rootPaths);
|
|
|
|
//==============================================================================
|
|
/** This abstract base class is implemented by LookAndFeel classes to provide
|
|
various file-browser layout and drawing methods.
|
|
*/
|
|
struct JUCE_API LookAndFeelMethods
|
|
{
|
|
virtual ~LookAndFeelMethods() {}
|
|
|
|
// These return a pointer to an internally cached drawable - make sure you don't keep
|
|
// a copy of this pointer anywhere, as it may become invalid in the future.
|
|
virtual const Drawable* getDefaultFolderImage() = 0;
|
|
virtual const Drawable* getDefaultDocumentFileImage() = 0;
|
|
|
|
virtual AttributedString createFileChooserHeaderText (const String& title,
|
|
const String& instructions) = 0;
|
|
|
|
virtual void drawFileBrowserRow (Graphics&, int width, int height,
|
|
const String& filename,
|
|
Image* optionalIcon,
|
|
const String& fileSizeDescription,
|
|
const String& fileTimeDescription,
|
|
bool isDirectory,
|
|
bool isItemSelected,
|
|
int itemIndex,
|
|
DirectoryContentsDisplayComponent&) = 0;
|
|
|
|
virtual Button* createFileBrowserGoUpButton() = 0;
|
|
|
|
virtual void layoutFileBrowserComponent (FileBrowserComponent& browserComp,
|
|
DirectoryContentsDisplayComponent* fileListComponent,
|
|
FilePreviewComponent* previewComp,
|
|
ComboBox* currentPathBox,
|
|
TextEditor* filenameBox,
|
|
Button* goUpButton) = 0;
|
|
};
|
|
|
|
//==============================================================================
|
|
/** @internal */
|
|
void resized() override;
|
|
/** @internal */
|
|
void buttonClicked (Button*) override;
|
|
/** @internal */
|
|
void comboBoxChanged (ComboBox*) override;
|
|
/** @internal */
|
|
void textEditorTextChanged (TextEditor&) override;
|
|
/** @internal */
|
|
void textEditorReturnKeyPressed (TextEditor&) override;
|
|
/** @internal */
|
|
void textEditorEscapeKeyPressed (TextEditor&) override;
|
|
/** @internal */
|
|
void textEditorFocusLost (TextEditor&) override;
|
|
/** @internal */
|
|
bool keyPressed (const KeyPress&) override;
|
|
/** @internal */
|
|
void selectionChanged() override;
|
|
/** @internal */
|
|
void fileClicked (const File&, const MouseEvent&) override;
|
|
/** @internal */
|
|
void fileDoubleClicked (const File&) override;
|
|
/** @internal */
|
|
void browserRootChanged (const File&) override;
|
|
/** @internal */
|
|
bool isFileSuitable (const File&) const override;
|
|
/** @internal */
|
|
bool isDirectorySuitable (const File&) const override;
|
|
|
|
/** @internal */
|
|
FilePreviewComponent* getPreviewComponent() const noexcept;
|
|
|
|
/** @internal */
|
|
DirectoryContentsDisplayComponent* getDisplayComponent() const noexcept;
|
|
|
|
protected:
|
|
/** Returns a list of names and paths for the default places the user might want to look.
|
|
|
|
By default this just calls getDefaultRoots(), but you may want to override it to
|
|
return a custom list.
|
|
*/
|
|
virtual void getRoots (StringArray& rootNames, StringArray& rootPaths);
|
|
|
|
/** Updates the items in the dropdown list of recent paths with the values from getRoots(). */
|
|
void resetRecentPaths();
|
|
|
|
private:
|
|
//==============================================================================
|
|
ScopedPointer <DirectoryContentsList> fileList;
|
|
const FileFilter* fileFilter;
|
|
|
|
int flags;
|
|
File currentRoot;
|
|
Array<File> chosenFiles;
|
|
ListenerList <FileBrowserListener> listeners;
|
|
|
|
ScopedPointer<DirectoryContentsDisplayComponent> fileListComponent;
|
|
FilePreviewComponent* previewComp;
|
|
ComboBox currentPathBox;
|
|
TextEditor filenameBox;
|
|
Label fileLabel;
|
|
ScopedPointer<Button> goUpButton;
|
|
|
|
TimeSliceThread thread;
|
|
|
|
void sendListenerChangeMessage();
|
|
bool isFileOrDirSuitable (const File& f) const;
|
|
|
|
JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (FileBrowserComponent)
|
|
};
|
|
|
|
|
|
|
|
#endif // JUCE_FILEBROWSERCOMPONENT_H_INCLUDED
|
|
|