ThumbButtonInfo Klasse

Referenz

Definition

Namespace:: System.Windows.Shell

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public ref class ThumbButtonInfo sealed : System::Windows::Freezable, System::Windows::Input::ICommandSource

public sealed class ThumbButtonInfo : System.Windows.Freezable, System.Windows.Input.ICommandSource

type ThumbButtonInfo = class
    inherit Freezable
    interface ICommandSource

Public NotInheritable Class ThumbButtonInfo
Inherits Freezable
Implements ICommandSource

Vererbung: Object

DispatcherObject

DependencyObject

Freezable
ThumbButtonInfo

Implementiert: ICommandSource

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein ThumbButtonInfo in-Markup erstellt wird. Enthält TaskbarItemInfo eine Auflistung von ThumbButtonInfo Objekten, die den Zugriff auf die Befehle Play und Stop über das Taskleistenelement ermöglichen. Dieses Beispiel ist Teil eines größeren Beispiels, das für die TaskbarItemInfo -Klasse bereitgestellt wird.

<Window.TaskbarItemInfo>
    <TaskbarItemInfo x:Name="taskBarItemInfo1" 
                     Overlay="{StaticResource ResourceKey=StopImage}"
                     ThumbnailClipMargin="80,0,80,140"
                     Description="Taskbar Item Info Sample">
        <TaskbarItemInfo.ThumbButtonInfos>
            <ThumbButtonInfoCollection>
                <ThumbButtonInfo
                    DismissWhenClicked="False"
                    Command="MediaCommands.Play"
                    CommandTarget="{Binding ElementName=btnPlay}"
                    Description="Play"
                    ImageSource="{StaticResource ResourceKey=PlayImage}"/>
                <ThumbButtonInfo
                    DismissWhenClicked="True"
                    Command="MediaCommands.Stop"
                    CommandTarget="{Binding ElementName=btnStop}"
                    Description="Stop"
                    ImageSource="{StaticResource ResourceKey=StopImage}"/>
            </ThumbButtonInfoCollection>
        </TaskbarItemInfo.ThumbButtonInfos>
    </TaskbarItemInfo>
</Window.TaskbarItemInfo>

Hinweise

Die Windows 7-Taskleiste bietet erweiterte Funktionen, mit denen Sie die Taskleistenschaltfläche verwenden können, um einem Benutzer status zu kommunizieren und allgemeine Aufgaben verfügbar zu machen, wenn das Fenster minimiert oder ausgeblendet ist. Sie können der Miniaturansicht der Taskleiste Schaltflächen hinzufügen, um zugriff auf allgemeine Aufgaben zu ermöglichen, ohne zum Anwendungsfenster zu wechseln. Beispielsweise bietet Windows Medienwiedergabe die Schaltflächen "Wiedergabe", "Anhalten", "Vorwärts" und "Zurück", mit denen Sie die Medienwiedergabe über die Miniaturansicht der Taskleiste steuern können, wenn die Anwendung minimiert wird.

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

Die erweiterte Taskleistenfunktion ist in Versionen von Windows vor Windows 7 nicht verfügbar. In Windows 7 sind einige Funktionen abhängig von den Einstellungen des Benutzers möglicherweise nicht verfügbar. Beispielsweise werden Schaltflächen nur in der Miniaturansicht der Taskleiste angezeigt, wenn Windows Aero aktiviert ist. Ihre Anwendung sollte alternative Möglichkeiten für die Interaktion mit dem Benutzer bieten, die nicht von der erweiterten Taskleistenfunktionalität abhängig sind.

Die folgende Abbildung zeigt eine Taskleistenvorschau mit zwei Daumenschaltflächen, die Zugriff auf die Befehle "Wiedergeben" und "Beenden" ermöglichen.

Beispiel für Taskleistenelementinformationen: Beispiel für
Windows-Taskleistenfingerschaltflächen

Konstruktoren

ThumbButtonInfo()

Initialisiert eine neue Instanz der ThumbButtonInfo-Klasse.

Felder

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.

Eigenschaften

CanFreeze	Ruft einen Wert ab, der anzeigt, ob das Objekt als nicht änderbar festgelegt werden kann. (Geerbt von Freezable)
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 aufgerufen werden soll, bzw. legt dieses fest.
DependencyObjectType	Ruft die ab, die DependencyObjectType den CLR-Typ dieser instance umschließt. (Geerbt von DependencyObject)
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. (Geerbt von DispatcherObject)
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 derzeit geändert werden kann. (Geerbt von Freezable)
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. (Geerbt von DependencyObject)
Visibility	Ruft einen Wert ab, der den Anzeigezustand der Miniaturansichtsschaltfläche angibt, oder legt ihn fest.

Methoden

