TPJWinMsgDlg

Unit: PJMessageDialog.

TPJWinMsgDlg provides a customisable Windows message dialog box. The component wraps the Windows MessageBoxIndirect API call. It is similar to TPJMessageDialog but provides greater control over the dialog, while its properties are a subset of those of TPJVCLMsgDlg. TPJWinMsgDlg is recommended for new projects requiring a Windows message box. If even greater control over the appearance of the dialog is required then use TPJVCLMsgDlg.

The text displayed in the dialog box is determined by the Text property. Various button groupings can be displayed using the ButtonGroup property. Setting a non-zero HelpContext causes a help button to be displayed. The Kind property allows a choice of various standard windows icons to be displayed. A user defined icon extracted from a named resource, specified by IconResource can also be displayed. The window title can be set using the Title property, otherwise a default title, related to the kind of icon being displayed is used. The MakeSound property determines whether an appropriate system sound is generated when the dialog is displayed.

Methods

Method	Description
Execute	Displays the dialog box and returns information about the button pressed to close it.

Properties

Property	Description
ButtonGroup	Determines which buttons appear in the dialog box.
DlgType	Permits the buttons and type of dialog box displayed to be specified by means of the flags that are passed to the uType parameter of the Windows MessageBox API function.
HelpContext	Specifies the context number for online help and displays a help button.
HelpFile	Specifies the file to use for online help.
IconResource	Specifies the resource containing the dialog box's icon.
Kind	Determines the type of dialog box that is displayed.
MakeSound	Flag that determines if a sound will be emitted when the dialog box is displayed.
Text	The text that is displayed in the dialog box.
Title	The dialog box's window title.

Events

Event	Description
OnHelp	Event triggered when a user requests help in a dialog box.

► Sign in to add a comment