TTaskDialogFlag enumeration
Represents options that can be enabled for TTaskDialog.
Declaration
TTaskDialogFlag = (tfEnableHyperlinks,tfUseHiconMain,tfUseHiconFooter,
tfAllowDialogCancellation,tfUseCommandLinks,
tfUseCommandLinksNoIcon,tfExpandFooterArea,
tfExpandedByDefault,tfVerificationFlagChecked,
tfShowProgressBar,tfShowMarqueeProgressBar,
tfCallbackTimer,tfPositionRelativeToWindow,
tfRtlLayout,tfNoDefaultRadioButton,tfCanBeMinimized,
tfNoSetForeGround,tfSizeToContent,tfForceNonNative,
tfEmulateClassicStyle,tfQuery,tfSimpleQuery,
tfQueryFixedChoices,tfQueryFocused)Description
TTaskDialogFlag values are stored in the TTaskDialogFlags type, as used in the TCustomTaskDialog.Flags property.
Modified in LCL 3.0 to include tfEmulateClassicStyle in the enumeration.
Modified in LCL 4.0 to include additional flag values in the enumeration.
See also
Values
tfEnableHyperlinks | Allows HTML-like hyperlinks in the dialog (in Text, FooterText, and ExpandedText) using the '<a href="target">Target</a>' notation. For platforms that use an emulated (non-native) task dialog form, the markup text is displayed instead of a formatted hyperlink. |
tfUseHiconMain | Uses the handle to the image in MainIcon as the primary image for the Task dialog. Disables hyperlinks and expanded text areas. Not used in the current implementation. |
tfUseHiconFooter | Uses the handle to the image in FooterIcon as the footer icon in the Task dialog. Disables hyperlinks and expanded text areas. Not used in the current implementation. |
tfAllowDialogCancellation | Allow cancelling the dialog using the Esc key or Alt+F4 (i.e. OS default hotkey). |
tfUseCommandLinks | Custom buttons will be shown as larger buttons with an icon in the text content area on the dialog. On native task dialog forms, the CommandLinkHint for buttons is included on a separate line (using a slightly smaller font) on the buttons. On emulated task dialog forms, the text in the CommandLinkHi |
tfUseCommandLinksNoIcon | Like tfUseCommandLinks, but hides glyphs for custom buttons in the "command links" mode. |
tfExpandFooterArea | Show ExpandedText in the footer, instead of immediately after the main text. |
tfExpandedByDefault | Displays the dialog with the content in ExpandedText in the expanded state. |
tfVerificationFlagChecked | Displays the verification check-box using the checked state on entry. |
tfShowProgressBar | Shows a progress bar on the dialog form. Implemented for native Windows Vista or later platforms. |
tfShowMarqueeProgressBar | Shows a progress bar on the dialog form using the marquee style. Implemented for native Windows Vista or later platforms. |
tfCallbackTimer | Execute the timer callback event every 200 milliseconds. Enables the timer event on the dialog form. |
tfPositionRelativeToWindow | Position for the dialog form is set to poOwnerFormCenter instead of poScreenCenter. |
tfRtlLayout | Use Right-to-Left layout for texts. Implemented for native Windows Vista or later platforms. |
tfNoDefaultRadioButton | Does not pre-select a default radio button. |
tfCanBeMinimized | Allows the dialog form to be minimized. |
tfNoSetForeGround | Prevents bringing the dialog to the foreground when the dialog is activated. Implemented for native Windows Vista or later platforms. |
tfSizeToContent | Indicates the width for the dialog is determined by the caption, title, or lines of text in the content areas areas. The flag is ignored if the dialog width is not set to 0 (zero). Implemented for native Windows Vista or later platforms. |
tfForceNonNative | Forces use of an emulated task dialog form. |
tfEmulateClassicStyle | Causes the dialog form to be displayed using a classic style where the content areas use clForm as the background color instead of clWindow. Applies to platforms which use an emulated task dialog only. |
tfQuery | Causes a query input control to be displayed on the task dialog using an editable (non-fixed) combo-box control. |
tfSimpleQuery | Causes a query input control to be displayed on the task dialog using a simple TEdit control instance with optional password character-style obfuscation. tfQuery takes precedence if both values are included in the flags for a task dialog. |
tfQueryFixedChoices | Causes a query input control to be displayed on the task dialog using a combo-box to select from non-editable predefined values. tfQuery must also be included to enable a query control on the dialog form. |
tfQueryFocused | Causes the query input control to be focused when the task dialog is executed. Requires tfQuery or tfSimpleQuery in the flags for a task dialog. |
An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.