ThumbButtonInfo-Klasse

Stellt Informationen zur Anzeige einer Schaltfläche in der Windows 7-Taskleistenminiaturansicht dar.

Vererbungshierarchie

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

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

Syntax

'Declaration
Public NotInheritable Class ThumbButtonInfo _
    Inherits Freezable _
    Implements ICommandSource

public sealed class ThumbButtonInfo : Freezable, 
    ICommandSource

public ref class ThumbButtonInfo sealed : public Freezable, 
    ICommandSource

[<Sealed>]
type ThumbButtonInfo =  
    class
        inherit Freezable
        interface ICommandSource
    end

public final class ThumbButtonInfo extends Freezable implements ICommandSource

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

Konstruktoren

	Name	Beschreibung
	ThumbButtonInfo	Initialisiert eine neue Instanz der ThumbButtonInfo-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.)
	Command	Ruft den Befehl ab, der beim Klicken auf diese Miniaturansichtsschaltfläche aufgerufen wird, oder legt ihn fest.
	CommandParameter	Ruft den Parameter ab, der an die Command-Eigenschaft übergeben wird, oder legt diesen fest.
	CommandTarget	Ruft das Element ab, für das der angegebene Befehl ausgelöst werden soll, oder legt dieses fest.
	DependencyObjectType	Ruft den DependencyObjectType ab, der den CLR-Typ dieser Instanz umschließt.  (Von DependencyObject geerbt.)
	Description	Ruft den Text für die Miniaturansichtsschaltflächen-QuickInfo ab oder legt diesen fest.
	DismissWhenClicked	Ruft einen Wert ab, der angibt, ob die Taskleistenminiaturansicht geschlossen wird, wenn auf die Miniaturansichtsschaltfläche geklickt wird, oder legt diesen fest.
	Dispatcher	Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Von DispatcherObject geerbt.)
	ImageSource	Ruft das auf der Miniaturansichtsschaltfläche angezeigte Bild ab oder legt dieses fest.
	IsBackgroundVisible	Ruft einen Wert ab, der angibt, ob ein Rahmen und eine Hervorhebung um die Miniaturansichtsschaltfläche angezeigt werden, oder legt ihn fest.
	IsEnabled	Ruft einen Wert ab, der angibt, ob die Miniaturansichtsschaltfläche aktiviert ist, oder legt ihn fest.
	IsFrozen	Ruft einen Wert ab, der angibt, ob das Objekt gegenwärtig änderbar ist. (Von Freezable geerbt.)
	IsInteractive	Ruft einen Wert ab, der angibt, ob der Benutzer mit der Miniaturansichtsschaltfläche interagieren kann, oder legt diesen Wert fest.
	IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Von DependencyObject geerbt.)
	Visibility	Ruft einen Wert ab, der den Anzeigezustand der Miniaturansichtsschaltfläche angibt, oder legt ihn 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.)
	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.)
	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.)
	Click	Tritt beim Klicken auf die Miniaturansichtsschaltfläche ein.

Zum Seitenanfang

Felder

	Name	Beschreibung
	CommandParameterProperty	Bezeichnet die CommandParameter-Abhängigkeitseigenschaft.
	CommandProperty	Bezeichnet die Command-Abhängigkeitseigenschaft.
	CommandTargetProperty	Bezeichnet die CommandTarget-Abhängigkeitseigenschaft.
	DescriptionProperty	Bezeichnet die Description-Abhängigkeitseigenschaft.
	DismissWhenClickedProperty	Bezeichnet die DismissWhenClicked-Abhängigkeitseigenschaft.
	ImageSourceProperty	Bezeichnet die ImageSource-Abhängigkeitseigenschaft.
	IsBackgroundVisibleProperty	Bezeichnet die IsBackgroundVisible-Abhängigkeitseigenschaft.
	IsEnabledProperty	Bezeichnet die IsEnabled-Abhängigkeitseigenschaft.
	IsInteractiveProperty	Bezeichnet die IsInteractive-Abhängigkeitseigenschaft.
	VisibilityProperty	Bezeichnet die Visibility-Abhängigkeitseigenschaft.

Zum Seitenanfang

Hinweise

Die Windows 7-Taskleiste stellt die verbesserte Funktionalität bereit, mit der Sie die Taskleistenschaltfläche verwenden können, um den Status einem Benutzer mitzuteilen und häufige Aufgaben verfügbar zu machen, wenn das Fenster minimiert oder ausgeblendet 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.

Die ThumbButtonInfo-Klasse enthält Eigenschaften, die beschreiben, wie der Windows 7-Shell die Schaltflächen in der Taskleistenminiaturansicht anzeigt. Es stellt um die systemeigene Windows-API einen verwalteten Wrapper bereit. ThumbButtonInfo-Objekte sind in der TaskbarItemInfo.ThumbButtonInfos-Auflistung enthalten.

Die erweiterten Taskleistenfunktionen sind in Windows-Versionen vor Windows 7 nicht verfügbar. In Windows 7 könnten einige Funktionen je nach den Einstellungen des Benutzers nicht verfügbar sein. Zum Beispiel werden Schaltflächen nur in der Taskleistenminiaturansicht angezeigt, wenn Windows Aero aktiviert wird. Die Anwendung sollte alternative Möglichkeiten bieten, mit dem Benutzer zu interagieren, die nicht abhängig von der verbesserten Taskleistenfunktionalität sind.

Die folgende Abbildung zeigt eine Taskleistenvorschau mit zwei Ziehpunktschaltflächen an, die Zugriff auf die Befehle Wiedergabe und Beenden bieten.

Ziehpunkt-Schaltflächen 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

TaskbarItemInfo