ThumbButtonInfo Classe

Definizione

Spazio dei nomi:

System.Windows.Shell

Assembly:

PresentationFramework.dll

Rappresenta informazioni su come visualizzare un pulsante nell'anteprima della barra delle applicazioni di 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

Ereditarietà

Object

DispatcherObject

DependencyObject

Freezable

ThumbButtonInfo

Implementazioni

ICommandSource

Esempio

Nell'esempio seguente viene illustrato come creare un oggetto ThumbButtonInfo nel markup. TaskbarItemInfo Contiene una raccolta di ThumbButtonInfo oggetti che forniscono l'accesso ai comandi Play e Stop dall'elemento della barra delle applicazioni. Questo esempio fa parte di un esempio più ampio fornito per 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>

Commenti

La barra delle applicazioni di Windows 7 offre funzionalità avanzate che consentono di usare il pulsante della barra delle applicazioni per comunicare lo stato a un utente ed esporre attività comuni quando la finestra è ridotta a icona o nascosta. È possibile aggiungere pulsanti all'anteprima della barra delle applicazioni per fornire l'accesso alle attività comuni senza passare alla finestra dell'applicazione. Ad esempio, Windows Media Player fornisce pulsanti Riproduci, Sospendi, Avanti e Indietro che puoi usare per controllare la riproduzione multimediale dall'anteprima della barra delle applicazioni quando l'applicazione è ridotta a icona.

La ThumbButtonInfo classe contiene proprietà che descrivono in che modo la shell di Windows 7 visualizza i pulsanti nell'anteprima della barra delle applicazioni. Fornisce un wrapper gestito per l'API Di Windows nativa. ThumbButtonInfo gli oggetti sono contenuti nell'insieme TaskbarItemInfo.ThumbButtonInfos .

La funzionalità della barra delle applicazioni avanzata non è disponibile nelle versioni di Windows precedenti a Windows 7. In Windows 7 alcune funzionalità potrebbero non essere disponibili a seconda delle impostazioni dell'utente. Ad esempio, i pulsanti vengono visualizzati solo nell'anteprima della barra delle applicazioni quando Windows Aero è abilitato. L'applicazione deve fornire modi alternativi per interagire con l'utente che non dipendono dalla funzionalità avanzata della barra delle applicazioni.

La figura seguente mostra un'anteprima della barra delle applicazioni con due pulsanti thumb che forniscono l'accesso ai comandi Play e Stop.

della Pulsanti thumb della barra delle applicazioni di Windows

Costruttori

Nome	Descrizione
ThumbButtonInfo()	Inizializza una nuova istanza della classe ThumbButtonInfo.

Campi

Nome	Descrizione
CommandParameterProperty	Identifica la CommandParameter proprietà di dipendenza.
CommandProperty	Identifica la Command proprietà di dipendenza.
CommandTargetProperty	Identifica la CommandTarget proprietà di dipendenza.
DescriptionProperty	Identifica la Description proprietà di dipendenza.
DismissWhenClickedProperty	Identifica la DismissWhenClicked proprietà di dipendenza.
ImageSourceProperty	Identifica la ImageSource proprietà di dipendenza.
IsBackgroundVisibleProperty	Identifica la IsBackgroundVisible proprietà di dipendenza.
IsEnabledProperty	Identifica la IsEnabled proprietà di dipendenza.
IsInteractiveProperty	Identifica la IsInteractive proprietà di dipendenza.
VisibilityProperty	Identifica la Visibility proprietà di dipendenza.

Proprietà

Nome	Descrizione
CanFreeze	Ottiene un valore che indica se l'oggetto può essere reso non modificabile. (Ereditato da Freezable)
Command	Ottiene o imposta il comando da richiamare quando si fa clic su questo pulsante di anteprima.
CommandParameter	Ottiene o imposta il parametro da passare alla Command proprietà .
CommandTarget	Ottiene o imposta l'elemento su cui generare il comando specificato.
DependencyObjectType	Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject)
Description	Ottiene o imposta il testo da visualizzare per la descrizione comando del pulsante di anteprima.
DismissWhenClicked	Ottiene o imposta un valore che indica se l'anteprima della barra delle applicazioni si chiude quando si fa clic sul pulsante di anteprima.
Dispatcher	Ottiene l'oggetto DispatcherDispatcherObject a cui è associato. (Ereditato da DispatcherObject)
ImageSource	Ottiene o imposta l'immagine visualizzata sul pulsante di anteprima.
IsBackgroundVisible	Ottiene o imposta un valore che indica se un bordo e un'evidenziazione vengono visualizzati intorno al pulsante di anteprima.
IsEnabled	Ottiene o imposta un valore che indica se il pulsante di anteprima è abilitato.
IsFrozen	Ottiene un valore che indica se l'oggetto è attualmente modificabile. (Ereditato da Freezable)
IsInteractive	Ottiene o imposta un valore che indica se l'utente può interagire con il pulsante di anteprima.
IsSealed	Ottiene un valore che indica se questa istanza è attualmente sealed (sola lettura). (Ereditato da DependencyObject)
Visibility	Ottiene o imposta un valore che specifica lo stato di visualizzazione del pulsante di anteprima.

Metodi

