ThumbButtonInfo ThumbButtonInfo ThumbButtonInfo ThumbButtonInfo Class

Définition

Représente des informations concernant le mode d’affichage d’un bouton dans la miniature de la barre des tâches Windows 7. 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
Héritage
Implémente

Exemples

L’exemple suivant montre comment créer un ThumbButtonInfo dans le balisage.The following example shows how to create a ThumbButtonInfo in markup. Le TaskbarItemInfo contient une collection de ThumbButtonInfo objets qui fournissent l’accès aux commandes de lecture et d’arrêt à partir de l’élément de la barre des tâches.The TaskbarItemInfo contains a collection of ThumbButtonInfo objects that provide access to the Play and Stop commands from the taskbar item. Cet exemple fait partie d’un exemple plus complet fourni pour la TaskbarItemInfo classe.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>

Remarques

Le Windows 7Windows 7 barre des tâches fournit des fonctionnalités améliorées qui vous permet d’utiliser le bouton de barre des tâches pour communiquer l’état à un utilisateur et exposer les tâches courantes lorsque la fenêtre est réduite ou masquée.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. Vous pouvez ajouter des boutons à la miniature de barre des tâches pour fournir l’accès aux tâches courantes sans basculer vers la fenêtre d’application.You can add buttons to the taskbar thumbnail to provide access to common tasks without switching to the application window. Par exemple, le lecteur Windows Media fournit les boutons lecture, Pause, suivante et précédente que vous pouvez utiliser pour contrôler la lecture du média à partir de la miniature de barre des tâches lorsque l’application est réduite.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.

Le ThumbButtonInfo classe contient des propriétés qui décrivent comment la Windows 7Windows 7 shell affiche les boutons dans la miniature de barre des tâches.The ThumbButtonInfo class contains properties that describe how the Windows 7Windows 7 shell displays the buttons in the taskbar thumbnail. Il fournit un wrapper managé autour de l’API Windows native.It provides a managed wrapper around the native Windows API. ThumbButtonInfo objets sont contenus dans le TaskbarItemInfo.ThumbButtonInfos collection.ThumbButtonInfo objects are contained in the TaskbarItemInfo.ThumbButtonInfos collection.

La fonctionnalité améliorée de la barre des tâches n’est pas disponible dans les versions de Windows antérieures à Windows 7Windows 7.The enhanced taskbar functionality is not available in versions of Windows earlier than Windows 7Windows 7. Dans Windows 7Windows 7, certaines fonctionnalités ne peuvent pas être disponibles en fonction des paramètres de l’utilisateur.In Windows 7Windows 7, some functionality might not be available depending on the user's settings. Par exemple, les boutons sont affichés uniquement dans la miniature de barre des tâches lorsque Windows AeroWindows Aero est activé.For example, buttons are only shown in the taskbar thumbnail when Windows AeroWindows Aero is enabled. Votre application doit fournir d’autres moyens d’interagir avec l’utilisateur qui ne sont pas dépendants sur les fonctionnalités améliorées de la barre des tâches.Your application should provide alternate ways of interacting with the user that are not dependent on the enhanced taskbar functionality.

L’illustration suivante montre un aperçu de la barre des tâches avec les deux boutons de curseur de défilement qui fournissent l’accès aux commandes de lecture et d’arrêt.The following illustration shows a taskbar preview with two thumb buttons that provide access to the Play and Stop commands.

Exemple d’informations d’élément de la barre des tâchesTaskbar Item Info Sample
Boutons de curseur de barre des tâches de WindowsWindows Taskbar Thumb Buttons

Constructeurs

ThumbButtonInfo() ThumbButtonInfo() ThumbButtonInfo() ThumbButtonInfo()

Initialise une nouvelle instance de la classe ThumbButtonInfo. Initializes a new instance of the ThumbButtonInfo class.

Champs

CommandParameterProperty CommandParameterProperty CommandParameterProperty CommandParameterProperty

