ThumbButtonInfo Klasse

Definition

Stellt Informationen zur Anzeige einer Schaltfläche in der Windows 7-Taskleistenminiaturansicht dar.Represents information about how to display a button in the Windows 7 taskbar thumbnail.

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
Implementiert

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein ThumbButtonInfo im Markup erstellt wird.The following example shows how to create a ThumbButtonInfo in markup. Die TaskbarItemInfo enthält eine Auflistung von ThumbButtonInfo -Objekten, die den Zugriff auf die Befehle zum wiedergeben und Abbrechen vom Task leisten Element ermöglichen.The TaskbarItemInfo contains a collection of ThumbButtonInfo objects that provide access to the Play and Stop commands from the taskbar item. Dieses Beispiel ist Teil eines größeren Beispiels, das für die TaskbarItemInfo -Klasse bereitgestellt wird.This example is part of a larger example provided for the TaskbarItemInfo class.

<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 7Windows 7 Taskleiste bietet erweiterte Funktionen, mit denen Sie den Status an einen Benutzer über die Schaltfläche "Taskleiste" übermitteln und allgemeine Aufgaben verfügbar machen können, wenn das Fenster minimiert oder ausgeblendet wird.The Windows 7Windows 7 taskbar provides enhanced functionality that enables you to use the taskbar button to communicate status to a user and expose common tasks when the window is minimized or hidden. Sie können der Task leisten Miniaturansicht Schaltflächen hinzufügen, um den Zugriff auf allgemeine Aufgaben zu ermöglichen, ohne zum Anwendungsfenster zu wechseln.You can add buttons to the taskbar thumbnail to provide access to common tasks without switching to the application window. Beispielsweise stellt Windows Media Player Schaltflächen zum wiedergeben, anhalten, weiterleiten und zurück bereit, mit denen Sie die Medienwiedergabe in der Task leisten Miniaturansicht steuern können, wenn die Anwendung minimiert wird.For example, Windows Media Player provides Play, Pause, Forward, and Back buttons that you can use to control media playback from the taskbar thumbnail when the application is minimized.

Die ThumbButtonInfo -Klasse enthält Eigenschaften, die beschreiben Windows 7Windows 7 , wie die Shell die Schaltflächen in der Task leisten Miniaturansicht anzeigt.The ThumbButtonInfo class contains properties that describe how the Windows 7Windows 7 shell displays the buttons in the taskbar thumbnail. Es bietet einen verwalteten Wrapper für die Native Windows-API.It provides a managed wrapper around the native Windows API. ThumbButtonInfo-Objekte sind in der TaskbarItemInfo.ThumbButtonInfos -Auflistung enthalten.ThumbButtonInfo objects are contained in the TaskbarItemInfo.ThumbButtonInfos collection.

Die erweiterte Taskleiste-Funktionalität ist in Windows Windows 7Windows 7-Versionen vor nicht verfügbar.The enhanced taskbar functionality is not available in versions of Windows earlier than Windows 7Windows 7. In Windows 7Windows 7sind einige Funktionen möglicherweise nicht verfügbar, abhängig von den Einstellungen des Benutzers.In Windows 7Windows 7, some functionality might not be available depending on the user's settings. Beispielsweise werden Schaltflächen nur in der Task leisten Miniaturansicht angezeigt Windows AeroWindows Aero , wenn aktiviert ist.For example, buttons are only shown in the taskbar thumbnail when Windows AeroWindows Aero is enabled. Ihre Anwendung sollte alternative Möglichkeiten zur Interaktion mit dem Benutzer bieten, die nicht von der erweiterten Task leisten Funktionalität abhängig sind.Your application should provide alternate ways of interacting with the user that are not dependent on the enhanced taskbar functionality.

In der folgenden Abbildung wird eine Task leisten Vorschau mit zwei Thumb-Schaltflächen gezeigt, die den Zugriff auf die Befehle zum wiedergeben und Abbrechen ermöglichen.The following illustration shows a taskbar preview with two thumb buttons that provide access to the Play and Stop commands.

![Beispiel für Task leisten Element Info] (~/add/media/wpfshell-taskbariteminfo.png "Beispiel für Task leisten Element Info")Taskbar Item Info Sample
Ziehflächen der Windows-TaskleisteWindows Taskbar Thumb Buttons

Konstruktoren

ThumbButtonInfo()

Initialisiert eine neue Instanz der ThumbButtonInfo-Klasse.Initializes a new instance of the ThumbButtonInfo class.

Felder

CommandParameterProperty

Bezeichnet die CommandParameter-Abhängigkeitseigenschaft.Identifies the CommandParameter dependency property.

CommandProperty

Bezeichnet die Command-Abhängigkeitseigenschaft.Identifies the Command dependency property.

CommandTargetProperty

Bezeichnet die CommandTarget-Abhängigkeitseigenschaft.Identifies the CommandTarget dependency property.

