TaskbarItemInfo-Klasse

Stellt Informationen über die Anzeige der Taskleistenminiaturansicht dar.

Vererbungshierarchie

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Freezable
        Microsoft.Windows.Shell.TaskbarItemInfo

Namespace:  Microsoft.Windows.Shell
Assembly:  Microsoft.Windows.Shell (in Microsoft.Windows.Shell.dll)

Syntax

'Declaration
Public NotInheritable Class TaskbarItemInfo _
    Inherits Freezable

public sealed class TaskbarItemInfo : Freezable

public ref class TaskbarItemInfo sealed : public Freezable

[<Sealed>]
type TaskbarItemInfo =  
    class
        inherit Freezable
    end

public final class TaskbarItemInfo extends Freezable

Der TaskbarItemInfo-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	TaskbarItemInfo	Initialisiert eine neue Instanz der TaskbarItemInfo-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	CanFreeze	Ruft einen Wert ab, der angibt, ob das Objekt als nicht änderbar festgelegt werden kann. (Von Freezable geerbt.)
	DependencyObjectType	Ruft den DependencyObjectType ab, der den CLR-Typ dieser Instanz umschließt.  (Von DependencyObject geerbt.)
	Description	Ruft den Text für die Taskleistenelement-QuickInfo ab oder legt diesen fest.
	Dispatcher	Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Von DispatcherObject geerbt.)
	IsFrozen	Ruft einen Wert ab, der angibt, ob das Objekt gegenwärtig änderbar ist. (Von Freezable geerbt.)
	IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Von DependencyObject geerbt.)
	Overlay	Ruft das Bild ab, das über dem Programmsymbol in der Taskleistenschaltfläche angezeigt wird, oder legt es fest.
	ProgressState	Ruft einen Wert ab, der angibt, wie die Statusanzeige in der Taskleistenschaltfläche angezeigt wird, oder legt ihn fest.
	ProgressValue	Ruft einen Wert ab, der den Füllzustand der Statusanzeige in der Taskleistenschaltfläche angibt, oder legt ihn fest.
	ThumbButtonInfos	Ruft die Auflistung von ThumbButtonInfo-Objekten ab, die dem Window-Objekt zugeordnet sind, oder legt diese fest.
	ThumbnailClipMargin	Ruft einen Wert ab, der angibt, welcher Teil des Clientbereichs eines Anwendungsfensters in der Taskleistenminiaturansicht angezeigt wird, oder legt ihn fest.

Zum Seitenanfang

