Skip to content

TaskDialogCommonButtons Enumeration

Description

Push buttons that can be displayed in the task dialog.

Members

Member Description
xtpTaskButtonOk OK Push Button.
xtpTaskButtonYes Yes Push Button.
xtpTaskButtonNo No Push Button.
xtpTaskButtonCancel Cancel Push Button.
xtpTaskButtonRetry Retry Push Button.
xtpTaskButtonClose Close Push Button.

Remarks

The CommonButtons property can use any combination of flags from TaskDialogCommonButtons to add common buttons to the task dialog. If the xtpTaskButtonCancel button is specified, the task dialog will respond to typical cancel actions (Alt-F4 and Escape).

The illustration below shows a dialog that has all common buttons added:

Standard Buttons

You can mix both user-defined buttons, radio buttons, common buttons, and command links. The AddButton method adds a user-defined button to the task dialog's command area. The AddRadioButton method adds a user-defined radio button to the task dialog's command area.

The EnableCommandLinks property specifies whether the buttons specified with AddButton should be displayed as command links (using a standard task dialog glyph) instead of push buttons. When using command links, all characters up to the first new line character in AddButton's Text argument will be treated as the command link's main text, and the remainder will be treated as the command link's note text.

The illustration below shows command links without icons:

Using Command Links

See Also


Copyright (c) 1998-2024 Codejock Technologies. All rights reserved.