Identifie la propriété de dépendance CommandParameter. Identifies the CommandParameter dependency property.

CommandProperty CommandProperty CommandProperty CommandProperty

Identifie la propriété de dépendance Command. Identifies the Command dependency property.

CommandTargetProperty CommandTargetProperty CommandTargetProperty CommandTargetProperty

Identifie la propriété de dépendance CommandTarget. Identifies the CommandTarget dependency property.

DescriptionProperty DescriptionProperty DescriptionProperty DescriptionProperty

Identifie la propriété de dépendance Description. Identifies the Description dependency property.

DismissWhenClickedProperty DismissWhenClickedProperty DismissWhenClickedProperty DismissWhenClickedProperty

Identifie la propriété de dépendance DismissWhenClicked. Identifies the DismissWhenClicked dependency property.

ImageSourceProperty ImageSourceProperty ImageSourceProperty ImageSourceProperty

Identifie la propriété de dépendance ImageSource. Identifies the ImageSource dependency property.

IsBackgroundVisibleProperty IsBackgroundVisibleProperty IsBackgroundVisibleProperty IsBackgroundVisibleProperty

Identifie la propriété de dépendance IsBackgroundVisible. Identifies the IsBackgroundVisible dependency property.

IsEnabledProperty IsEnabledProperty IsEnabledProperty IsEnabledProperty

Identifie la propriété de dépendance IsEnabled. Identifies the IsEnabled dependency property.

IsInteractiveProperty IsInteractiveProperty IsInteractiveProperty IsInteractiveProperty

Identifie la propriété de dépendance IsInteractive. Identifies the IsInteractive dependency property.

VisibilityProperty VisibilityProperty VisibilityProperty VisibilityProperty

Identifie la propriété de dépendance Visibility. Identifies the Visibility dependency property.

Propriétés

CanFreeze CanFreeze CanFreeze CanFreeze

Obtient une valeur qui indique si l’objet peut être rendu non modifiable. Gets a value that indicates whether the object can be made unmodifiable.

(Inherited from Freezable)
Command Command Command Command

Obtient ou définit la commande à appeler en cas de clic sur ce bouton de miniature. Gets or sets the command to invoke when this thumbnail button is clicked.

CommandParameter CommandParameter CommandParameter CommandParameter

Obtient ou définit le paramètre à passer à la propriété Command. Gets or sets the parameter to pass to the Command property.

CommandTarget CommandTarget CommandTarget CommandTarget

Obtient ou définit l’élément auquel appliquer la commande spécifiée. Gets or sets the element on which to raise the specified command.

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Obtient le DependencyObjectType qui encapsule le type CLRCLR de cette instance. Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Description Description Description Description

Obtient ou définit le texte à afficher pour l'info-bulle du bouton de miniature. Gets or sets the text to display for the thumbnail button tooltip.

DismissWhenClicked DismissWhenClicked DismissWhenClicked DismissWhenClicked

Obtient ou définit une valeur qui indique si la miniature de la barre des tâches se ferme en cas de clic sur le bouton de miniature. Gets or sets a value that indicates whether the taskbar thumbnail closes when the thumbnail button is clicked.

Dispatcher Dispatcher Dispatcher Dispatcher

Obtient le Dispatcher associé à DispatcherObject. Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
ImageSource ImageSource ImageSource ImageSource

Obtient ou définit l'image affichée sur le bouton de miniature. Gets or sets the image that is displayed on the thumbnail button.

IsBackgroundVisible IsBackgroundVisible IsBackgroundVisible IsBackgroundVisible

Obtient ou définit une valeur qui indique si une bordure et une mise en surbrillance sont affichées autour du bouton de miniature. Gets or sets a value that indicates whether a border and highlight is displayed around the thumbnail button.

IsEnabled IsEnabled IsEnabled IsEnabled

Obtient ou définit une valeur qui indique si le bouton de miniature est activé. Gets or sets a value that indicates whether the thumbnail button is enabled.

