StdDlg.h

Go to the documentation of this file.

//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Project: uLib - User mode utility library.
// Module: Standard dialog wrapper classes.
// Author: Copyright (c) Love Nystrom
// License: NNOSL (BSD descendant, see NNOSL.txt in the base directory).
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#ifndef __StdDlg_h_incl__
#define __StdDlg_h_incl__

#include <uLib/Common.h>


#define DLGHOOKPROC  UINT_PTR CALLBACK

typedef class FileDialog*   PFileDialog;
typedef class DirDialog*    PDirDialog;
typedef class FindDialog*   PFindDialog;
typedef class FontDialog*   PFontDialog;
typedef class ColorDialog*  PColorDialog;


ACSTR CDErrorMsg( DWORD Err DEF_(0) );

// Common dialog box registered window messages

extern UINT WM_CommonHelp;  
extern UINT WM_FileOk;      
extern UINT WM_SelChange;   
extern UINT WM_ShareViolation; 
extern UINT WM_FindReplace; 
extern UINT WM_ColorOk;     
extern UINT WM_SetRGB;      

#define REGISTER_CommonHelp() \
    if (!WM_CommonHelp) WM_CommonHelp = RegisterWindowMessage( HELPMSGSTRING )

#define REGISTER_FileOk() \
    if (!WM_FileOk) WM_FileOk = RegisterWindowMessage( FILEOKSTRING )

#define REGISTER_SelChange() \
    if (!WM_SelChange) WM_SelChange = RegisterWindowMessage( LBSELCHSTRING )

#define REGISTER_ShareViolation() \
    if (!WM_ShareViolation) WM_ShareViolation = RegisterWindowMessage( SHAREVISTRING )

#define REGISTER_FindReplace() \
    if (!WM_FindReplace) WM_FindReplace = RegisterWindowMessage( FINDMSGSTRING )

#define REGISTER_ColorOk() \
    if (!WM_ColorOk) WM_ColorOk = RegisterWindowMessage( COLOROKSTRING )

#define REGISTER_SetRGB() \
    if (!WM_SetRGB) WM_SetRGB = RegisterWindowMessage( SETRGBSTRING )

//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// FileDialog
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#define FDLG_USEINITDIR  1  // Build option: Support lpstrInitialDir.

extern const CSTR ALLFILE_FILTER; 


typedef bool (CALLBACK *FDLG_ItemProc)( CSTR FileName, PVOID UserData );


class FileDialog : public OPENFILENAME {
    // The inherited OPENFILENAME fields are used for Execute calls.
    // DWORD         lStructSize; 
    // HWND          hwndOwner; 
    // HINSTANCE     hInstance; 
    // LPCTSTR       lpstrFilter; 
    // LPTSTR        lpstrCustomFilter; 
    // DWORD         nMaxCustFilter; 
    // DWORD         nFilterIndex; 
    // LPTSTR        lpstrFile; 
    // DWORD         nMaxFile; 
    // LPTSTR        lpstrFileTitle; 
    // DWORD         nMaxFileTitle; 
    // LPCTSTR       lpstrInitialDir; 
    // LPCTSTR       lpstrTitle; 
    // DWORD         Flags; 
    // WORD          nFileOffset; 
    // WORD          nFileExtension; 
    // LPCTSTR       lpstrDefExt; 
    // LPARAM        lCustData; 
    // LPOFNHOOKPROC lpfnHook; 
    // LPCTSTR       lpTemplateName; 
public:
    TCHAR FullName[ MAX_PATH ]; 
  #if FDLG_USEINITDIR
    TCHAR InitDir[ MAX_PATH ]; 
  #endif

    FileDialog( HWND owner = NULL );
    void SetOwner( HWND owner, HINSTANCE hInst = NULL );
    ~FileDialog();


    bool Execute( UINT mode );
    #define FDLG_OPEN  1  
    #define FDLG_SAVE  2  

    CSTR Name();        
    CSTR Ext();         


    bool ForEach( FDLG_ItemProc Action, PVOID UserData );


    CSTR PickFile( HWND owner, CSTR caption, CSTR filter );


    CSTR SetFilename( CSTR PathName );

protected:
    void _updateOffsets(); // Scan FullName and update nFileOffset/nFileExtension
};

//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// FindDialog
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#ifndef FR_ACTIONMASK // (wCore and WCL defines this too)
  #define FRX_FINDALL   0x00100000  // Use an undefined Flags bit as 'Find All'
  #define FR_ACTIONMASK (FR_FINDNEXT| FR_REPLACE |FR_REPLACEALL| FR_DIALOGTERM| FRX_FINDALL)
  #define FR_OPTIONMASK (FR_DOWN| FR_MATCHCASE| FR_WHOLEWORD)
#endif