DescriptionProperty

Bezeichnet die Description-Abhängigkeitseigenschaft.Identifies the Description dependency property.

DismissWhenClickedProperty

Bezeichnet die DismissWhenClicked-Abhängigkeitseigenschaft.Identifies the DismissWhenClicked dependency property.

ImageSourceProperty

Bezeichnet die ImageSource-Abhängigkeitseigenschaft.Identifies the ImageSource dependency property.

IsBackgroundVisibleProperty

Bezeichnet die IsBackgroundVisible-Abhängigkeitseigenschaft.Identifies the IsBackgroundVisible dependency property.

IsEnabledProperty

Bezeichnet die IsEnabled-Abhängigkeitseigenschaft.Identifies the IsEnabled dependency property.

IsInteractiveProperty

Bezeichnet die IsInteractive-Abhängigkeitseigenschaft.Identifies the IsInteractive dependency property.

VisibilityProperty

Bezeichnet die Visibility-Abhängigkeitseigenschaft.Identifies the Visibility dependency property.

Eigenschaften

CanFreeze

Ruft einen Wert ab, der anzeigt, ob das Objekt als nicht änderbar festgelegt werden kann.Gets a value that indicates whether the object can be made unmodifiable.

(Geerbt von Freezable)
Command

Ruft den Befehl ab, der beim Klicken auf diese Miniaturansichtsschaltfläche aufgerufen wird, oder legt ihn fest.Gets or sets the command to invoke when this thumbnail button is clicked.

CommandParameter

Ruft den Parameter ab, der an die Command-Eigenschaft übergeben wird, oder legt diesen fest.Gets or sets the parameter to pass to the Command property.

CommandTarget

Ruft das Element ab, für das der angegebene Befehl aufgerufen werden soll, bzw. legt dieses fest.Gets or sets the element on which to raise the specified command.

DependencyObjectType

Ruft den DependencyObjectType ab, der den CLRCLR-Typ dieser Instanz umschließt.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Geerbt von DependencyObject)
Description

Ruft den Text für die Miniaturansichtsschaltflächen-QuickInfo ab oder legt diesen fest.Gets or sets the text to display for the thumbnail button tooltip.

DismissWhenClicked

Ruft einen Wert ab, der angibt, ob die Taskleistenminiaturansicht geschlossen wird, wenn auf die Miniaturansichtsschaltfläche geklickt wird, oder legt diesen fest.Gets or sets a value that indicates whether the taskbar thumbnail closes when the thumbnail button is clicked.

Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Geerbt von DispatcherObject)
ImageSource

Ruft das auf der Miniaturansichtsschaltfläche angezeigte Bild ab oder legt dieses fest.Gets or sets the image that is displayed on the thumbnail button.

IsBackgroundVisible

Ruft einen Wert ab, der angibt, ob ein Rahmen und eine Hervorhebung um die Miniaturansichtsschaltfläche angezeigt werden, oder legt ihn fest.Gets or sets a value that indicates whether a border and highlight is displayed around the thumbnail button.

IsEnabled

Ruft einen Wert ab, der angibt, ob die Miniaturansichtsschaltfläche aktiviert ist, oder legt ihn fest.Gets or sets a value that indicates whether the thumbnail button is enabled.

IsFrozen

Ruft einen Wert ab, der angibt, ob das Objekt derzeit geändert werden kann.Gets a value that indicates whether the object is currently modifiable.

(Geerbt von Freezable)
IsInteractive

Ruft einen Wert ab, der angibt, ob der Benutzer mit der Miniaturansichtsschaltfläche interagieren kann, oder legt diesen Wert fest.Gets or sets a value that indicates whether the user can interact with the thumbnail button.

IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist.Gets a value that indicates whether this instance is currently sealed (read-only).

(Geerbt von DependencyObject)
Visibility

Ruft einen Wert ab, der den Anzeigezustand der Miniaturansichtsschaltfläche angibt, oder legt ihn fest.Gets or sets a value that specifies the display state of the thumbnail button.

Methoden

CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Determines whether the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft.Clears the local value of a property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.The property to be cleared is specified by a DependencyProperty identifier.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft.Clears the local value of a read-only property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.The property to be cleared is specified by a DependencyPropertyKey.

(Geerbt von DependencyObject)
Clone()

Erstellt einen änderbaren Klon des Freezable-Objekts, indem tiefe Kopien der Werte des Objekts erstellt werden.Creates a modifiable clone of the Freezable, making deep copies of the object's values. 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.When copying the object's dependency properties, this method copies expressions (which might no longer resolve) but not animations or their current values.

(Geerbt von Freezable)
CloneCore(Freezable)

Definiert die Instanz als Klon (tiefe Kopie) des angegebenen Freezable-Elements, indem Basiseigenschaftenwerte (nicht animiert) verwendet werden.Makes the instance a clone (deep copy) of the specified Freezable using base (non-animated) property values.