Angefügte Eigenschaften

	Name	Beschreibung
	TaskbarItemInfo	Ruft TaskbarItemInfo ab, die an ein Fenster angehängt wird, oder legt diese fest.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	CheckAccess	Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.)
	ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft.Die zu löschende Eigenschaft wird mit einem DependencyProperty-Bezeichner angegeben. (Von DependencyObject geerbt.)
	ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft.Die zu löschende Eigenschaft wird mit einem DependencyPropertyKey angegeben. (Von DependencyObject geerbt.)
	Clone	Erstellt einen änderbaren Klon der Freezable, indem tiefe Kopien von den Werten des Objekts erzeugt werden.Beim Kopieren von Abhängigkeitseigenschaften des Objekts kopiert diese Methode Ausdrücke (die jedoch möglicherweise nicht mehr aufgelöst werden können), jedoch keine Animationen oder ihre aktuellen Werte. (Von Freezable geerbt.)
	CloneCore	Definiert die Instanz als Klon (tiefe Kopie) des angegebenen Freezable mit Basiseigenschaftswerten (nicht animiert). (Von Freezable geerbt.)
	CloneCurrentValue	Erstellt einen änderbaren Klon (tiefe Kopie) von Freezable mit den aktuellen Werten. (Von Freezable geerbt.)
	CloneCurrentValueCore	Definiert die Instanz mit aktuellen Eigenschaftswerten als änderbaren Klon (tiefe Kopie) des angegebenen Freezable. (Von Freezable geerbt.)
	CoerceValue	Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um.Für die Umwandlung wird eine vorhandene CoerceValueCallback-Funktion aufgerufen, die in den Metadaten der Abhängigkeitseigenschaft für das aufrufende DependencyObject angegeben ist. (Von DependencyObject geerbt.)
	CreateInstance	Initialisiert eine neue Instanz der Freezable-Klasse. (Von Freezable geerbt.)
	CreateInstanceCore	Erstellt beim Implementieren in einer abgeleiteten Klasse eine neue Instanz der abgeleiteten Freezable-Klasse. (Von Freezable geerbt.)
	Equals	Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Von DependencyObject geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	Freeze	Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf true fest. (Von Freezable geerbt.)
	FreezeCore	Legt das Freezable-Objekt als nicht änderbar fest oder überprüft, ob es als nicht änderbar festgelegt werden kann. (Von Freezable geerbt.)
	GetAsFrozen	Erstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert).Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Von Freezable geerbt.)
	GetAsFrozenCore	Definiert die Instanz als fixierten Klon des angegebenen Freezable mit Basiseigenschaftswerten (nicht animiert). (Von Freezable geerbt.)
	GetCurrentValueAsFrozen	Erstellt eine fixierte Kopie von Freezable mit aktuellen Eigenschaftswerten.Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Von Freezable geerbt.)
	GetCurrentValueAsFrozenCore	Legt die aktuelle Instanz als fixierten Klon des angegebenen Freezable fest.Wenn das Objekt über animierte Abhängigkeitseigenschaften verfügt, werden die aktuellen animierten Werte kopiert. (Von Freezable geerbt.)
	GetHashCode	Ruft einen Hashcode für dieses DependencyObject ab. (Von DependencyObject geerbt.)
	GetLocalValueEnumerator	Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Von DependencyObject geerbt.)
	GetTaskbarItemInfo	Ruft den Wert der angefügten Eigenschaft TaskbarItemInfo für ein Objekt ab.
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	GetValue	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft in dieser Instanz eines DependencyObject zurück. (Von DependencyObject geerbt.)
	InvalidateProperty	Berechnet den effektiven Wert für die angegebene Abhängigkeitseigenschaft neu (Von DependencyObject geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	OnChanged	Wird aufgerufen, wenn das aktuelle Freezable-Objekt geändert wird. (Von Freezable geerbt.)
	OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Stellt sicher, dass entsprechende Kontextzeiger für einen gerade festgelegten DependencyObjectType-Datenmember eingerichtet werden. (Von Freezable geerbt.)
	OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Der Member unterstützt die Windows Presentation Foundation (WPF)-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen. (Von Freezable geerbt.)
	OnPropertyChanged	Überschreibt die DependencyObject-Implementierung von OnPropertyChanged, um auch alle Changed-Handler als Reaktion auf eine Änderung einer Abhängigkeitseigenschaft vom Typ Freezable aufzurufen. (Von Freezable geerbt.)
	ReadLocalValue	Gibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück. (Von DependencyObject geerbt.)
	ReadPreamble	Stellt sicher, dass über einen gültigen Thread auf Freezable zugegriffen wird.Erben von Freezable müssen diese Methode am Anfang jeder API aufrufen, die Datenmember liest, bei denen es sich nicht um Abhängigkeitseigenschaften handelt. (Von Freezable geerbt.)
	SetTaskbarItemInfo	Legt den Wert der angefügten Eigenschaft TaskbarItemInfo für ein Objekt fest.
	SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird. (Von DependencyObject geerbt.)
	SetValue(DependencyPropertyKey, Object)	Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die über ihren DependencyPropertyKey-Bezeichner angegeben wird. (Von DependencyObject geerbt.)
	ShouldSerializeProperty	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Von DependencyObject geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
	VerifyAccess	Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.)
	WritePostscript	Löst das Changed-Ereignis für Freezable aus und ruft seine OnChanged-Methode auf.Von Freezable abgeleitete Klassen sollten diese Methode am Ende jeder API aufrufen, die nicht als Abhängigkeitseigenschaften gespeicherte Klassenmember ändert. (Von Freezable geerbt.)
	WritePreamble	Stellt sicher, dass das Freezable nicht fixiert ist und dass über einen gültigen Threadkontext darauf zugegriffen wird.Erben von Freezable sollten diese Methode am Anfang jeder API aufrufen, die Datenmember schreibt, bei denen es sich nicht um Abhängigkeitseigenschaften handelt. (Von Freezable geerbt.)

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	Changed	Tritt auf, wenn Freezable oder ein darin enthaltenes Objekt geändert wird. (Von Freezable geerbt.)

Zum Seitenanfang

