ThumbButtonInfo Classe

Définition

Espace de noms:

System.Windows.Shell

Assembly:

PresentationFramework.dll

Représente des informations sur l’affichage d’un bouton dans la miniature de la barre des tâches Windows 7.

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

Héritage

Object

DispatcherObject

DependencyObject

Freezable

ThumbButtonInfo

Implémente

ICommandSource

Exemples

L’exemple suivant montre comment créer un ThumbButtonInfo balisage dans le balisage. Contient TaskbarItemInfo une collection d’objets ThumbButtonInfo qui fournissent l’accès aux commandes Play et Stop à partir de l’élément de barre des tâches. Cet exemple fait partie d’un exemple plus large fourni pour la TaskbarItemInfo classe.

<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>

Remarques

La barre des tâches Windows 7 fournit des fonctionnalités améliorées qui vous permettent d’utiliser le bouton de la barre des tâches pour communiquer l’état à un utilisateur et d’exposer les tâches courantes lorsque la fenêtre est réduite ou masquée. Vous pouvez ajouter des boutons à la miniature de la barre des tâches pour fournir l’accès aux tâches courantes sans passer à la fenêtre d’application. Par exemple, le lecteur Windows Media fournit des boutons Lecture, Pause, Transfert et Précédent que vous pouvez utiliser pour contrôler la lecture multimédia à partir de la miniature de la barre des tâches lorsque l’application est réduite.

La ThumbButtonInfo classe contient des propriétés qui décrivent comment l’interpréteur de commandes Windows 7 affiche les boutons dans la miniature de la barre des tâches. Il fournit un wrapper managé autour de l’API Windows native. ThumbButtonInfo les objets sont contenus dans la TaskbarItemInfo.ThumbButtonInfos collection.

La fonctionnalité de barre des tâches améliorée n’est pas disponible dans les versions de Windows antérieures à Windows 7. Dans Windows 7, certaines fonctionnalités peuvent ne pas être disponibles en fonction des paramètres de l’utilisateur. Par exemple, les boutons sont affichés uniquement dans la miniature de la barre des tâches lorsque Windows Aero est activé. Votre application doit fournir d’autres façons d’interagir avec l’utilisateur qui ne dépendent pas de la fonctionnalité de barre des tâches améliorée.

L’illustration suivante montre un aperçu de la barre des tâches avec deux boutons pouce qui fournissent l’accès aux commandes Lecture et Arrêt.

Boutons de la barre des tâches Windows

Constructeurs

Nom	Description
ThumbButtonInfo()	Initialise une nouvelle instance de la classe ThumbButtonInfo.

Champs

Nom	Description
CommandParameterProperty	Identifie la CommandParameter propriété de dépendance.
CommandProperty	Identifie la Command propriété de dépendance.
CommandTargetProperty	Identifie la CommandTarget propriété de dépendance.
DescriptionProperty	Identifie la Description propriété de dépendance.
DismissWhenClickedProperty	Identifie la DismissWhenClicked propriété de dépendance.
ImageSourceProperty	Identifie la ImageSource propriété de dépendance.
IsBackgroundVisibleProperty	Identifie la IsBackgroundVisible propriété de dépendance.
IsEnabledProperty	Identifie la IsEnabled propriété de dépendance.
IsInteractiveProperty	Identifie la IsInteractive propriété de dépendance.
VisibilityProperty	Identifie la Visibility propriété de dépendance.

Propriétés

Nom	Description
CanFreeze	Obtient une valeur qui indique si l’objet peut être rendu non modifiable. (Hérité de Freezable)
Command	Obtient ou définit la commande à appeler lorsque ce bouton miniature est cliqué.
CommandParameter	Obtient ou définit le paramètre à passer à la propriété Command.
CommandTarget	Obtient ou définit l’élément sur lequel déclencher la commande spécifiée.
DependencyObjectType	Obtient le DependencyObjectType type CLR de cette instance. (Hérité de DependencyObject)
Description	Obtient ou définit le texte à afficher pour l’info-bulle du bouton miniature.
DismissWhenClicked	Obtient ou définit une valeur qui indique si la miniature de la barre des tâches se ferme lorsque le bouton miniature est cliqué.
Dispatcher	Obtient ce Dispatcher qui DispatcherObject est associé. (Hérité de DispatcherObject)
ImageSource	Obtient ou définit l’image affichée sur le bouton miniature.
IsBackgroundVisible	Obtient ou définit une valeur qui indique si une bordure et une mise en surbrillance sont affichées autour du bouton miniature.
IsEnabled	Obtient ou définit une valeur qui indique si le bouton miniature est activé.
IsFrozen	Obtient une valeur qui indique si l’objet est actuellement modifiable. (Hérité de Freezable)
IsInteractive	Obtient ou définit une valeur qui indique si l’utilisateur peut interagir avec le bouton miniature.
IsSealed	Obtient une valeur qui indique si cette instance est actuellement scellée (en lecture seule). (Hérité de DependencyObject)
Visibility	Obtient ou définit une valeur qui spécifie l’état d’affichage du bouton miniature.