CheckAccess()	Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben. (Geerbt von DependencyObject)
Clone()	Erstellt einen änderbaren Klon des Freezable-Objekts, indem tiefe Kopien der Werte des Objekts erstellt werden. Beim Kopieren der Abhängigkeitseigenschaften des Objekts kopiert diese Methode Ausdrücke (die möglicherweise nicht mehr aufgelöst werden können), jedoch keine Animationen oder ihre aktuellen Werte. (Geerbt von Freezable)
CloneCore(Freezable)	Definiert die Instanz als Klon (tiefe Kopie) des angegebenen Freezable-Elements, indem Basiseigenschaftenwerte (nicht animiert) verwendet werden. (Geerbt von Freezable)
CloneCurrentValue()	Erstellt einen änderbaren Klon (tiefe Kopie) von Freezable mit den aktuellen Werten. (Geerbt von Freezable)
CloneCurrentValueCore(Freezable)	Macht die Instanz mithilfe aktueller Eigenschaftswerte zu einem Klon (tiefe Kopie) des angegebenen Freezable-Elements, der geändert werden kann. (Geerbt von Freezable)
CoerceValue(DependencyProperty)	Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird. (Geerbt von DependencyObject)
CreateInstance()	Initialisiert eine neue Instanz der Freezable-Klasse. (Geerbt von Freezable)
CreateInstanceCore()	Erstellt beim Implementieren in einer abgeleiteten Klasse eine neue Instanz der abgeleiteten Freezable-Klasse. (Geerbt von Freezable)
Equals(Object)	Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Geerbt von DependencyObject)
Freeze()	Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf `true` fest. (Geerbt von Freezable)
FreezeCore(Boolean)	Legt das Freezable-Objekt als nicht änderbar fest oder überprüft, ob es als nicht änderbar festgelegt werden kann. (Geerbt von Freezable)
GetAsFrozen()	Erstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert). Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Geerbt von Freezable)
GetAsFrozenCore(Freezable)	Definiert die Instanz als fixierten Klon des angegebenen Freezable-Elements, indem Basiseigenschaftenwerte (nicht animiert) verwendet werden. (Geerbt von Freezable)
GetCurrentValueAsFrozen()	Erstellt eine fixierte Kopie von Freezable mit aktuellen Eigenschaftswerten. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Geerbt von Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Macht diese aktuelle Instanz zu einem fixierten Klon des angegebenen Freezable-Objekts. Wenn das Objekt über animierte Abhängigkeitseigenschaften verfügt, werden die aktuellen animierten Werte kopiert. (Geerbt von Freezable)
GetHashCode()	Ruft einen Hashcode für diese DependencyObject ab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Geerbt von DependencyObject)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück. (Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnChanged()	Wird aufgerufen, wenn das aktuelle Freezable-Objekt geändert wird. (Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Stellt sicher, dass entsprechende Kontextzeiger für einen gerade festgelegten DependencyObjectType-Datenmember eingerichtet werden. (Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Dieses Member unterstützt die WPF-Infrastruktur (Windows Presentation Foundation) und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Überschreibt die DependencyObject-Implementierung von OnPropertyChanged(DependencyPropertyChangedEventArgs), damit in Reaktion auf eine geänderte Abhängigkeitseigenschaft des Typs Freezable auch Changed-Handler aufgerufen werden. (Geerbt von Freezable)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist. (Geerbt von DependencyObject)
ReadPreamble()	Stellt sicher, dass über einen gültigen Thread auf Freezable zugegriffen wird. Vererber von Freezable müssen diese Methode am Anfang jeder API aufrufen, die Datenmember liest, bei denen es sich nicht um Abhängigkeitseigenschaften handelt. (Geerbt von Freezable)
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist. (Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)	Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist. (Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
VerifyAccess()	Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)
WritePostscript()	Löst das Changed-Ereignis für das Freezable-Objekt aus und ruft dessen OnChanged()-Methode auf. Klassen, die aus Freezable abgeleitet werden, sollten diese Methode am Ende jeder API aufrufen, die Klassenmember ändert, die nicht als Abhängigkeitseigenschaften gespeichert sind. (Geerbt von Freezable)
WritePreamble()	Stellt sicher, dass das Freezable nicht fixiert ist und dass über einen gültigen Threadkontext darauf zugegriffen wird. Vererber von Freezable sollten diese Methode am Anfang jeder API aufrufen, die Datenmember schreibt, bei denen es sich nicht um Abhängigkeitseigenschaften handelt. (Geerbt von Freezable)

Ereignisse

Changed	Tritt auf, wenn Freezable oder ein darin enthaltenes Objekt geändert wird. (Geerbt von Freezable)
Click	Tritt beim Klicken auf die Miniaturansichtsschaltfläche ein.

Gilt für:

Weitere Informationen

TaskbarItemInfo