IsFrozen IsFrozen IsFrozen IsFrozen

Obtient une valeur qui indique si l’objet est actuellement modifiable. Gets a value that indicates whether the object is currently modifiable.

(Inherited from Freezable)
IsInteractive IsInteractive IsInteractive IsInteractive

Obtient ou définit une valeur qui indique si l'utilisateur peut interagir avec le bouton de miniature. Gets or sets a value that indicates whether the user can interact with the thumbnail button.

IsSealed IsSealed IsSealed IsSealed

Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
Visibility Visibility Visibility Visibility

Obtient ou définit une valeur qui spécifie l'état d'affichage du bouton de miniature. Gets or sets a value that specifies the display state of the thumbnail button.

Événements

Changed Changed Changed Changed

Se produit lorsque Freezable ou un objet qu'il contient est modifié. Occurs when the Freezable or an object it contains is modified.

(Inherited from Freezable)
Click Click Click Click

Se produit lorsque l'on clique sur le bouton de miniature. Occurs when the thumbnail button is clicked.

Méthodes

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObject. Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété. Clears the local value of a property. La propriété à effacer est spécifiée par un identificateur DependencyProperty. The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Efface la valeur locale d’une propriété en lecture seule. Clears the local value of a read-only property. La propriété à effacer est spécifiée par DependencyPropertyKey. The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
Clone() Clone() Clone() Clone()

Crée un clone modifiable de Freezable, en créant des copies complètes des valeurs de l’objet. Creates a modifiable clone of the Freezable, making deep copies of the object's values. Lors de la copie des propriétés de dépendance de l’objet, cette méthode copie les expressions (qui peuvent ne plus se résoudre), mais pas les animations ni leurs valeurs actuelles. When copying the object's dependency properties, this method copies expressions (which might no longer resolve) but not animations or their current values.

(Inherited from Freezable)
CloneCore(Freezable) CloneCore(Freezable) CloneCore(Freezable) CloneCore(Freezable)

Fait de l’instance un clone (copie complète) du Freezable spécifié utilisant des valeurs de propriété (non animée) de base. Makes the instance a clone (deep copy) of the specified Freezable using base (non-animated) property values.

(Inherited from Freezable)
CloneCurrentValue() CloneCurrentValue() CloneCurrentValue() CloneCurrentValue()

Crée un clone modifiable (copie complète) de Freezable en utilisant ses valeurs actuelles. Creates a modifiable clone (deep copy) of the Freezable using its current values.

(Inherited from Freezable)
CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable)

Fait de l’instance un clone (copie complète) modifiable du Freezable spécifié à l’aide des valeurs de propriété actuelles. Makes the instance a modifiable clone (deep copy) of the specified Freezable using current property values.

(Inherited from Freezable)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

Convertit la valeur de la propriété de dépendance spécifiée. Coerces the value of the specified dependency property. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant. This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
CreateInstance() CreateInstance() CreateInstance() CreateInstance()

Initialise une nouvelle instance de la classe Freezable. Initializes a new instance of the Freezable class.

(Inherited from Freezable)
CreateInstanceCore() CreateInstanceCore() CreateInstanceCore() CreateInstanceCore()

Une fois implémentée dans une classe dérivée, initialise une nouvelle instance de la classe dérivée Freezable. When implemented in a derived class, creates a new instance of the Freezable derived class.

(Inherited from Freezable)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
Freeze() Freeze() Freeze() Freeze()

Rend l'objet actuel non modifiable et définit sa propriété IsFrozen sur true. Makes the current object unmodifiable and sets its IsFrozen property to true.

(Inherited from Freezable)
FreezeCore(Boolean) FreezeCore(Boolean) FreezeCore(Boolean) FreezeCore(Boolean)

Rend l'objet Freezable non modifiable ou vérifie si celui-ci peut être rendu non modifiable ou pas. Makes the Freezable object unmodifiable or tests whether it can be made unmodifiable.