Méthodes

Nom	Description
CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un DependencyProperty identificateur. (Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)	Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par un DependencyPropertyKey. (Hérité de DependencyObject)
Clone()	Crée un clone modifiable de l’objet Freezable, effectuant des copies approfondies des valeurs de l’objet. Lors de la copie des propriétés de dépendance de l’objet, cette méthode copie les expressions (qui peuvent ne plus être résolues), mais pas les animations ou leurs valeurs actuelles. (Hérité de Freezable)
CloneCore(Freezable)	Rend l’instance un clone (copie approfondie) de la propriété de base (non animée) spécifiée Freezable . (Hérité de Freezable)
CloneCurrentValue()	Crée un clone modifiable (copie approfondie) de l’utilisation Freezable de ses valeurs actuelles. (Hérité de Freezable)
CloneCurrentValueCore(Freezable)	Rend l’instance un clone modifiable (copie approfondie) de l’élément spécifié Freezable à l’aide de valeurs de propriété actuelles. (Hérité de Freezable)
CoerceValue(DependencyProperty)	Force la valeur de la propriété de dépendance spécifiée. Pour ce faire, appelez n’importe quelle CoerceValueCallback fonction spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur l’appel DependencyObject. (Hérité de DependencyObject)
CreateInstance()	Initialise une nouvelle instance de la classe Freezable. (Hérité de Freezable)
CreateInstanceCore()	En cas d’implémentation dans une classe dérivée, crée une nouvelle instance de la Freezable classe dérivée. (Hérité de Freezable)
Equals(Object)	Détermine si un élément fourni DependencyObject est équivalent à l’actuel DependencyObject. (Hérité de DependencyObject)
Freeze()	Rend l’objet actuel non modifiable et définit sa IsFrozen propriété sur true. (Hérité de Freezable)
FreezeCore(Boolean)	Rend l’objet Freezable non modifiable ou teste s’il peut être rendu inmodifiable. (Hérité de Freezable)
GetAsFrozen()	Crée une copie figée des valeurs de Freezablepropriété de base (non animées). Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence. (Hérité de Freezable)
GetAsFrozenCore(Freezable)	Rend l’instance un clone figé de la propriété spécifiée à Freezable l’aide de valeurs de propriété de base (non animées). (Hérité de Freezable)
GetCurrentValueAsFrozen()	Crée une copie figée de l’utilisation Freezable des valeurs de propriété actuelles. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence. (Hérité de Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Rend l’instance actuelle un clone figé du fichier spécifié Freezable. Si l’objet a des propriétés de dépendance animée, leurs valeurs animées actuelles sont copiées. (Hérité de Freezable)
GetHashCode()	Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject)
GetLocalValueEnumerator()	Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject. (Hérité de DependencyObject)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. (Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)	Évalue à nouveau la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
OnChanged()	Appelé lorsque l’objet actuel Freezable est modifié. (Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Ce membre prend en charge l’infrastructure WPF (Windows Presentation Foundation) et n’est pas destiné à être utilisé directement à partir de votre code. (Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Garantit que les pointeurs de contexte appropriés sont établis pour un DependencyObjectType membre de données qui vient d’être défini. (Hérité de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Remplace l’implémentation DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) l’appel de tous Changed les gestionnaires en réponse à une propriété de dépendance modifiée de type Freezable. (Hérité de Freezable)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, le cas échéant. (Hérité de DependencyObject)
ReadPreamble()	Garantit l’accès Freezable à partir d’un thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API qui lit les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable)
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa source de valeur. (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance. (Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie. (Hérité de DependencyObject)
VerifyAccess()	Applique que le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)
WritePostscript()	Déclenche l’événement Changed pour la Freezable méthode et appelle sa OnChanged() méthode. Les classes dérivées Freezable de doivent appeler cette méthode à la fin de toute API qui modifie les membres de classe qui ne sont pas stockés en tant que propriétés de dépendance. (Hérité de Freezable)
WritePreamble()	Vérifie que l’objet Freezable n’est pas figé et qu’il est accessible à partir d’un contexte de threading valide. Freezable Les hériteurs doivent appeler cette méthode au début de toute API qui écrit dans les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable)

Événements

Nom	Description
Changed	Se produit lorsque l’objet Freezable qu’il contient est modifié. (Hérité de Freezable)
Click	Se produit lorsque le bouton miniature est cliqué.

Voir aussi

• TaskbarItemInfo