Message Dialog Components
| Release: | 2.2 | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Date: | 31 March 2006 | ||||||||||||||||||||||||
|
Delphi Compatibility:
|
|
- Overview
- Download
- Install Info
- Bugs
- Change Log
- License
Overview
This unit provides three customisable message dialog box components. Each component enables any of the standard Windows icons to be displayed in the message box. Alternatively the icon can be taken from a user defined icon resource. Various combination of buttons and titles can be displayed. The dialogs can also show a Help button that calls a specified help topic in a nominated help file. The components are discussed below.
Components
TPJWinMsgDlg
This component wraps the Windows MessageBoxIndirect API call and displays a message box based on that provided by Windows. TPJWinMsgDlg will be suitable for most purposes and has a light footprint.
TPJVCLMsgDlg
This component uses the Delphi VCL CreateMessageDialog function to create a TForm based message box. (CreateMessageDialog is used by the standard Delphi MessageDlgXXX functions). TPJVCLMsgDlg supports all the features of TPJWinMsgDlg and extends them.
This is the most flexible component of the set. It supports all the features of TPJWinMsgDlg and extends them. TPJVCLMsgDlg should be used when it is necessary to display buttons or combinations of buttons that are not supported by the Windows API message box or when a finer degree of control over the appearance and behaviour of the message box is required.
From v2.2 the dialog box's form is exposed by the new OnShow and OnHide events. These enable the form to be customised as required. An example of how to do this can be found in the help file and demo program.
TPJMessageDialog (deprecated)
This is an updated version of the component supplied in release 1 of this unit. Various bugs have been fixed and the handling of user icons improved. This component is provided for backwards compatibility with release 1 and exposes the same properties as the old component. Some of these properties vary from those common to TPJWinMsgDlg and TPJVCLMsgDlg. It is recommended that TPJWinMsgDlg or TPJVCLMsgDlg are used in new projects.
Help File
An OpenHelp compatible help file is supplied that provides help on all the components. The help file integrates with the help system of Delphi 4 to 7. Although it does not integrate with the Delphi 2005 and later IDEs it can be used independently of the IDE, albeit with some loss of functionality.
An a-link keyword (.als) file is also supplied to assist in
integration with Delphi 6 and 7.
Demo Program
A demo program with associated explanatory help file is included in the download. The demo exercises each of the three components. It comes supplied with demo help files to enable experimentation with the components' HelpFile and HelpContext properties.
Feedback
If your have any comments on the components or find any bugs, please contact me. Existing bugs and fixes are listed on the bugs tab.