(Inherited from Freezable)
GetAsFrozen() GetAsFrozen() GetAsFrozen() GetAsFrozen()

Crée une copie figée de Freezable, à l'aide des valeurs de propriété (non-animées) de base. Creates a frozen copy of the Freezable, using base (non-animated) property values. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence. Because the copy is frozen, any frozen sub-objects are copied by reference.

(Inherited from Freezable)
GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable)

Convertit l'instance en clone figé du Freezable spécifié à l'aide des valeurs de propriétés (non-animées) de base. Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(Inherited from Freezable)
GetCurrentValueAsFrozen() GetCurrentValueAsFrozen() GetCurrentValueAsFrozen() GetCurrentValueAsFrozen()

Crée une copie figée de Freezable à l'aide des valeurs de propriété actuelles. Creates a frozen copy of the Freezable using current property values. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence. Because the copy is frozen, any frozen sub-objects are copied by reference.

(Inherited from Freezable)
GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable)

Convertit l'instance actuelle en un clone figé du Freezable spécifié. Makes the current instance a frozen clone of the specified Freezable. Si l’objet a des propriétés de dépendance animées, leurs valeurs animées actuelles sont copiées. If the object has animated dependency properties, their current animated values are copied.

(Inherited from Freezable)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Obtient un code de hachage pour ce DependencyObject. Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() 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. Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle. Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

Réévalue la valeur effective pour la propriété de dépendance spécifiée Re-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle du Object actuel. Creates a shallow copy of the current Object.

(Inherited from Object)
OnChanged() OnChanged() OnChanged() OnChanged()

Appelé lorsque l'objet Freezable actuel est modifié. Called when the current Freezable object is modified.

(Inherited from Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject) OnFreezablePropertyChanged(DependencyObject, DependencyObject) OnFreezablePropertyChanged(DependencyObject, DependencyObject) OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Garantit que les pointeurs de contexte appropriés sont établis pour un membre de données de type DependencyObjectType qui vient juste d'être défini. Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Inherited from Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) et n’est pas destiné à être directement utilisé à partir de votre code. This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Inherited from Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Substitue l’implémentation DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) pour appeler également tous les gestionnaires Changed en réponse à une propriété de dépendance variable de type Freezable. Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Inherited from Freezable)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Retourne la valeur locale d’une propriété de dépendance, si elle existe. Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
ReadPreamble() ReadPreamble() ReadPreamble() ReadPreamble()

Garantit que Freezable est accessible à partir d'un thread valide. Ensures that the Freezable is being accessed from a valid thread. Les héritiers de Freezable doivent appeler cette méthode au début de toute APIAPI lisant les membres de données qui ne sont pas des propriétés de dépendance. Inheritors of Freezable must call this method at the beginning of any APIAPI that reads data members that are not dependency properties.

(Inherited from Freezable)
SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

Définit la valeur d’une propriété de dépendance sans modifier sa valeur source. Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) 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. Sets the local value of a dependency property, specified by its dependency property identifier.

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

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) 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. Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel. Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Garantit que le thread appelant a accès à DispatcherObject. Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
WritePostscript() WritePostscript() WritePostscript() WritePostscript()

Déclenche l'événement Changed pour Freezable et appelle sa méthode OnChanged(). Raises the Changed event for the Freezable and invokes its OnChanged() method. Les classes qui dérivent de Freezable doivent appeler cette méthode à la fin de toute API qui modifie des membres de classe qui ne sont pas stockés en tant que propriétés de dépendance. 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.

(Inherited from Freezable)
WritePreamble() WritePreamble() WritePreamble() WritePreamble()

Vérifie que le Freezable n'est pas figé et que son accès s'effectue à partir d'un contexte de thread valide. Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Les héritiers de Freezable doivent appeler cette méthode au début de toute APIAPI écrivant les membres de données qui ne sont pas des propriétés de dépendance. Freezable inheritors should call this method at the beginning of any APIAPI that writes to data members that are not dependency properties.

(Inherited from Freezable)

S’applique à

Voir aussi