FXFileSelector.h

/********************************************************************************
*                                                                               *
*                  F i l e   S e l e c t i o n   W i d g e t                    *
*                                                                               *
*********************************************************************************
* Copyright (C) 1998,2025 by Jeroen van der Zijp.   All Rights Reserved.        *
*********************************************************************************
* This library is free software; you can redistribute it and/or modify          *
* it under the terms of the GNU Lesser General Public License as published by   *
* the Free Software Foundation; either version 3 of the License, or             *
* (at your option) any later version.                                           *
*                                                                               *
* This library 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 Lesser General Public License for more details.                           *
*                                                                               *
* You should have received a copy of the GNU Lesser General Public License      *
* along with this program.  If not, see <http://www.gnu.org/licenses/>          *
********************************************************************************/
#ifndef FXFILESELECTOR_H
#define FXFILESELECTOR_H

#ifndef FXPACKER_H
#include "FXPacker.h"
#endif

namespace FX {


class FXFileAssociations;
class FXFileList;
class FXTextField;
class FXComboBox;
class FXDirBox;
class FXPathBox;
class FXButton;
class FXMenuButton;
class FXIcon;
class FXMenuPane;
class FXCheckButton;
class FXMatrix;
class FXIconSource;
class FXHorizontalFrame;


enum {
  SELECTFILE_ANY,             
  SELECTFILE_EXISTING,        
  SELECTFILE_MULTIPLE,        
  SELECTFILE_MULTIPLE_ALL,    
  SELECTFILE_DIRECTORY        
  };

#define PATHBOX 1

class FXAPI FXFileSelector : public FXPacker {
  FXDECLARE(FXFileSelector)
protected:
  FXFileList        *filebox;           // File list widget
  FXTextField       *filename;          // File name entry field
  FXComboBox        *filefilter;        // Combobox for pattern list
 // FXComboBox        *encodinglist;      // Combobox for encoding list
  FXMenuPane        *bookmarkmenu;      // Menu for bookmarks
  FXHorizontalFrame *navbuttons;        // Navigation buttons
  FXHorizontalFrame *fileboxframe;      // Frame around file list
  FXMatrix          *entryblock;        // Entry block
  FXCheckButton     *readonly;          // Open file as read only
#if defined(PATHBOX)
  FXPathBox         *dirbox;            // Directory hierarchy list
#else
  FXDirBox          *dirbox;            // Directory hierarchy list
#endif
  FXButton          *accept;            // Accept button
  FXButton          *cancel;            // Cancel button
  FXIcon            *updiricon;         // Up directory icon
  FXIcon            *listicon;          // List mode icon
  FXIcon            *detailicon;        // Detail mode icon
  FXIcon            *iconsicon;         // Icon mode icon
  FXIcon            *homeicon;          // Go home icon
  FXIcon            *workicon;          // Go home icon
  FXIcon            *shownicon;         // Files shown icon
  FXIcon            *hiddenicon;        // Files hidden icon
  FXIcon            *bookmarkicon;      // Book mark icon
  FXIcon            *bookaddicon;       // Book add icon
  FXIcon            *bookdelicon;       // Book delete icon
  FXIcon            *bookclricon;       // Book clear icon
  FXIcon            *sortingicon;       // Sorting icon
  FXIcon            *newicon;           // New directory icon
  FXIcon            *renameicon;        // Rename file icon
  FXIcon            *copyicon;          // Copy file icon
  FXIcon            *moveicon;          // Rename file icon
  FXIcon            *linkicon;          // Link file icon
  FXIcon            *deleteicon;        // Delete file icon
  FXRecentFiles      bookmarks;         // Bookmarked places
  FXuint             selectmode;        // Select mode
  FXbool             navigable;         // May navigate
protected:
  FXFileSelector(){}
  static FXint countFilenames(const FXString& string);
  static FXString decodeFilename(const FXString& string,FXint n=0);
  static FXString encodeFilename(const FXString& string);
private:
  FXFileSelector(const FXFileSelector&);
  FXFileSelector &operator=(const FXFileSelector&);
public:
  long onCmdAccept(FXObject*,FXSelector,void*);
  long onCmdFilter(FXObject*,FXSelector,void*);
  long onCmdItemDblClicked(FXObject*,FXSelector,void*);
  long onCmdItemSelected(FXObject*,FXSelector,void*);
  long onCmdItemDeselected(FXObject*,FXSelector,void*);
  long onCmdDirectoryUp(FXObject*,FXSelector,void*);
  long onUpdDirectoryUp(FXObject*,FXSelector,void*);
  long onCmdDirTree(FXObject*,FXSelector,void*);
  long onCmdHome(FXObject*,FXSelector,void*);
  long onCmdWork(FXObject*,FXSelector,void*);
  long onCmdBookmark(FXObject*,FXSelector,void*);
  long onCmdUnBookmark(FXObject*,FXSelector,void*);
  long onCmdVisit(FXObject*,FXSelector,void*);
  long onCmdNew(FXObject*,FXSelector,void*);
  long onUpdNew(FXObject*,FXSelector,void*);
  long onCmdRename(FXObject*,FXSelector,void*);
  long onCmdCopy(FXObject*,FXSelector,void*);
  long onCmdMove(FXObject*,FXSelector,void*);
  long onCmdLink(FXObject*,FXSelector,void*);
  long onCmdRemove(FXObject*,FXSelector,void*);
  long onUpdSelected(FXObject*,FXSelector,void*);
  long onPopupMenu(FXObject*,FXSelector,void*);
  long onCmdImageSize(FXObject*,FXSelector,void*);
  long onUpdImageSize(FXObject*,FXSelector,void*);
  long onUpdNavigable(FXObject*,FXSelector,void*);
public:
  enum {
    ID_FILEFILTER=FXPacker::ID_LAST,
    ID_ACCEPT,
    ID_FILELIST,
    ID_DIRECTORY_UP,
    ID_DIRTREE,
    ID_MINI_SIZE,
    ID_NORMAL_SIZE,
    ID_MEDIUM_SIZE,
    ID_GIANT_SIZE,
    ID_HOME,
    ID_WORK,
    ID_BOOKMARK,
    ID_UNBOOKMARK,
    ID_BOOKMENU,
    ID_VISIT,
    ID_NEW,
    ID_RENAME,
    ID_COPY,
    ID_MOVE,
    ID_LINK,
    ID_REMOVE,
    ID_LAST
    };
public:

  FXFileSelector(FXComposite *p,FXObject* tgt=nullptr,FXSelector sel=0,FXuint opts=0,FXint x=0,FXint y=0,FXint w=0,FXint h=0);

  virtual void create();

  FXButton *acceptButton() const { return accept; }

  FXButton *cancelButton() const { return cancel; }

  void setFilename(const FXString& path);

  FXString getFilename() const;

  FXString* getFilenames() const;

  void setDirectory(const FXString& path);

  FXString getDirectory() const;

  void setSelectMode(FXuint mode);

  FXuint getSelectMode() const { return selectmode; }

  void setPattern(const FXString& ptrn);

  FXString getPattern() const;

  void setMatchMode(FXuint mode);

  FXuint getMatchMode() const;

  void setPatternList(const FXString& patterns);

  FXString getPatternList() const;

  void setCurrentPattern(FXint patno);

  FXint getCurrentPattern() const;

  void setPatternText(FXint patno,const FXString& text);

  FXString getPatternText(FXint patno) const;

  FXint getNumPatterns() const;

  void allowPatternEntry(FXbool flag);

  FXbool allowPatternEntry() const;

  void setItemSpace(FXint s);

  FXint getItemSpace() const;

  void setFileBoxStyle(FXuint style);

  FXuint getFileBoxStyle() const;

  void setSortOrder(FXuint order);

  FXuint getSortOrder() const;

  FXbool showHiddenFiles() const;

  void showHiddenFiles(FXbool flag);

  FXbool showImages() const;

  void showImages(FXbool flag);

  FXint getImageSize() const;

  void setImageSize(FXint size);

  void showReadOnly(FXbool flag);

  FXbool shownReadOnly() const;

  void setReadOnly(FXbool flag);

  FXbool getReadOnly() const;

  void allowNavigation(FXbool flag);

  FXbool allowNavigation() const { return navigable; }

  void setDraggableFiles(FXbool flag);

  FXbool getDraggableFiles() const;

  void setTimeFormat(const FXString& fmt);

  FXString getTimeFormat() const;

  void setAssociations(FXFileAssociations* assoc,FXbool owned=false);

  FXFileAssociations* getAssociations() const;

  void setIconSource(FXIconSource* src);

  FXIconSource* getIconSource() const;

  static FXString patternFromText(const FXString& pattern);

  static FXString extensionFromPattern(const FXString& pattern);

  virtual void save(FXStream& store) const;

  virtual void load(FXStream& store);

  virtual ~FXFileSelector();
  };

}

#endif