ThumbButtonInfo Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Shell

Assembly:: PresentationFramework.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta le informazioni sul modo in cui 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 ThumbButtonInfo oggetto in markup. Contiene TaskbarItemInfo 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ù grande 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 viene 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, Lettore multimediale Windows fornisce pulsanti Play, Pause, Forward e Back che è possibile usare per controllare la riproduzione multimediale dall'anteprima della barra delle applicazioni quando l'applicazione viene ridotta al minimo.

La ThumbButtonInfo classe contiene proprietà che descrivono come la shell di Windows 7 visualizza i pulsanti nell'anteprima della barra delle applicazioni. Fornisce un wrapper gestito intorno all'API 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 dipende dalla funzionalità della barra delle applicazioni avanzata.

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

Esempio di informazioni sull'elemento della barra delle applicazioni dell'elemento della barra delle
Pulsanti di pollice della barra delle applicazioni di Windows

Costruttori

ThumbButtonInfo()

Inizializza una nuova istanza della classe ThumbButtonInfo.

Campi

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

Proprietà

CanFreeze	Ottiene un valore che indica se l'oggetto può essere impostato come non modificabile. (Ereditato da Freezable)
Command	Ottiene o imposta il comando da richiamare quando si fa clic su questo pulsante dell'anteprima.
CommandParameter	Ottiene o imposta il parametro da passare alla proprietà Command.
CommandTarget	Recupera o imposta l'elemento su cui eseguire 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 comandi del pulsante dell'anteprima.
DismissWhenClicked	Ottiene o imposta un valore che indica se l'anteprima della barra delle applicazioni si chiude quando si fa clic sul pulsante dell'anteprima.
Dispatcher	Ottiene l'oggetto Dispatcher associato a DispatcherObject. (Ereditato da DispatcherObject)
ImageSource	Ottiene o imposta l'immagine visualizzata sul pulsante dell'anteprima.
IsBackgroundVisible	Ottiene o imposta un valore che indica se viene visualizzato un bordo e un'evidenziazione intorno al pulsante dell'anteprima.
IsEnabled	Ottiene o imposta un valore che indica se il pulsante dell'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 dell'anteprima.
IsSealed	Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura). (Ereditato da DependencyObject)
Visibility	Ottiene o imposta un valore che specifica lo stato di visualizzazione del pulsante dell'anteprima.

Metodi

CheckAccess()	Determina se il thread chiamante ha accesso a DispatcherObject. (Ereditato da DispatcherObject)
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà. La proprietà da cancellare è specificata da un identificatore DependencyProperty. (Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)	Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject)
Clone()	Crea un clone modificabile dell'oggetto Freezable, eseguendo copie complete dei valori dell'oggetto. Durante la copia delle proprietà di dipendenza di questo oggetto, questo metodo copia le espressioni (che potrebbero non essere più risolte), ma non le animazioni né i relativi valori correnti. (Ereditato da Freezable)
CloneCore(Freezable)	Rende l'istanza un clone (copia completa) dell'oggetto Freezable specificato usando i valori di proprietà di base (non animati). (Ereditato da Freezable)
CloneCurrentValue()	Crea un clone modificabile (copia completa) di Freezable utilizzando i valori correnti. (Ereditato da Freezable)
CloneCurrentValueCore(Freezable)	Rende l'istanza un clone (copia completa) modificabile dell'oggetto Freezable specificato usando i valori di proprietà correnti. (Ereditato da Freezable)
CoerceValue(DependencyProperty)	Assegna forzatamente il valore della proprietà di dipendenza specificata. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante. (Ereditato da DependencyObject)
CreateInstance()	Inizializza una nuova istanza della classe Freezable. (Ereditato da Freezable)
CreateInstanceCore()	Quando è implementato in una classe derivata, crea una nuova istanza della classe derivata Freezable. (Ereditato da Freezable)
Equals(Object)	Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente. (Ereditato da DependencyObject)
Freeze()	Rende non modificabile l'oggetto corrente e ne imposta la proprietà IsFrozen su `true`. (Ereditato da Freezable)
FreezeCore(Boolean)	Rende immodificabile l'oggetto Freezable o verifica se può essere reso immodificabile. (Ereditato da Freezable)
GetAsFrozen()	Crea una copia bloccata di Freezable, utilizzando valori delle proprietà di base (non-animati). Dato che la copia è bloccata, gli oggetti secondari bloccati sono copiati dal riferimento. (Ereditato da Freezable)
GetAsFrozenCore(Freezable)	Rende l'istanza un clone bloccato dell'oggetto Freezable specificato usando i valori di proprietà di base (non animati). (Ereditato da Freezable)
GetCurrentValueAsFrozen()	Crea una copia bloccata di Freezable utilizzando valori della proprietà correnti. Dato che la copia è bloccata, gli oggetti secondari bloccati sono copiati dal riferimento. (Ereditato da Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Rende l'istanza corrente un clone bloccato dell'oggetto Freezable specificato. 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 le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject. (Ereditato da DependencyObject)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject. (Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)	Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnChanged()	Chiamato quando viene modificato l'oggetto Freezable corrente. (Ereditato da Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Assicura che adatti puntatori del contesto siano stabiliti per un membro dati DependencyObjectType che è appena stato impostato. (Ereditato da Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Questo membro supporta l'infrastruttura Windows Presentation Foundation (WPF) e non deve essere usata direttamente dal codice. (Ereditato da Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Esegue l'override dell'implementazione di DependencyObject di OnPropertyChanged(DependencyPropertyChangedEventArgs) per richiamare anche eventuali gestori Changed in risposta alla modifica di una proprietà di dipendenza 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’accesso di Freezable sia stato eseguito da un thread valido. Gli eredi di Freezable devono chiamare questo metodo all'inizio di qualsiasi API che legge i membri dei dati che non sono proprietà della dipendenza. (Ereditato da Freezable)
SetCurrentValue(DependencyProperty, Object)	Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore. (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo 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 della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
VerifyAccess()	Impone che il thread chiamante abbia accesso a DispatcherObject. (Ereditato da DispatcherObject)
WritePostscript()	Genera l'evento Changed per Freezable e richiama il metodo OnChanged(). Le classi che derivano da Freezable devono chiamare questo metodo alla fine di qualsiasi API che modifica i membri di classe che non sono archiviati come proprietà di dipendenza. (Ereditato da Freezable)
WritePreamble()	Verifica che l'oggetto Freezable non sia bloccato e che l'accesso sia eseguito da un contesto di threading valido. Gli eredi di Freezable devono chiamare questo metodo all'inizio di qualsiasi API che scrive sui membri dei dati che non sono proprietà della dipendenza. (Ereditato da Freezable)

Eventi

Changed	Si verifica quando Freezable o un oggetto che contiene è modificato. (Ereditato da Freezable)
Click	Si verifica quando si fa clic sul pulsante dell'anteprima.

Si applica a

Vedi anche

TaskbarItemInfo