Edit

Share via


TaskDialogIcon Class

Definition

Represents an icon that can be shown in the main area of a task dialog (by setting the Icon property) or in the footnote of a task dialog (by setting the Icon property).

public class TaskDialogIcon : IDisposable
Inheritance
TaskDialogIcon
Implements

Remarks

The task dialog currently supports two icon types: Standard icons that are stored in static fields of class TaskDialogIcon, and custom icons created from an Icon instance (or an icon handle).

Some standard icons play a typical system sound when used as the main icon of the task dialog.

Note that while a task dialog is shown, you can only update an icon if the new icon is of the same type (standard icon or custom icon) as the previous one.

Constructors

TaskDialogIcon(Bitmap)

Initializes a new instance of the TaskDialogIcon class from an Bitmap instance.

TaskDialogIcon(Icon)

Initializes a new instance of the TaskDialogIcon class from an Icon instance.

TaskDialogIcon(IntPtr)

Initializes a new instance of the TaskDialogIcon class from an icon handle.

Fields

Error

Gets a standard TaskDialogIcon instance where the task dialog contains an icon consisting of white X in a circle with a red background.

Information

Gets a standard TaskDialogIcon instance where the task dialog contains a symbol consisting of a lowercase letter i in a circle.

None

Gets a standard TaskDialogIcon instance where the task dialog does not display an icon.

Shield

Gets a standard TaskDialogIcon instance where the task dialog contains an icon consisting of an user account control (UAC) shield.

ShieldBlueBar

Gets a standard TaskDialogIcon instance where the task dialog contains an icon consisting of an user account control (UAC) shield and shows a blue bar around the icon.

ShieldErrorRedBar

Gets a standard TaskDialogIcon instance where the task dialog contains an icon consisting of white X in a red shield and shows a red bar around the icon.

ShieldGrayBar

Gets a standard TaskDialogIcon instance where the task dialog contains an icon consisting of an user account control (UAC) shield and shows a gray bar around the icon.

ShieldSuccessGreenBar

Gets a standard TaskDialogIcon instance where the task dialog contains an icon consisting of white tick in a green shield and shows a green bar around the icon.

ShieldWarningYellowBar

Gets a standard TaskDialogIcon instance where the task dialog contains an icon consisting of an exclamation point in a yellow shield and shows a yellow bar around the icon.

Warning

Gets a standard TaskDialogIcon instance where the task dialog contains an icon consisting of an exclamation point in a triangle with a yellow background.

Properties

IconHandle

The icon handle (HICON) that is represented by this TaskDialogIcon instance.

Methods

Dispose()

Releases all resources used by this TaskDialogIcon.

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Returns a string that represents the current object.

(Inherited from Object)

Applies to

Product Versions
Windows Desktop 5, 6, 7, 8, 9