For MFC developers, this is a freeware DDX routine that subclasses an edit control to allow to easily specify a filename.
Introduction
For developers who use MFC, this is a freeware DDX routine which subclasses an edit control to allows you to easily specify a filename. When the edit control is correctly set up, it will look like:
The button beside the edit control sports a tooltip when the button is over it and when the button is hit, a modified version of the common file open dialog is displayed to allow the user to select a filename as:
Both the caption and file extension filter can be customized through the DDX routine. Other flags allow the developer to customize whether overwrites are notified to the user, only existing files allowed and the option to use the old style common file open dialogs which will look like:
The routine is most useful when you want to specify a filename from somewhere in the user interface but don't necessarily want to "Open" or "Save" a file. Note that the default button has the text "OK" as opposed to "Save" or "Open" which is what you normally would get with the standard common file dialogs.
Table of Contents
- Simple DDX and DDV functions which you can use in your MFC code.
- All the code is fully UNICODE compliant.
- A simple test app is included.
To use DDXFile
in your project, simply include ddxfile.cpp and the six string
resources from the test application in your application. Then #include ddxfile.h
in whichever of your modules requires it and make the appropriate calls. Included is a simple dialog based application which shows how to use it. Basically, all you need to do is add to your DoDataExchange()
function as follows:
void CTestgetfileDlg::DoDataExchange(CDataExchange* pDX)
{
CDialog::DoDataExchange(pDX);
DDX_FilenameControl(pDX, IDC_FILE,
m_ctrlGetFile, dwFlags, _T("Please specify a filename"));
}
v1.1 (17th September 1998)
- Updated all the documentation to be HTML based as with my other shareware/freeware
- Unicode enabled all the code, and provision of Unicode build configurations
- VC 5 mak files provided now as standard
- Provision of a DDV function
- General tidying up of the sample app including removing all the AppWizard generated comments
- All code now compiles cleanly at warning level 4
- Replaced all
TRACE0
calls with TRACE
- Changed name of main function from
DDX_GetFileControl()
to DDX_FilenameControl()
- Module name has been changed from
ddxgetfile
to ddxfile
- Sample app now allows read only state of widget to be toggled
- Addition of a
DDX_FileValue()
function - Change the IDs of the strings in the resource table which the code uses
v1.11 (11th December 1999)
- Cosmetic item where now a 1 pixel space is included between the edit control and the "..." button.
The following functions are provided:
DDX_FilenameControl
void DDX_FilenameControl(CDataExchange* pDX, int nIDC,
CGetFilenameControl& rCGetFilenameControl, DWORD dwFlags,
const CString& sDialogTitle, const CString& sExtFilter);
Parameters
pDX
-- The usual CDataExchange
object which will be passed into your DoDataExchange
function nIDC
-- The dialog ID of the edit control to subclass rCGetFilenameControl
-- Contains upon return, the window control which manages the compound edit and button controls dwFlags
-- A combination of the bit values to customize the display of the dialog. See ddxfile.h for all the allowable values sDialogTitle
-- The caption to use for the filename picker dialog
Remarks
Associates an existing edit control with dialog ID nIDC
to a compound filename picker control. Normally, you would call this function in your dialog class' DoDataExchange()
member function.
DDX_FilenameValue
void DDX_FilenameValue(CDataExchange* pDX,
CGetFilenameControl& rCGetFilenameControl, CString& sFile);
Parameters
pDX
-- The usual CDataExchange
object which will be passed into your DoDataExchange
function rCGetFilenameControl
-- The folder control to get or set the filename for sFile
-- The actual file to get or set into the control, depending on the direction of data exchange occurring
DDV_FilenameControl
void DDV_FilenameControl
(CDataExchange* pDX, CGetFilenameControl& rCGetFilenameControl, DWORD dwFlags);
Parameters
pDX
-- The usual CDataExchange
object which will be passed into your DoDataExchange
function rCGetFilenameControl
-- The filename control to get or set the filename for dwFlags
-- The flags to customize the behavior of the control. The available flags are:
GF_OVERWRITEPROMPT
- The user will be prompted about overwriting existing file prior to allowing selection. GF_FILEMUSTEXIST
- File must exist to be selected. GF_OLD_STYLE_DIALOG
- Use the old style file open dialog instead of the style as used in Windows Explorer.
History
- 11th December, 1999: Initial version
License
This article has no explicit license attached to it, but may contain usage terms in the article text or the download files themselves. If in doubt, please contact the author via the discussion board below.
A list of licenses authors might use can be found here.