/*****************************************************************************
#   Copyright (C) 1994-2008 by David Gordon.
#   All rights reserved.                           
#                                                                           
#   This software is part of a beta-test version of the Consed/Autofinish
#   package.  It should not be redistributed or
#   used for any commercial purpose, including commercially funded
#   sequencing, without written permission from the author and the
#   University of Washington.
#   
#   This software is provided ``AS IS'' and any express or implied
#   warranties, including, but not limited to, the implied warranties of
#   merchantability and fitness for a particular purpose, are disclaimed.
#   In no event shall the authors or the University of Washington be
#   liable for any direct, indirect, incidental, special, exemplary, or
#   consequential damages (including, but not limited to, procurement of
#   substitute goods or services; loss of use, data, or profits; or
#   business interruption) however caused and on any theory of liability,
#   whether in contract, strict liability, or tort (including negligence
#   or otherwise) arising in any way out of the use of this software, even
#   if advised of the possibility of such damage.
#
#   Building Consed from source is error prone and not simple which is
#   why I provide executables.  Due to time limitations I cannot
#   provide any assistance in building Consed.  Even if you do not
#   modify the source, you may introduce errors due to using a
#   different version of the compiler, a different version of motif,
#   different versions of other libraries than I used, etc.  For this
#   reason, if you discover Consed bugs, I can only offer help with
#   those bugs if you first reproduce those bugs with an executable
#   provided by me--not an executable you have built.
# 
#   Modifying Consed is also difficult.  Although Consed is modular,
#   some modules are used by many other modules.  Thus making a change
#   in one place can have unforeseen effects on many other features.
#   It may takes months for you to notice these other side-effects
#   which may not seen connected at all.  It is not feasable for me to
#   provide help with modifying Consed sources because of the
#   potentially huge amount of time involved.
#
#*****************************************************************************/
//
// fileselector.h
//
// the FileSelector object is a wrapper for a standard Motif
// file selecton dialog box.  client specifies the title.
// has ok, filter and cancel buttons but no help button.
// it is not modal.
//
// chrisa 24-Jan-95
//

#ifndef FILESELECTOR_INCLUDED 
#define FILESELECTOR_INCLUDED




#include <Xm/Xm.h>

#include "sysdepend.h"
#include "assert.h"
#include "filename.h"


class FileSelector {
 public:
   // func proto for file selection callbacks
   typedef void CbFileSelected(void *, char*);

   // ctor does not completely initialize, needs title and mask
   FileSelector();

   // dtor destroys motif widget
   ~FileSelector() { XtDestroyWidget(widFsb_); }

   // pop up the file selection box and put the question
   // blocks until user selects or cancels, returns string
   // object that is null if user cancelled, otherwise
   // contains selected.  if optional file name supplied,
   // appears as default file name in selection box.
   // the title applies both to dialog box and selection label
   FileName popUpAndGetFilePath(const char* szTitle, 
                                const char* szFileMask,
                                const char* szFileName = 0);

   // raw xt callbacks
   friend void fsbCbOk(Widget,
                       FileSelector*,
                       XmFileSelectionBoxCallbackStruct*);
   friend void fsbCbCancel(Widget,
                           FileSelector*,
                           XmFileSelectionBoxCallbackStruct*);

 private:
   Widget widFsb_;

   // holds path returned by xt callback
   FileName soFullFilePath_;

   // used internally to set the title
   void setTitleString(const char*);

   // used internally to set the directory mask
   void setDirMask(const char*);

   // used internally to set the default file spec
   void setDirSpec(const char*);

   // global used to block application until user responds
   bool bBlockApplication_;
};



void fsbCbOk(Widget,
             FileSelector*,
             XmFileSelectionBoxCallbackStruct*);

void fsbCbCancel(Widget,
                 FileSelector*,
                 XmFileSelectionBoxCallbackStruct*);


#endif // FILESELECTOR_INCLUDED