TCustomTaskDialog.Flags property

Declaration

property Flags: TTaskDialogFlags read FFlags write SetFlags default [tfAllowDialogCancellation];

Description

Flags is a TTaskDialogFlags property with the set of options enabled for the Task dialog. It contains zero or more values from the TTaskDialogFlag enumeration, which when included, enable the corresponding features in the Task Dialog. The default value for the property is [tfAllowDialogCancellation] and allows the dialog to be cancelled using the Esc key or Alt+F4 key combination.

Changing the property value causes validation and normalization of the flag values to be performed. tfQuery and tfSimpleQuery are mutually exclusive values; if both are specified in the property value, then tfSimpleQuery is excluded from the new property value. In addition, tfQuery and tfSimpleQuery causes other flag values to be ignored, and certain features are disabled. They cause the expando control (expand or collapse indicator) to be hidden and ExpandedText is displayed in the expanded state (tfExpandedByDefault). Hyperlinks (tfEnableHyperlinks) are disabled when tfQuery or tfSimpleQuery is included in the property; the markup for the hyperlink is still displayed in the text areas though.

See TTaskDialogFlag for the complete list of enumeration values allowed in the property and their meanings.

See also

• ExpandedText
• FooterText
• Text
• TTaskDialogFlags
• TTaskDialogFlag