(Geerbt von Freezable)
CloneCurrentValue()

Erstellt einen änderbaren Klon (tiefe Kopie) von Freezable mit den aktuellen Werten.Creates a modifiable clone (deep copy) of the Freezable using its current values.

(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.Makes the instance a modifiable clone (deep copy) of the specified Freezable using current property values.

(Geerbt von Freezable)
CoerceValue(DependencyProperty)

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft.Coerces the value of the specified dependency property. 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.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Geerbt von DependencyObject)
CreateInstance()

Initialisiert eine neue Instanz der Freezable-Klasse.Initializes a new instance of the Freezable class.

(Geerbt von Freezable)
CreateInstanceCore()

Erstellt beim Implementieren in einer abgeleiteten Klasse eine neue Instanz der abgeleiteten Freezable-Klasse.When implemented in a derived class, creates a new instance of the Freezable derived class.

(Geerbt von Freezable)
Equals(Object)

Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Geerbt von DependencyObject)
Freeze()

Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf true fest.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Geerbt von Freezable)
FreezeCore(Boolean)

Legt das Freezable-Objekt als nicht änderbar fest oder überprüft, ob es als nicht änderbar festgelegt werden kann.Makes the Freezable object unmodifiable or tests whether it can be made unmodifiable.

(Geerbt von Freezable)
GetAsFrozen()

Erstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert).Creates a frozen copy of the Freezable, using base (non-animated) property values. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Geerbt von Freezable)
GetAsFrozenCore(Freezable)

Definiert die Instanz als fixierten Klon des angegebenen Freezable-Elements, indem Basiseigenschaftenwerte (nicht animiert) verwendet werden.Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(Geerbt von Freezable)
GetCurrentValueAsFrozen()

Erstellt eine fixierte Kopie von Freezable mit aktuellen Eigenschaftswerten.Creates a frozen copy of the Freezable using current property values. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Geerbt von Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Legt die aktuelle Instanz als fixierten Klon des angegebenen Freezable fest.Makes the current instance a frozen clone of the specified Freezable. Wenn das Objekt über animierte Abhängigkeitseigenschaften verfügt, werden die aktuellen animierten Werte kopiert.If the object has animated dependency properties, their current animated values are copied.

(Geerbt von Freezable)
GetHashCode()

Ruft einen Hashcode für diese DependencyObject ab.Gets a hash code for this DependencyObject.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Geerbt von DependencyObject)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)

Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus.Re-evaluates the effective value for the specified dependency property.

(Geerbt von DependencyObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnChanged()

Wird aufgerufen, wenn das aktuelle Freezable-Objekt geändert wird.Called when the current Freezable object is modified.

(Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Stellt sicher, dass entsprechende Kontextzeiger für einen gerade festgelegten DependencyObjectType-Datenmember eingerichtet werden.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Dieser Member unterstützt die Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(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.Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Geerbt von Freezable)
ReadLocalValue(DependencyProperty)

Gibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück.Returns the local value of a dependency property, if it exists.

(Geerbt von DependencyObject)
ReadPreamble()

Stellt sicher, dass über einen gültigen Thread auf Freezable zugegriffen wird.Ensures that the Freezable is being accessed from a valid thread. Vererber von Freezable müssen diese Methode am Anfang jeder API aufrufen, die Datenmember liest, bei denen es sich nicht um Abhängigkeitseigenschaften handelt.Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(Geerbt von Freezable)
SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern.Sets the value of a dependency property without changing its value source.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird.Sets the local value of a dependency property, specified by its dependency property identifier.

(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.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Geerbt von DependencyObject)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Enforces that the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
WritePostscript()

Löst das Changed-Ereignis für das Freezable-Objekt aus und ruft dessen OnChanged()-Methode auf.Raises the Changed event for the Freezable and invokes its OnChanged() method. Klassen, die aus Freezable abgeleitet werden, sollten diese Methode am Ende jeder API aufrufen, die Klassenmember ändert, die nicht als Abhängigkeitseigenschaften gespeichert sind.Classes that derive from Freezable should call this method at the end of any API that modifies class members that are not stored as dependency properties.

(Geerbt von Freezable)
WritePreamble()

Stellt sicher, dass das Freezable nicht fixiert ist und dass über einen gültigen Threadkontext darauf zugegriffen wird.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Vererber von Freezable sollten diese Methode am Anfang jeder API aufrufen, die Datenmember schreibt, bei denen es sich nicht um Abhängigkeitseigenschaften handelt.Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(Geerbt von Freezable)

Ereignisse

Changed

Tritt auf, wenn Freezable oder ein darin enthaltenes Objekt geändert wird.Occurs when the Freezable or an object it contains is modified.

(Geerbt von Freezable)
Click

Tritt beim Klicken auf die Miniaturansichtsschaltfläche ein.Occurs when the thumbnail button is clicked.

Gilt für:

Siehe auch