Nome	Descrizione
CheckAccess()	Determina se il thread chiamante ha accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject)
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un DependencyProperty identificatore. (Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)	Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare viene specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject)
Clone()	Crea un clone modificabile dell'oggetto Freezable, eseguendo copie complete dei valori dell'oggetto. Quando si copiano le proprietà di dipendenza dell'oggetto, questo metodo copia le espressioni (che potrebbero non essere più risolte) ma non le animazioni o i relativi valori correnti. (Ereditato da Freezable)
CloneCore(Freezable)	Rende l'istanza un clone (copia completa) dell'oggetto specificato Freezable usando valori di proprietà di base (non animati). (Ereditato da Freezable)
CloneCurrentValue()	Crea un clone modificabile (copia completa) dell'oggetto Freezable utilizzando i relativi valori correnti. (Ereditato da Freezable)
CloneCurrentValueCore(Freezable)	Rende l'istanza un clone modificabile (copia completa) dell'oggetto specificato Freezable utilizzando i valori delle proprietà correnti. (Ereditato da Freezable)
CoerceValue(DependencyProperty)	Forza il valore della proprietà di dipendenza specificata. A tale scopo, richiamare qualsiasi CoerceValueCallback funzione specificata nei metadati della proprietà per la proprietà di dipendenza così come esiste nella chiamata DependencyObjectdi . (Ereditato da DependencyObject)
CreateInstance()	Inizializza una nuova istanza della classe Freezable. (Ereditato da Freezable)
CreateInstanceCore()	Se implementato in una classe derivata, crea una nuova istanza della Freezable classe derivata. (Ereditato da Freezable)
Equals(Object)	Determina se un oggetto specificato DependencyObject è equivalente all'oggetto corrente DependencyObject. (Ereditato da DependencyObject)
Freeze()	Rende l'oggetto corrente non modificabile e imposta la relativa IsFrozen proprietà su true. (Ereditato da Freezable)
FreezeCore(Boolean)	Rende l'oggetto Freezable non modificabile o verifica se può essere reso non modificabile. (Ereditato da Freezable)
GetAsFrozen()	Crea una copia bloccata della proprietà , utilizzando i valori della Freezableproprietà base (non animati). Poiché la copia è bloccata, tutti gli oggetti secondari bloccati vengono copiati in base al riferimento. (Ereditato da Freezable)
GetAsFrozenCore(Freezable)	Rende l'istanza un clone bloccato dell'oggetto specificato Freezable utilizzando valori di proprietà di base (non animati). (Ereditato da Freezable)
GetCurrentValueAsFrozen()	Crea una copia bloccata dell'oggetto utilizzando i valori correnti delle Freezable proprietà. Poiché la copia è bloccata, tutti gli oggetti secondari bloccati vengono copiati in base al riferimento. (Ereditato da Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Rende l'istanza corrente un clone bloccato dell'oggetto specificato Freezable. Se l'oggetto ha proprietà di dipendenza animate, i valori animati correnti vengono copiati. (Ereditato da Freezable)
GetHashCode()	Ottiene un codice hash per l'oggetto DependencyObject. (Ereditato da DependencyObject)
GetLocalValueEnumerator()	Crea un enumeratore specializzato per determinare quali proprietà di dipendenza hanno valori impostati localmente in questo DependencyObjectoggetto . (Ereditato da DependencyObject)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di un oggetto DependencyObject. (Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)	Rivaluta il valore effettivo per la proprietà di dipendenza specificata. (Ereditato da DependencyObject)
OnChanged()	Chiamato quando l'oggetto corrente Freezable viene modificato. (Ereditato da Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Questo membro supporta l'infrastruttura di Windows Presentation Foundation (WPF) e non deve essere usato direttamente dal codice. (Ereditato da Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Assicura che vengano stabiliti puntatori di contesto appropriati per un DependencyObjectType membro dati appena impostato. (Ereditato da Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Esegue l'override dell'implementazione DependencyObject di OnPropertyChanged(DependencyPropertyChangedEventArgs) per richiamare anche i Changed gestori in risposta a una proprietà di dipendenza modificata di tipo Freezable. (Ereditato da Freezable)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject)
ReadPreamble()	Assicura che l'oggetto Freezable sia accessibile da un thread valido. Gli eredi di Freezable devono chiamare questo metodo all'inizio di qualsiasi API che legge i membri dati che non sono proprietà di dipendenza. (Ereditato da Freezable)
SetCurrentValue(DependencyProperty, Object)	Imposta il valore di una proprietà di dipendenza senza modificarne l'origine del valore. (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza, specificato dall'identificatore della proprietà di dipendenza. (Ereditato da DependencyObject)
SetValue(DependencyPropertyKey, Object)	Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza. (Ereditato da DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore per la proprietà di dipendenza specificata. (Ereditato da DependencyObject)
VerifyAccess()	Impone che il thread chiamante abbia accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject)
WritePostscript()	Genera l'evento Changed per Freezable e richiama il relativo OnChanged() metodo. Le classi che derivano da Freezable devono chiamare questo metodo alla fine di qualsiasi API che modifica i membri della classe non archiviati come proprietà di dipendenza. (Ereditato da Freezable)
WritePreamble()	Verifica che l'oggetto Freezable non sia bloccato e che sia accessibile da un contesto di threading valido. Freezable Gli eredi devono chiamare questo metodo all'inizio di qualsiasi API che scrive nei membri dati che non sono proprietà di dipendenza. (Ereditato da Freezable)

Eventi

Nome	Descrizione
Changed	Si verifica quando l'oggetto Freezable o un oggetto che contiene viene modificato. (Ereditato da Freezable)
Click	Si verifica quando si fa clic sul pulsante di anteprima.

Vedi anche

• TaskbarItemInfo