The introduction of this article was: "Once developing a wizard application I needed a dialog to select an icon from executables, but did not find anything about icon selection in MSDN. So I have searched the CodeProject and found two articles on icon selection. The first solution, by PJ Naughter (article CIconDialog - Icon Selection Dialog), uses CDialog derived class with template dialog resource to display icon selection dialog and handle its behavior, and the second, by Henk Devos (article How to display the Pick Icon Dialog), uses undocumented Windows API functions to show the system built-in icon selection dialog. I prefer to use the Windows API even if undocumented to dragging resources around, and so wrote a small class that wraps the APIs published by Henk Devos.".
But this is the 21-st centuary now and even undocumented functions become documented. So finally Microsoft included the function name we imported by ordinal 62 in the shell32.dll 5.0 exports. Its name is PickIconDlg and only UNICODE version is available starting with Windows 2000. But for the compatibility we should import it by ordinal to use under Windows NT4.0, Windows 95/98 and Me and for using the ANSI version under Windows 2000 or later.
The CIconDialog is derived from CCommonDialog and acts like any common dialog. See sample usage:
// #ifndef __ICONDLG_H__ #include "IconDialog.h" #endif //... void CSomeDialog::OnSomeBtnClicked( void ) { // If icon container file is not specified in the parameter // then by default it will open Shell32.dll file: // CIconDialog dlg( NULL, 0, this ); // // You can specify any initial file name and icon index ( if exist ). // In this case it will open index + 1 icon // ( index is 0 - based ) selected: CIconDialog dlg( _T( "%SystemRoot%\\system32\\SHELL32.dll" ), 148, this ); if( dlg.DoModal() == IDOK ) { HICON hIcon = dlg.GetIconHandle(); SetIcon( hIcon, FALSE ); // Or: // HICON hIcon = ::ExtractIcon( AfxGetInstanceHandle(), // dlg.GetIconFile(), dlg.GetIconIndex() ); } } //...
See demo project source for more.
CCommonDialog m_szIconFile - Specifies the icon file name.
m_dwIconIndex - Specifies icon index.
m_hIconHandle - Contains icon handle (last open).
m_uIconCount - Icon count in a file. Constructs a CIconDialog object.
CIconDialog(LPCTSTR lpszIconFile = NULL, DWORD dwIconIndex = 0, CWnd* pParentWnd = NULL)
lpszIconFile - The initial icon library whose icons should be open in the dialog.
dwIconIndex - The icon index initially selected when the dialog opens.
pParentWnd - A pointer to the file dialog-box object's parent or owner window. DoModal( void )- Displays the dialog box and allows the user to make a selection.
GetIconHandle( void ) const - Returns the handle of the last selected icon.
GetIconCount( void ) const - Returns the icon count of the selected icon file.
GetIconIndex( void ) const - Returns the index of the selected icon.
GetIconFile( void ) const - Returns the full path of the selected icon file. This class compiles without any warning at level 4, and fully supports both ANSI and UNICODE.
Finally Microsoft included support for the API function this class uses in the shell32.dll 5.0 or later. So we have no problem of missing ordinal using this class under:
While importing by ordinal, this class was tested and ran properly under:
It was not tested (though expected to run properly) under:
If anyone tested it on above-mentioned versions of Windows, please post a reply.
PickIconDlg function information. | You must Sign In to use this message board. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
