Im letzten Artikel habe ich bereits die Eigenschaften ProgressState und ProgressValue vorgestellt. In diesem Artikel werden die anderen TaskbarItemInfo-Eigenschaften behandelt.

Description

Die Eigenschaft Description bestimmt den Text im Tooltip, wenn das Thumbnail eine längere Zeit offen ist. Sie nimmt einen String an.

Overlay

Ein Overlay ist ein kleines Icon, welches über das Programmicon in der Superbar gelegt wird, um beispielsweise einen bestimmten Status darzustellen. Die Eigenschaft erwartet ein Image.

ThumbnailClipMargin

ThumbnailClipMargin (Quelle: MSDN Library)

Die Eigenschaft ThumbnailClipMargin bestimmt den Ausschnitt des angezeigten Thumbnails und erwartet einen Thickness-Wert, mit dem der Ausschnitt eingegrenzt wird. Das Bild aus der MSDN Library beschreibt das Ganze sehr gut.

ThumbButtonInfos

ThumbButtons sind kleine Buttons, die unter dem Thumbnail angezeigt werden, um bestimmte Aktionen schnell tätigen zu können. ThumbButtonInfos erwartet eine ThumbButtonInfoCollection, die die ThumbButtons beherbergt. Eine genaue Erklärung sowie ein Beispiel finden Sie hier in der MSDN Library.

Wahrscheinlich haben Sie – sofern Sie Windows 7 benutzen – schon einmal diesen Status- beziehungsweise Ladebalken in der Superbar gesehen. Seit dem .NET Framework 4 gibt es einen entsprechenden Namespace für die Superbar für WPF: System.Windows.Shell.

In diesem findet sich unter Anderem die Klasse TaskbarItemInfo, welche für ein TaskbarItem, also im Normalfall ein Fenster, den Ladebalken-Status und dessen Fortschritt, so genannte ThubnailButtons (Buttons unter dem Thumbnail), den Thumbnailausschnitt, ein Overlay für das Programm-Icon und die Beschreibung im Tooltip des Thumbnails zuständig ist.

In diesem Artikel geht es um die Ladebalkeneigenschaften. Damit Sie auf diese zugreifen zu können, benötigen Sie eine TaskbarItemInfo-Instanz, welche der gleichnamigen Eigenschaft eines Windows zugeordnet ist. Dies lässt sich am leichtesten in XAML realisieren:

XAML

<Window [...]>
	<Window.TaskbarItemInfo>
		<TaskbarItemInfo/>
	</Window.TaskbarItemInfo>
</Window>

Alternativ können Sie dasselbe natürlich auch im Code-Behind machen:

VB.NET

Me.TaskbarItemInfo = New Shell.TaskbarItemInfo()

C#

this.TaskbarItemInfo = new Shell.TaskbarItemInfo();

Nun können Sie auf die Eigenschaften ProgressValue und ProgressState des TaskbarItemInfo-Objekts zugreifen, mit denen Sie den Fortschritt und den Status des Ladebalkens beeinflussen können. Die Eigenschaft ProgressState erwartet einen Wert aus der Enumeration System.Windows.Shell.TaskbarItemProgressState. Die folgenden Werte gibt es:

Ladebalken mit ProgressState = Indeterminate

• None – Es wird kein Ladebalken angezeigt.
• Normal – Es wird ein normaler, grüner Ladebalken angezeigt.
• Paused – Es wird ein gelber Ladebalken angezeigt. Dieser ist für Pausen im Ladevorgang gedacht.
• Error – Es wird ein roter Ladebalken angezeigt. Dieser ist für Fehler gedacht.
• Indeterminate – Es wird ein durchlaufender, grüner Ladebalken angezeift. Dieser ist für Aktionen gedacht, bei denen der aktuelle Fortschritt nicht angezeigt werden kann.

ProgressValue ist ein Double-Wert, der den Prozentsatz als Dezimalzahl angibt, also eine Zahl zwischen 0 und 1. Werte über 1 gelten als 1; Werte unter 0 gelten als 0. Der Wert Double.NaN gilt ebenfalls als 0.