class FindDialog : public FINDREPLACE {
    // The inherited FINDREPLACE fields are used for Execute calls.
    // DWORD         lStructSize; 
    // HWND          hwndOwner; 
    // HINSTANCE     hInstance; 
    // DWORD         Flags; 
    // LPTSTR        lpstrFindWhat; 
    // LPTSTR        lpstrReplaceWith; 
    // WORD          wFindWhatLen; 
    // WORD          wReplaceWithLen; 
    // LPARAM        lCustData; 
    // LPFRHOOKPROC  lpfnHook; 
    // LPCTSTR       lpTemplateName; 
public:
    HWND        hWnd;       
    TCHAR       What[256];  
    TCHAR       With[256];  

    FindDialog( HWND Owner = NULL );
    void SetOwner( HWND Owner, HINSTANCE hInst = NULL );
    ~FindDialog();


    bool Execute( UINT Mode );

    #define FD_FIND     1   
    #define FD_REPLACE  2   
    #define FD_CLOSE    3   

    void SendFindNext(); 
};

//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// FontDialog
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


class FontDialog : public CHOOSEFONT {
    // DWORD           lStructSize;
    // HWND            hwndOwner;          // Caller's window handle
    // HDC             hDC;                // Printer DC/IC or NULL
    // LPLOGFONTA      lpLogFont;          // Pointer to a LOGFONT struct
    // INT             iPointSize;         // 10 * size in points of selected font
    // DWORD           Flags;              // enum. type flags
    // COLORREF        rgbColors;          // Returned text color
    // LPARAM          lCustData;          // Data passed to hook fn.
    // LPCFHOOKPROC    lpfnHook;           // Ptr. to hook function
    // LPCSTR          lpTemplateName;     // Custom template name
    // HINSTANCE       hInstance;          // Instance that contains cust template
    // LPSTR           lpszStyle;          // Return style field (>= LF_FACESIZE)
    // WORD            nFontType;          // Same as reported to the EnumFonts with FONTTYPE_
    // WORD            ___MISSING_ALIGNMENT__;
    // INT             nSizeMin;           // Minimum pt size allowed &
    // INT             nSizeMax;           // Max pt size allowed if CF_LIMITSIZE is used
public:
    LOGFONT LogFont; 

    FontDialog();
    void SetOwner( HWND Owner, HINSTANCE hInst = NULL );


    bool Execute() { return bool_cast( ChooseFont( this )); }


    HFONT CreateFont() { return CreateFontIndirect( &LogFont ); }
    
    void  SetFaceName( CSTR Face ); 
    void  SetTypeface( CSTR Face, WORD Points, WORD Weight, BYTE ChrSet = ANSI_CHARSET );


    bool  GetLogFontFromDC( HDC hDC );
};

//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// ColorDialog
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


class ColorDialog : public CHOOSECOLOR {
    // DWORD        lStructSize;
    // HWND         hwndOwner;
    // HWND         hInstance;
    // COLORREF     rgbResult;
    // COLORREF*    lpCustColors;
    // DWORD        Flags;
    // LPARAM       lCustData;
    // LPCCHOOKPROC lpfnHook;
    // LPCSTR       lpTemplateName;
public:
    COLORREF Colors[16]; 

    ColorDialog();
    void SetOwner( HWND Owner, HINSTANCE hInst = NULL );


    bool Execute() { return bool_cast( ChooseColor( this )); }
};

//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// DirDialog
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#ifndef BIF_DEFAULT // Also defined by wCore (commercial lib)
  #define BIF_DEFAULT (BIF_RETURNONLYFSDIRS| BIF_NEWDIALOGSTYLE| BIF_EDITBOX)
#endif


class DirDialog : public BROWSEINFO {
    // HWND              hwndOwner;
    // PCIDLIST_ABSOLUTE pidlRoot;
    // LPTSTR            pszDisplayName;
    // LPCTSTR           lpszTitle;
    // UINT              ulFlags;
    // BFFCALLBACK       lpfn;
    // LPARAM            lParam; // RESERVED (for DirDialog::_Hook)
    // int               iImage;
public:
    LPITEMIDLIST    pIdl;               
    TCHAR           Folder[ MAX_PATH ]; 
    PVOID           pData; 

    static CCSTR    DefaultTitle; 
    static IFolderFilter* FolderFilter; 

    DirDialog( HWND Owner = NULL, UINT Flags = BIF_DEFAULT );
    void SetOwner( HWND Owner ); 
    void Done(); 
    ~DirDialog();

    bool SetInitialDir( CSTR Dir ); 

    void SetRoot( LPITEMIDLIST pidl ); 
    bool SetRootCsid( int csId ); 
    bool SetRootDir( CSTR Dir );  


    bool Execute();

protected:
    IFolderFilterSite* pFilterSite; // Used to install FolderFilter, if any.
    static DLGHOOKPROC _Hook( HWND hwnd, UINT msg, LPARAM lp, LPARAM data );
};

#endif//ndef __StdDlg_h_incl__
// EOF