Felder

	Name	Beschreibung
	DescriptionProperty	Bezeichnet die Description-Abhängigkeitseigenschaft.
	OverlayProperty	Bezeichnet die Overlay-Abhängigkeitseigenschaft.
	ProgressStateProperty	Bezeichnet die ProgressState-Abhängigkeitseigenschaft.
	ProgressValueProperty	Bezeichnet die ProgressValue-Abhängigkeitseigenschaft.
	TaskbarItemInfoProperty	Bezeichnet die TaskbarItemInfo-Abhängigkeitseigenschaft.
	ThumbButtonInfosProperty	Bezeichnet die ThumbButtonInfos-Abhängigkeitseigenschaft.
	ThumbnailClipMarginProperty	Bezeichnet die ThumbnailClipMargin-Abhängigkeitseigenschaft.

Zum Seitenanfang

Hinweise

Die TaskbarItemInfo-Klasse stellt einen verwalteten Wrapper für die Windows 7-Taskleistenfunktionalität bereit. Weitere Informationen zur Windows-Shell und den nativen Taskleisten-APIs finden Sie unter Taskleistenerweiterungen..

Die Windows 7-Taskleiste stellt die verbesserte Funktionalität bereit, mit der Sie das Taskleistenelement verwenden können, um den Status einem Benutzer mitzuteilen und häufige Aufgaben verfügbar zu machen, wenn das Fenster minimiert oder ausgeblendet wird. Die von der TaskbarItemInfo-Klasse bereitgestellte Funktionalität ist in Windows-Versionen vor Windows 7 nicht verfügbar. Anwendungen, die die TaskbarItemInfo-Klasse verwenden, können immer noch in früheren Versionen von Windows ausgeführt werden; diese Taskleistenerweiterungen sind jedoch in den früheren Versionen nicht verfügbar.

In Windows 7 sind einige Taskleistenfunktionen je nach den Einstellungen des Benutzers ggf. nicht verfügbar. Die Taskleistenfunktionalität ist z. B. nicht verfügbar, wenn Windows Aero deaktiviert ist oder wenn die Anwendung mit erhöhten Berechtigungen aufgerufen wird. Die Anwendung sollte andere Möglichkeiten bieten, um mit dem Benutzer zu interagieren, die nicht abhängig von der verbesserten Taskleistenfunktionalität in Windows 7 sind.

Die Programmsymbole im Infobereich, der sich ganz rechts in der Taskleiste befindet, werden in der Regel verwendet, um einem Benutzer den Anwendungsstatus mitzuteilen. Standardmäßig blendet die Windows 7-Taskleiste Programmsymbole im Infobereich aus. Sie können jedoch die Overlay-Eigenschaft festlegen, um der Schaltfläche der Taskleiste ein Bild hinzuzufügen, um den Status zu kommunizieren, z. B. Onlinestatus in einer Messaginganwendung. Auf dem Overlaybild können Benutzer den Anwendungsstatus sehen, auch wenn das Programmsymbol nicht im Infobereich sichtbar ist. Sie können auch den Status der Ausführung von Aufgaben auf der Schaltfläche der Taskleiste anzeigen, indem Sie die ProgressState-Eigenschaft und ProgressValue-Eigenschaft festlegen.

Die Windows 7-Taskleiste zeigt eine Miniaturansicht der Anwendung an, wenn der Mauszeiger auf der Taskleistenschaltfläche positioniert wird. Standardmäßig wird das gesamte Anwendungsfenster angezeigt. Sie können einen bestimmten Teil des Fensters angeben, der in der Miniaturansicht angezeigt werden soll. Dazu legen Sie die ThumbnailClipMargin-Eigenschaft fest. Sie können auch eine Description angeben, die in einer QuickInfo über der Taskleistenminiaturansicht angezeigt wird. Die QuickInfo wird auch angezeigt, wenn die Miniaturansicht wegen der Benutzereinstellungen nicht angezeigt wird.

Sie können der Taskleistenminiaturansicht Schaltflächen hinzufügen, um Benutzern Zugriff auf häufige Aufgaben zu geben, ohne dass sie in das Anwendungsfenster wechseln müssen. Windows Media Player stellt z. B. die Schaltflächen "Wiedergabe", "Pause", "Vor" und "Zurück" zur Verfügung, mit denen Sie die Medienwiedergabe von der Taskleistenminiaturansicht steuern können, wenn die Anwendung minimiert wird. Schaltflächen in der Taskleistenminiaturansicht werden durch ThumbButtonInfo-Objekte dargestellt und sind in der ThumbButtonInfos-Auflistung enthalten.

In der folgenden Abbildung werden die erweiterten Features der Windows 7-Taskleiste veranschaulicht.

Erweiterte Funktionen der Windows-Taskleiste

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

Microsoft.Windows.Shell-Namespace