CNavDialog.h

Go to the documentation of this file.

#pragma once
 
//
// (C) Copyright 2005-2024 by Graebert GmbH.
//
// Permission to use, copy, modify, and distribute this software in
// object code form for any purpose and without fee is hereby granted,
// provided that the above copyright notice appears in all copies and
// that both that copyright notice and the limited warranty and
// restricted rights notice below appear in all supporting
// documentation.
//
// GRAEBERT PROVIDES THIS PROGRAM "AS IS" AND WITH ALL FAULTS.
// GRAEBERT SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTY OF
// MERCHANTABILITY OR FITNESS FOR A PARTICULAR USE.  GRAEBERT GMBH
// DOES NOT WARRANT THAT THE OPERATION OF THE PROGRAM WILL BE
// UNINTERRUPTED OR ERROR FREE.
 
 
#include <ShlObj.h>
#include <ShObjIdl.h>
#include "global enums.h"
#include "..\adui17\CAdUiDialog.h"
 
class CDWordArray;
class CDataExchange;
class CMenu;
class CNavData;
class CNavDataArray;
class CNavFilter;
class CNavFilterArray;
class CNavListCtrl;
class CPoint;
class CStringArray;
class CWnd;
template < typename Param1, typename Param2 > class StrTraitMFC_DLL;
 
