Dialog Boxes
Overview of the Dialog Boxes technology.
To develop Dialog Boxes, you need these headers:
For programming guidance for this technology, see:
Functions
| AddRef The IPrintDialogCallback::AddRef method (commdlg.h) is IUnknown's AddRef method, which decrements the reference count for an interface on a COM object. |
| AddRef The IPrintDialogServices::AddRef method (commdlg.h) is IUnknown's AddRef method, which decrements the reference count for an interface on a COM object. |
| CDSIZEOF_STRUCT Gets the size of a struct up to the specified member |
| ChooseColorA The CHOOSECOLORA (ANSI) function (commdlg.h) contains information the ChooseColor function uses to initialize the Color dialog box. |
| ChooseColorW Wide string version of ChooseColor |
| ChooseFontA ASCII version of ChooseFont |
| ChooseFontW Wide string version of ChooseFont |
| CommDlg_OpenSave_GetFilePathA ASCII version of CommDlg_OpenSave_GetFilePath |
| CommDlg_OpenSave_GetFilePathW Wide string version of CommDlg_OpenSave_GetFilePath |
| CommDlg_OpenSave_GetFolderIDList Retrieves the address of the item identifier list corresponding to the folder that an Explorer-style Open or Save As dialog box currently has open. |
| CommDlg_OpenSave_GetFolderPathA ASCII version of CommDlg_OpenSave_GetFolderPath |
| CommDlg_OpenSave_GetFolderPathW Wide string version of CommDlg_OpenSave_GetFolderPath |
| CommDlg_OpenSave_GetSpecA ASCII version of CommDlg_OpenSave_GetSpec |
| CommDlg_OpenSave_GetSpecW Wide string version of CommDlg_OpenSave_GetSpec |
| CommDlg_OpenSave_HideControl Hides the specified control in an Explorer-style Open or Save As dialog box. |
| CommDlg_OpenSave_SetControlText Sets the text for the specified control in an Explorer-style Open or Save As dialog box. |
| CommDlg_OpenSave_SetDefExt Sets the default file name extension for an Explorer-style Open or Save As dialog box. |
| CommDlgExtendedError The CommDlgExtendedError function (commdlg.h) returns a common dialog box error code. |
| CreateDialogA Creates a modeless dialog box from a dialog box template resource. The CreateDialog macro uses the CreateDialogParam function. (ANSI) |
| CreateDialogIndirectA Creates a modeless dialog box from a dialog box template in memory. The CreateDialogIndirect macro uses the CreateDialogIndirectParam function. (ANSI) |
| CreateDialogIndirectParamA Creates a modeless dialog box from a dialog box template in memory. (ANSI) |
| CreateDialogIndirectParamW Creates a modeless dialog box from a dialog box template in memory. (Unicode) |
| CreateDialogIndirectW Creates a modeless dialog box from a dialog box template in memory. The CreateDialogIndirect macro uses the CreateDialogIndirectParam function. (Unicode) |
| CreateDialogParamA Creates a modeless dialog box from a dialog box template resource. (ANSI) |
| CreateDialogParamW Creates a modeless dialog box from a dialog box template resource. (Unicode) |
| CreateDialogW Creates a modeless dialog box from a dialog box template resource. The CreateDialog macro uses the CreateDialogParam function. (Unicode) |
| DefDlgProcA Calls the default dialog box window procedure to provide default processing for any window messages that a dialog box with a private window class does not process. (ANSI) |
| DefDlgProcW Calls the default dialog box window procedure to provide default processing for any window messages that a dialog box with a private window class does not process. (Unicode) |
| DialogBoxA Creates a modal dialog box from a dialog box template resource. DialogBox does not return control until the specified callback function terminates the modal dialog box by calling the EndDialog function. (ANSI) |
| DialogBoxIndirectA Creates a modal dialog box from a dialog box template in memory. DialogBoxIndirect does not return control until the specified callback function terminates the modal dialog box by calling the EndDialog function. (ANSI) |
| DialogBoxIndirectParamA Creates a modal dialog box from a dialog box template in memory. (ANSI) |
| DialogBoxIndirectParamW Creates a modal dialog box from a dialog box template in memory. (Unicode) |
| DialogBoxIndirectW Creates a modal dialog box from a dialog box template in memory. DialogBoxIndirect does not return control until the specified callback function terminates the modal dialog box by calling the EndDialog function. (Unicode) |
| DialogBoxParamA Creates a modal dialog box from a dialog box template resource. (ANSI) |
| DialogBoxParamW Creates a modal dialog box from a dialog box template resource. (Unicode) |
| DialogBoxW Creates a modal dialog box from a dialog box template resource. DialogBox does not return control until the specified callback function terminates the modal dialog box by calling the EndDialog function. (Unicode) |
| DLGPROC Application-defined callback function used with the CreateDialog and DialogBox families of functions. |
| EndDialog Destroys a modal dialog box, causing the system to end any processing for the dialog box. |
| FindTextA Creates a system-defined modeless Find dialog box that lets the user specify a string to search for and options to use when searching for text in a document. (ANSI) |
| FindTextW Creates a system-defined modeless Find dialog box that lets the user specify a string to search for and options to use when searching for text in a document. (Unicode) |
| GetCurrentDevMode Fills a DEVMODE structure with information about the currently selected printer for use with PrintDlgEx. |
| GetCurrentPortName Retrieves the name of the current port for use with PrintDlgEx. |
| GetCurrentPrinterName Retrieves the name of the currently selected printer, for use with PrintDlgEx. |
| GetDialogBaseUnits Retrieves the system's dialog base units, which are the average width and height of characters in the system font. |
| GetDlgCtrlID Retrieves the identifier of the specified control. |
| GetDlgItem Retrieves a handle to a control in the specified dialog box. |
| GetDlgItemInt Translates the text of a specified control in a dialog box into an integer value. |
| GetDlgItemTextA Retrieves the title or text associated with a control in a dialog box. (ANSI) |
| GetDlgItemTextW Retrieves the title or text associated with a control in a dialog box. (Unicode) |
| GetFileTitleA Retrieves the name of the specified file. (ANSI) |
| GetFileTitleW Retrieves the name of the specified file. (Unicode) |
| GetNextDlgGroupItem Retrieves a handle to the first control in a group of controls that precedes (or follows) the specified control in a dialog box. |
| GetNextDlgTabItem Retrieves a handle to the first control that has the WS_TABSTOP style that precedes (or follows) the specified control. |
| GetOpenFileNameA Creates an Open dialog box that lets the user specify the drive, directory, and the name of a file or set of files to be opened. (ANSI) |
| GetOpenFileNameW Creates an Open dialog box that lets the user specify the drive, directory, and the name of a file or set of files to be opened. (Unicode) |
| GetSaveFileNameA Creates a Save dialog box that lets the user specify the drive, directory, and name of a file to save. (ANSI) |
| GetSaveFileNameW Creates a Save dialog box that lets the user specify the drive, directory, and name of a file to save. (Unicode) |
| HandleMessage Called by PrintDlgEx to give your application an opportunity to handle messages sent to the child dialog box in the lower portion of the General page of the Print Property Sheet. |
| InitDone Called by PrintDlgEx when the system has finished initializing the General page of the Print Property Sheet. |
| IsDialogMessageA Determines whether a message is intended for the specified dialog box and, if it is, processes the message. (ANSI) |
| IsDialogMessageW Determines whether a message is intended for the specified dialog box and, if it is, processes the message. (Unicode) |
| LPCCHOOKPROC Receives messages or notifications intended for the default dialog box procedure of the Color dialog box. This is an application-defined or library-defined callback function that is used with the ChooseColor function. |
| LPCFHOOKPROC Receives messages or notifications intended for the default dialog box procedure of the Font dialog box. This is an application-defined or library-defined callback procedure that is used with the ChooseFont function. |
| LPFRHOOKPROC Receives messages or notifications intended for the default dialog box procedure of the Find or Replace dialog box. |
| LPOFNHOOKPROC Receives notification messages sent from the dialog box. |
| LPPAGEPAINTHOOK Receives messages that allow you to customize drawing of the sample page in the Page Setup dialog box. The PagePaintHook hook procedure is an application-defined or library-defined callback function used with the PageSetupDlg function. |
| LPPAGESETUPHOOK Receives messages or notifications intended for the default dialog box procedure of the Page Setup dialog box. The PageSetupHook hook procedure is an application-defined or library-defined callback function used with the PageSetupDlg function. |
| LPPRINTHOOKPROC Receives messages or notifications intended for the default dialog box procedure of the Print dialog box. This is an application-defined or library-defined callback function that is used with the PrintDlg function. |
| LPSETUPHOOKPROC An application-defined or library-defined callback function used with the PrintDlg function. The hook procedure receives messages or notifications intended for the default dialog box procedure of the Print Setup dialog box. |
| MapDialogRect Converts the specified dialog box units to screen units (pixels). |
| MessageBox The MessageBox function displays a modal dialog box that contains a system icon, a set of buttons, and a brief application-specific message. |
| MessageBoxA Displays a modal dialog box that contains a system icon, a set of buttons, and a brief application-specific message, such as status or error information. The message box returns an integer value that indicates which button the user clicked. (MessageBoxA) |
| MessageBoxExA Creates, displays, and operates a message box. (ANSI) |
| MessageBoxExW Creates, displays, and operates a message box. (Unicode) |
| MessageBoxIndirectA Creates, displays, and operates a message box. The message box contains application-defined message text and title, any icon, and any combination of predefined push buttons. (ANSI) |
| MessageBoxIndirectW Creates, displays, and operates a message box. The message box contains application-defined message text and title, any icon, and any combination of predefined push buttons. (Unicode) |
| MessageBoxW The MessageBoxW (Unicode) function displays a modal dialog box that contains a system icon, a set of buttons, and a brief application-specific message. |
| MSGBOXCALLBACK A callback function, which you define in your application, that processes help events for the message box. |
| PageSetupDlgA ASCII version of PageSetupDlg |
| PageSetupDlgW Wide string version of PageSetupDlg |
| PrintDlgA ASCII version of PrintDlg |
| PrintDlgExA ASCII version of PrintDlgEx |
| PrintDlgExW Wide string version of PrintDlgEx |
| PrintDlgW Wide string version of PrintDlg |
| QueryInterface The IPrintDialogCallback::QueryInterface method (commdlg.h) is IUnknown's QueryInterface method, which queries a COM object for a pointer. |
| QueryInterface The IPrintDialogServices::QueryInterface method (commdlg.h) is IUnknown's QueryInterface method, which queries a COM object for a pointer. |
| Release The IPrintDialogCallback::Release method (commdlg.h) is IUnknown's Release method, which decrements the reference count for an interface on a COM object. |
| Release The IPrintDialogServices::Release method (commdlg.h) is IUnknown's Release method, which decrements the reference count for an interface on a COM object. |
| ReplaceTextA Creates a system-defined modeless dialog box that lets the user specify a string to search for and a replacement string, as well as options to control the find and replace operations. (ANSI) |
| ReplaceTextW Creates a system-defined modeless dialog box that lets the user specify a string to search for and a replacement string, as well as options to control the find and replace operations. (Unicode) |
| SelectionChange Called by PrintDlgEx when the user selects a different printer from the list of installed printers on the General page of the Print Property Sheet. |
| SendDlgItemMessageA Sends a message to the specified control in a dialog box. (ANSI) |
| SendDlgItemMessageW Sends a message to the specified control in a dialog box. (Unicode) |
| SetDlgItemInt Sets the text of a control in a dialog box to the string representation of a specified integer value. |
| SetDlgItemTextA Sets the title or text of a control in a dialog box. (ANSI) |
| SetDlgItemTextW Sets the title or text of a control in a dialog box. (Unicode) |
Interfaces
| IPrintDialogCallback Provides methods that enable an application to receive notifications and messages from the PrintDlgEx function while the Print Property Sheet is displayed. |
| IPrintDialogServices Provides methods that enable an application using the PrintDlgEx function to retrieve information about the currently selected printer. |
Structures
| CHOOSEFONTA Contains information that the ChooseFont function uses to initialize the Font dialog box. After the user closes the dialog box, the system returns information about the user's selection in this structure. (ANSI) |
| CHOOSEFONTW Contains information that the ChooseFont function uses to initialize the Font dialog box. After the user closes the dialog box, the system returns information about the user's selection in this structure. (Unicode) |
| DEVNAMES Contains strings that identify the driver, device, and output port names for a printer. |
| DLGITEMTEMPLATE Defines the dimensions and style of a control in a dialog box. One or more of these structures are combined with a DLGTEMPLATE structure to form a standard template for a dialog box. |
| DLGTEMPLATE Defines the dimensions and style of a dialog box. |
| FINDREPLACEA Contains information that the FindText and ReplaceText functions use to initialize the Find and Replace dialog boxes. (ANSI) |
| FINDREPLACEW Contains information that the FindText and ReplaceText functions use to initialize the Find and Replace dialog boxes. (Unicode) |
| MSGBOXPARAMSA Contains information used to display a message box. The MessageBoxIndirect function uses this structure. (ANSI) |
| MSGBOXPARAMSW Contains information used to display a message box. The MessageBoxIndirect function uses this structure. (Unicode) |
| OFNOTIFYA Contains information about a WM_NOTIFY message sent to an OFNHookProc hook procedure for an Open or Save As dialog box. The lParam parameter of the WM_NOTIFY message is a pointer to an OFNOTIFY structure. (ANSI) |
| OFNOTIFYEXA Contains information about a CDN_INCLUDEITEM notification message. (ANSI) |
| OFNOTIFYEXW Contains information about a CDN_INCLUDEITEM notification message. (Unicode) |
| OFNOTIFYW Contains information about a WM_NOTIFY message sent to an OFNHookProc hook procedure for an Open or Save As dialog box. The lParam parameter of the WM_NOTIFY message is a pointer to an OFNOTIFY structure. (Unicode) |
| OPENFILENAME_NT4A The OPENFILENAME_NT4 structure is identical to OPENFILENAME with _WIN32_WINNT set to 0x0400. (ANSI) |
| OPENFILENAME_NT4W The OPENFILENAME_NT4 structure is identical to OPENFILENAME with _WIN32_WINNT set to 0x0400. (Unicode) |
| OPENFILENAMEA Contains information that the GetOpenFileName and GetSaveFileName functions use to initialize an Open or Save As dialog box. After the user closes the dialog box, the system returns information about the user's selection in this structure. (ANSI) |
| OPENFILENAMEW Contains information that the GetOpenFileName and GetSaveFileName functions use to initialize an Open or Save As dialog box. After the user closes the dialog box, the system returns information about the user's selection in this structure. (Unicode) |
| PAGESETUPDLGA Contains information the PageSetupDlg function uses to initialize the Page Setup dialog box. After the user closes the dialog box, the system returns information about the user-defined page parameters in this structure. (ANSI) |
| PAGESETUPDLGW Contains information the PageSetupDlg function uses to initialize the Page Setup dialog box. After the user closes the dialog box, the system returns information about the user-defined page parameters in this structure. (Unicode) |
| PRINTDLGA Contains information that the PrintDlg function uses to initialize the Print Dialog Box. After the user closes the dialog box, the system uses this structure to return information about the user's selections. (ANSI) |
| PRINTDLGEXA Contains information that the PrintDlgEx function uses to initialize the Print property sheet. After the user closes the property sheet, the system uses this structure to return information about the user's selections. (ANSI) |
| PRINTDLGEXW Contains information that the PrintDlgEx function uses to initialize the Print property sheet. After the user closes the property sheet, the system uses this structure to return information about the user's selections. (Unicode) |
| PRINTDLGW Contains information that the PrintDlg function uses to initialize the Print Dialog Box. After the user closes the dialog box, the system uses this structure to return information about the user's selections. (Unicode) |
| PRINTPAGERANGE Represents a range of pages in a print job. A print job can have more than one page range. This information is supplied in the PRINTDLGEX structure when calling the PrintDlgEx function. |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for