This is a new site that's currently running on alpha code. There are going to be bugs. If you discover any, please report them on the site's issues page (GitHub account required). Thanks.
Warning: Many URLs are going to change. Refer to the README file to discover which library project's documentation has been completed.
Project: Message Dialogue Components.
Applies to: ~>3.0
type TPJMsgDlgButtonGroup = ( bgAbortRetryIgnore, bgOK, bgOKCancel, bgRetryCancel, bgYesNo, bgYesNoCancel, bgUnknown, bgCancelTryContinue ); property ButtonGroup: TPJMsgDlgButtonGroup;
The buttons which appear in the dialogue box depend on the value of this property and on the associated Buttons property.
When the value of ButtonGroup is changed the Buttons property is updated the to the set of buttons contained in the button group. Setting ButtonGroup to
bgUnkown sets Buttons to the empty set. Conversely, when the Buttons property is changed ButtonGroup is set to any matching group, or to
bgUnknown if the set of buttons in the Buttons property is not a valid button group.
Note: Normally, setting ButtonGroup to a value other than
bgUnkown and then adding
mbHelp to the resulting Buttons set causes ButtonGroup to change to
bgUnknown. To prevent this include
mdoGroupIgnoresHelp in the Options property. Setting this option means that
mbHelp is ignored when trying to match Buttons to a valid button group and, in the case above, ButtonGroup will remain unchanged when
mbHelp is added to Buttons.
The possible values of ButtonGroup are as follows:
||Abort, Retry and Ignore buttons.|
||A single OK button.|
||An OK and a Cancel button.|
||A Retry and a Cancel button.|
||A Yes and a No button.|
||Yes, No and Cancel buttons.|
||An unsupported or unknown group of buttons. This item should not be selected explicitly. If it is selected it has the same effect as
To include a help button in the dialogue box do one of two things:
mdoAutoHelpBtnin the Options property, or
mbHelpbutton value in the Buttons property.
If a cancel button is included in the group whether it appears or not depends on whether the
mdoInhibitCancel value is included in the Options property.
A value associated with the button that was clicked is returned from the Execute method.
The default value of the property is