OLEUICHANGEICON
The OLEUICHANGEICON structure contains information that the OLE User Interface Library uses to initialize the Change Icon dialog box, and it contains space for the library to return information when the dialog box is dismissed.
typedef struct tagOLEUICHANGEICON
{
// These IN fields are standard across all OLEUI dialog box functions.
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCSTR lpszTemplate;
HRSRC hResource;
// Specifics for OLEUICHANGEICON.
HGLOBAL hMetaPict;
CLSID clsid;
char szIconExe[OLEUI_CCHPATHMAX];
int cchIconExe;
} OLEUICHANGEICON, *POLEUICHANGEICON, FAR *LPOLEUICHANGEICON;
Members
-
cbStruct
-
Size of the structure in bytes. This field must be filled on input.
-
dwFlags
-
On input, specifies the initialization and creation flags. On exit, it specifies the user's choices. It can be a combination of the following flags:
-
CIF_SHOWHELP
-
Dialog box will display a Help button.
-
CIF_SELECTCURRENT
-
On input, selects the Current radio button on initialization. On exit, specifies that the user selected Current.
-
CIF_SELECTDEFAULT
-
On input, selects the Default radio button on initialization. On exit, specifies that the user selected Default.
-
CIF_SELECTFROMFILE
-
On input, selects the From File radio button on initialization. On exit, specifies that the user selected From File.
-
CIF_USEICONEXE
-
Input only. Extracts the icon from the executable specified in the szIconExe member, instead of retrieving it from the class. This is useful for OLE embedding or linking to non-OLE files.
-
hWndOwner
-
Window that owns the dialog box. It should not be NULL.
-
lpszCaption
-
Pointer to a string to be used as the title of the dialog box. If NULL, then the library uses Change Icon.
-
lpfnHook
-
Pointer to a hook function that processes messages intended for the dialog box. The hook function must return zero to pass a message that it didn't process back to the dialog box procedure in the library. The hook function must return a non-zero value to prevent the library's dialog box procedure from processing a message it has already processed.
-
lCustData
-
Application-defined data that the library passes to the hook function pointed to by the lpfnHook member. The library passes a pointer to the OLEUICHANGEICON structure in the lParam parameter of the WM_INITDIALOG message; this pointer can be used to retrieve the lCustData member.
-
hInstance
-
Instance that contains a dialog box template specified by the lpTemplateName member.
-
lpszTemplate
-
Pointer to a null-terminated string that specifies the name of the resource file for the dialog box template that is to be substituted for the library's Change Icon dialog box template.
-
hResource
-
Customized template handle.
-
hMetaPict
-
Current and final image. The source of the icon is embedded in the metafile itself.
-
clsid
-
Input only. The class to use to get the Default icon.
-
szIconExe
-
Input only. Pointer to the executable to extract the default icon from. This member is ignored unless CIF_USEICONEXE is included in the dwFlags parameter and an attempt to retrieve the class icon from the specified CLSID fails.
-
cchIconExe
-
Input only. The number of characters in szIconExe. This member is ignored unless CIF_USEICONEXE is included in the dwFlags member.
QuickInfo
Windows NT: Use version 3.1 or later.
Windows: Use Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in oledlg.h.
Import Library: Included as a resource in oledlg.dll.
See Also
OleUIChangeIcon