Edit

Share via


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.