ThumbButtonInfo Klasse
Definition
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 zum Anzeigen einer Schaltfläche in der Miniaturansicht der Windows 7-Taskleiste dar.
public ref class ThumbButtonInfo sealed : System::Windows::Freezable, System::Windows::Input::ICommandSourcepublic sealed class ThumbButtonInfo : System.Windows.Freezable, System.Windows.Input.ICommandSourcetype ThumbButtonInfo = class
inherit Freezable
interface ICommandSourcePublic NotInheritable Class ThumbButtonInfo
Inherits Freezable
Implements ICommandSource- Vererbung
- Implementiert
Beispiele
Das folgende Beispiel zeigt, wie Sie ein ThumbButtonInfo Markup erstellen. Die TaskbarItemInfo Enthält eine Auflistung von ThumbButtonInfo Objekten, die Zugriff auf die Befehle "Wiedergeben" und "Beenden" des Taskleistenelements 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 einen Benutzer mit dem Status zu kommunizieren und allgemeine Aufgaben verfügbar zu machen, wenn das Fenster minimiert oder ausgeblendet wird. Sie können der Miniaturansicht der Taskleiste Schaltflächen hinzufügen, um Zugriff auf allgemeine Aufgaben zu ermöglichen, ohne zum Anwendungsfenster zu wechseln. Windows Media Player bietet z. B. Die Schaltflächen "Wiedergeben", "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. Sie stellt einen verwalteten Wrapper für die systemeigene 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 je nach den Einstellungen des Benutzers möglicherweise nicht verfügbar. Schaltflächen werden beispielsweise 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 bereitstellen, die nicht von der erweiterten Taskleistenfunktionalität abhängig sind.
Die folgende Abbildung zeigt eine Taskleistenvorschau mit zwei Minischaltflächen, die Zugriff auf die Befehle "Wiedergeben" und "Beenden" ermöglichen.
zu Windows Taskleisten-Minischaltflächen
Konstruktoren
| Name | Beschreibung |
|---|---|
| ThumbButtonInfo() |
Initialisiert eine neue Instanz der ThumbButtonInfo-Klasse. |
Felder
| Name | Beschreibung |
|---|---|
| CommandParameterProperty |
Identifies the CommandParameter dependency property. |
| CommandProperty |
Identifies the Command dependency property. |
| CommandTargetProperty |
Identifies the CommandTarget dependency property. |
| DescriptionProperty |
Identifies the Description dependency property. |
| DismissWhenClickedProperty |
Identifies the DismissWhenClicked dependency property. |
| ImageSourceProperty |
Identifies the ImageSource dependency property. |
| IsBackgroundVisibleProperty |
Identifies the IsBackgroundVisible dependency property. |
| IsEnabledProperty |
Identifies the IsEnabled dependency property. |
| IsInteractiveProperty |
Identifies the IsInteractive dependency property. |
| VisibilityProperty |
Identifies the Visibility dependency property. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| CanFreeze |
Ruft einen Wert ab, der angibt, ob das Objekt unveränderlich gemacht werden kann. (Geerbt von Freezable) |
| Command |
Ruft den Befehl ab, der aufgerufen werden soll, wenn auf diese Miniaturansichtsschaltfläche geklickt wird, oder legt diesen fest. |
| CommandParameter |
Dient zum Abrufen oder Festlegen des Parameters, der an die Command-Eigenschaft übergeben werden soll. |
| CommandTarget |
Ruft ab oder legt das Element fest, für das der angegebene Befehl auslösen soll. |
| DependencyObjectType |
Ruft den DependencyObjectType CLR-Typ dieser Instanz ab. (Geerbt von DependencyObject) |
| Description |
Ruft den Text ab, der für die QuickInfo für die Miniaturansicht-Schaltfläche angezeigt werden soll, oder legt diesen fest. |
| DismissWhenClicked |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Miniaturansicht der Taskleiste geschlossen wird, wenn auf die Schaltfläche "Miniaturansicht" geklickt wird. |
| Dispatcher |
Ruft dies Dispatcher ab, dem dies DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject) |
| ImageSource |
Ruft das Bild ab, das auf der Miniaturansichtsschaltfläche angezeigt wird, oder legt es fest. |
| IsBackgroundVisible |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Rahmen und eine Hervorhebung um die Miniaturansichtsschaltfläche angezeigt wird. |
| IsEnabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Miniaturansicht-Schaltfläche aktiviert ist. |
| IsFrozen |
Ruft einen Wert ab, der angibt, ob das Objekt derzeit geändert werden kann. (Geerbt von Freezable) |
| IsInteractive |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Benutzer mit der Miniaturansicht-Schaltfläche interagieren kann. |
| IsSealed |
Ruft einen Wert ab, der angibt, ob diese Instanz aktuell versiegelt ist (schreibgeschützt). (Geerbt von DependencyObject) |
| Visibility |
Dient zum Abrufen oder Festlegen eines Werts, der den Anzeigezustand der Miniaturansicht-Schaltfläche angibt. |
Methoden
| Name | Beschreibung |
|---|---|
| CheckAccess() |
Bestimmt, ob der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject) |
| ClearValue(DependencyProperty) |
Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird durch einen DependencyProperty Bezeichner angegeben. (Geerbt von DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird durch eine DependencyPropertyKey. (Geerbt von DependencyObject) |
| Clone() |
Erstellt einen modifizierbaren Klon des FreezableObjekts, wobei 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) |
Macht die Instanz zu einem Klon (deep copy) der angegebenen Freezable Basiseigenschaftswerte (nicht animiert). (Geerbt von Freezable) |
| CloneCurrentValue() |
Erstellt einen modifizierbaren Klon (deep copy) der Freezable aktuellen Werte. (Geerbt von Freezable) |
| CloneCurrentValueCore(Freezable) |
Macht die Instanz zu einem modifizierbaren Klon (deep copy) des angegebenen Freezable Werts mit aktuellen Eigenschaftswerten. (Geerbt von Freezable) |
| CoerceValue(DependencyProperty) |
Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Dies wird erreicht, indem alle CoerceValueCallback in Eigenschaftsmetadaten für die Abhängigkeitseigenschaft angegebenen Funktionen aufgerufen werden, wie sie für den Aufruf DependencyObjectvorhanden sind. (Geerbt von DependencyObject) |
| CreateInstance() |
Initialisiert eine neue Instanz der Freezable-Klasse. (Geerbt von Freezable) |
| CreateInstanceCore() |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird eine neue Instanz der Freezable abgeleiteten Klasse erstellt. (Geerbt von Freezable) |
| Equals(Object) |
Bestimmt, ob ein bereitgestelltes DependencyObject Element dem aktuellen DependencyObjectentspricht. (Geerbt von DependencyObject) |
| Freeze() |
Macht das aktuelle Objekt unveränderlich und legt seine IsFrozen Eigenschaft auf |
| FreezeCore(Boolean) |
Macht das Freezable Objekt unveränderlich oder prüft, ob es unveränderlich gemacht werden kann. (Geerbt von Freezable) |
| GetAsFrozen() |
Erstellt eine fixierte Kopie der Freezablebasisbasierten (nicht animierten) Eigenschaftswerte. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte per Verweis kopiert. (Geerbt von Freezable) |
| GetAsFrozenCore(Freezable) |
Macht die Instanz zu einem fixierten Klon der angegebenen Freezable Basiseigenschaft (nicht animierte) Eigenschaftswerte. (Geerbt von Freezable) |
| GetCurrentValueAsFrozen() |
Erstellt eine fixierte Kopie der Freezable aktuellen Eigenschaftswerte. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte per Verweis kopiert. (Geerbt von Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Macht die aktuelle Instanz zu einem fixierten Klon des angegebenen Freezable. Wenn das Objekt animierte Abhängigkeitseigenschaften aufweist, werden die aktuellen animierten Werte kopiert. (Geerbt von Freezable) |
| GetHashCode() |
Ruft einen Hashcode für diese DependencyObjectab. (Geerbt von DependencyObject) |
| GetLocalValueEnumerator() |
Erstellt einen speziellen Enumerator, um zu bestimmen, welche Abhängigkeitseigenschaften lokal festgelegte Werte für diese DependencyObjectEigenschaft haben. (Geerbt von DependencyObject) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetValue(DependencyProperty) |
Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz einer .DependencyObject (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 der aktuellen Object. (Geerbt von Object) |
| OnChanged() |
Wird aufgerufen, wenn das aktuelle Freezable Objekt geändert wird. (Geerbt von Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Dieses Mitglied unterstützt die Windows Presentation Foundation (WPF)-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Stellt sicher, dass geeignete Kontextzeiger für ein DependencyObjectType soeben festgelegtes Datenelement eingerichtet werden. (Geerbt von Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Setzt die DependencyObject Implementierung OnPropertyChanged(DependencyPropertyChangedEventArgs) außer Kraft, um auch alle Changed Handler als Reaktion auf eine sich ändernde Abhängigkeitseigenschaft vom Typ Freezableaufzurufen. (Geerbt von Freezable) |
| ReadLocalValue(DependencyProperty) |
Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, sofern vorhanden. (Geerbt von DependencyObject) |
| ReadPreamble() |
Stellt sicher, dass der Freezable Zugriff über einen gültigen Thread erfolgt. Erber von Freezable müssen diese Methode am Anfang einer API aufrufen, die Datenmmber liest, die keine Abhängigkeitseigenschaften sind. (Geerbt von Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Geerbt von DependencyObject) |
| SetValue(DependencyProperty, Object) |
Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird. (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 wird. (Geerbt von DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert für die bereitgestellte 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 Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject) |
| WritePostscript() |
Löst das Changed Ereignis für die Freezable Methode aus und ruft es OnChanged() auf. Klassen, die von Freezable dieser Methode abgeleitet werden, sollten am Ende einer API aufgerufen werden, die Klassenmmber ändert, die nicht als Abhängigkeitseigenschaften gespeichert sind. (Geerbt von Freezable) |
| WritePreamble() |
Überprüft, ob der Freezable Zugriff nicht fixiert ist und über einen gültigen Threadingkontext darauf zugegriffen wird. Freezable Vererbungen sollten diese Methode am Anfang einer API aufrufen, die in Datenmmber schreibt, die keine Abhängigkeitseigenschaften sind. (Geerbt von Freezable) |
Ereignisse
| Name | Beschreibung |
|---|---|
| Changed |
Tritt auf, wenn das Freezable darin enthaltene Objekt geändert wird. (Geerbt von Freezable) |
| Click |
Tritt auf, wenn auf die Miniaturansichtsschaltfläche geklickt wird. |
