TaskDialogIcon Class

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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 ref class TaskDialogIcon : IDisposable

public class TaskDialogIcon : IDisposable

type TaskDialogIcon = class
    interface IDisposable

Public Class TaskDialogIcon
Implements IDisposable

Inheritance: Object
TaskDialogIcon

Implements: IDisposable

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

Deila með