class ARX_API CNavDialog : public CAdUiDialog
{
public:
         DECLARE_DYNAMIC(CNavDialog);
 
public:
          CNavDialog( CNavDataArray &, CNavFilterArray &,unsigned int, CWnd *, HINSTANCE__ *);
          CNavDataArray &  GetDataArray(void);
          CNavFilter *  GetCurrentFileExtension( CStringW &);
          CNavFilterArray &  GetFilterArray(void);
          CNavListCtrl *  GetFolderListCtrl(void);
         int  GetAcceptAnyFileExtension(void);
         int  GetConfirmReplace(void);
         int  GetCreatingFile(void);
         int  GetDefaultFilterIndex(void);
         int  GetFilterIndex(void);
         int  GetFoldersOnly(void);
         int  GetForceFilterIndex(void);
         int  GetMultiSelectAllowed(void);
         int  GetNoExtraExtensions(void);
         int  GetNoExtraExtensionsInPlaces(void);
         int  GetNoFTP(void);
         int  GetNoPlacesList(void);
         int  GetNoURLFileTransfer(void);
         int  GetNoURLsAllowed(void);
         int  GetPersonalFolderPath( CStringW &);
         int  GetReadOnlyAllowed(void);
         int  GetReadOnlyHidden(void);
         int  GetReadOnlySpecified(void);
         int  GetToolsMenuItemPosition( NavToolsMenuItem);
         int  GetUseRegExtensionFlags(void);
         int  InsertUserItemInPlaces(int,wchar_t const *,wchar_t const *);
         int  NavigateToFolder(wchar_t const *);
         unsigned int  GetIDD(void);
         unsigned int  GetToolsMenuItemsPresent(void);
         unsigned int  GetViewMode(void);
         unsigned long  GetInitialFilterIndex(void);
         virtual  ~CNavDialog(void);
         virtual int  BeginDownloadFiles( CStringArray &, CDWordArray &);
         virtual int  GetAllDialogsData( CStringW const &, CStringW &);
         virtual int  GetAllDialogsData( CStringW const &,unsigned long &);
         virtual int  GetProductName( CStringW &);
         virtual int  SetAllDialogsData( CStringW const &, CStringW &);
         virtual int  SetAllDialogsData( CStringW const &,unsigned long);
         virtual unsigned long  GetDownloadActionCodes( CStringW &);
         virtual void  LocateFile(void);
         virtual void  OnDialogHelp(void);
         virtual void  OnDialogHelp(wchar_t const *);
         void *  GetImpObject(void)const ;
         void  AddDataToHistory(void);
         void  BrowseCurrentObject(void);
         void  GetCurrentFolderForPersistence( CStringW &);
         void  GetOkButtonText( CStringW &,int);
         void  GetSingleDataFullPath( CStringW &);
         void  SetAcceptAnyFileExtension(int);
         void  SetConfirmReplace(int);
         void  SetCreatingFile(int);
         void  SetDefaultFileExtension(wchar_t const *);
         void  SetDefaultFilterIndex(int);
         void  SetDefaultInitialFolder(wchar_t const *);
         void  SetDialogCaption(wchar_t const *);
         void  SetFilterIndex(int);
         void  SetFolderComboCurSel(int);
         void  SetFolderListCtrl( CNavListCtrl *);
         void  SetFoldersOnly(int);
         void  SetForceFilterIndex(int);
         void  SetForceInitialFolder(wchar_t const *);
         void  SetInitialFileName(wchar_t const *);
         void  SetMultiSelectAllowed(int);
         void  SetNoExtraExtensions(int);
         void  SetNoExtraExtensionsInPlaces(int);
         void  SetNoFTP(int);
         void  SetNoURLFileTransfer(int);
         void  SetNoURLsAllowed(int);
         void  SetOkButtonMenuExists(int);
         void  SetOkButtonText(wchar_t const *);
         void  SetReadOnlyAllowed(int);
         void  SetReadOnlyHidden(int);
         void  SetReadOnlySpecified(int);
         void  SetToolsMenuItemsPresent(unsigned int);
         void  SetUseRegExtensionFlags(int);
         void  SetViewMode(unsigned int);
         void  TrimWhiteSpace( CStringW &,int);
         wchar_t const *  GetDefaultFileExtension(void);
         wchar_t const *  GetDefaultInitialFolder(void);
         wchar_t const *  GetDialogCaption(void);
         wchar_t const *  GetForceInitialFolder(void);
         wchar_t const *  GetInitialFileName(void);
 
protected:
         int  OnHelpInfo( tagHELPINFO *);
         DECLARE_MESSAGE_MAP()
         virtual  ADUI_REPLY  OnNotifyControlChange(unsigned int,long);
         virtual  ADUI_REPLY  OnNotifyGeneric(unsigned int,long);
         virtual  OkHandlerErr  CombineDataTextWithFolderName( CNavData *, CStringW &);
         virtual  OkHandlerErr  PreprocessData( CNavDataArray &);
         virtual int  FindInSearchPath(wchar_t const *, CStringW *);
         virtual int  GetRecentDirectory( CStringW &);
         virtual int  LaunchBrowserDialog( CStringW &,wchar_t const *,wchar_t const *,wchar_t const *);
         virtual int  OnCmdMsg(unsigned int,int,void *, AFX_CMDHANDLERINFO *);
         virtual int  OnFileNameOK(void);
         virtual int  OnInitDialog(void);
         virtual int  OnUrlOK(void);
         virtual int  PreTranslateMessage( tagMSG *);
         virtual int  ReportURLTransferStatus( CDWordArray &, CStringArray &, CStringArray &);
         virtual int  UpdateFileExtension( CStringW &,int);
         virtual int  VerifyURLSave(void);
         virtual void  DisplaySearchError(wchar_t const *);
         virtual void  DoDataExchange( CDataExchange *);
         virtual void  GetDefaultBrowserStartURL( CStringW &);
         virtual void  OnCancel(void);
         virtual void  OnDoAddToFavorites(int);
         virtual void  OnDoFind(void);
         virtual void  OnDoLocate(void);
         virtual void  OnFileNameChange(void);
         virtual void  OnFileNameSelectionChange(void);
         virtual void  OnFilterChange(void);
         virtual void  OnFolderChange(void);
         virtual void  OnFolderItemChange(void);
         virtual void  OnOK(void);
         virtual void  OnURLDownloadSuccess( CStringW &);
         virtual void  PrepareOkMenu( CMenu *);
         virtual void  PrepareToolsMenu( CMenu *);
         virtual void  PrepareViewsMenu( CMenu *);
         virtual void  Refresh(void);
         virtual void  UpdateUIState(void);
         void  OnContextMenu( CWnd *, CPoint);
         void  OnDestroy(void);
         void  OnKickIdle(void);
         void  OnSysColorChange(void);
 
private:
         long  OnWmDeviceChange(unsigned int,long);
         long  OnWmGetIShellBrowser(unsigned int,long);
 
};