ThumbButtonInfo Klasa

Definicja

Przestrzeń nazw:

System.Windows.Shell

Zestaw:

PresentationFramework.dll

Przedstawia informacje o sposobie wyświetlania przycisku na miniaturze paska zadań systemu 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

Dziedziczenie

Object

DispatcherObject

DependencyObject

Freezable

ThumbButtonInfo

Implementuje

ICommandSource

Przykłady

W poniższym przykładzie pokazano, jak utworzyć znacznik ThumbButtonInfo w znacznikach. Zawiera TaskbarItemInfo kolekcję ThumbButtonInfo obiektów, które zapewniają dostęp do poleceń odtwarzania i zatrzymywania z elementu paska zadań. Ten przykład jest częścią większego przykładu udostępnionego TaskbarItemInfo dla klasy .

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

Uwagi

Pasek zadań systemu Windows 7 udostępnia rozszerzone funkcje, które umożliwiają używanie przycisku paska zadań w celu komunikowania stanu użytkownikowi i uwidaczniania typowych zadań w przypadku zminimalizowania lub ukrycia okna. Możesz dodać przyciski do miniatury paska zadań, aby zapewnić dostęp do typowych zadań bez przełączania się do okna aplikacji. Na przykład Odtwarzacz multimedialny Windows udostępnia przyciski Odtwarzania, Wstrzymywania, Przekazywania i Wstecz, których można użyć do kontrolowania odtwarzania multimediów z miniatury paska zadań, gdy aplikacja jest zminimalizowana.

Klasa ThumbButtonInfo zawiera właściwości opisujące sposób wyświetlania przycisków w powłoce systemu Windows 7 na miniaturze paska zadań. Zapewnia zarządzaną otokę wokół natywnego interfejsu API systemu Windows. ThumbButtonInfo obiekty znajdują się w kolekcji TaskbarItemInfo.ThumbButtonInfos .

Rozszerzone funkcje paska zadań nie są dostępne w wersjach systemu Windows starszych niż Windows 7. W systemie Windows 7 niektóre funkcje mogą nie być dostępne w zależności od ustawień użytkownika. Na przykład przyciski są wyświetlane tylko na miniaturze paska zadań po włączeniu narzędzia Windows Aero. Aplikacja powinna udostępniać alternatywne sposoby interakcji z użytkownikiem, który nie jest zależny od rozszerzonych funkcji paska zadań.

Poniższa ilustracja przedstawia podgląd paska zadań z dwoma przyciskami kciuka, które zapewniają dostęp do poleceń Odtwarzania i zatrzymywania.

Przykład
Przyciski kciuka paska zadań systemu Windows

Konstruktory

ThumbButtonInfo()

Inicjuje nowe wystąpienie klasy ThumbButtonInfo.

Pola

CommandParameterProperty	CommandParameter Identyfikuje właściwość zależności.
CommandProperty	Command Identyfikuje właściwość zależności.
CommandTargetProperty	CommandTarget Identyfikuje właściwość zależności.
DescriptionProperty	Description Identyfikuje właściwość zależności.
DismissWhenClickedProperty	DismissWhenClicked Identyfikuje właściwość zależności.
ImageSourceProperty	ImageSource Identyfikuje właściwość zależności.
IsBackgroundVisibleProperty	IsBackgroundVisible Identyfikuje właściwość zależności.
IsEnabledProperty	IsEnabled Identyfikuje właściwość zależności.
IsInteractiveProperty	IsInteractive Identyfikuje właściwość zależności.
VisibilityProperty	Visibility Identyfikuje właściwość zależności.

Właściwości

CanFreeze	Pobiera wartość wskazującą, czy obiekt może być niemodyfikowalny. (Odziedziczone po Freezable)
Command	Pobiera lub ustawia polecenie do wywołania po kliknięciu tego przycisku miniatury.
CommandParameter	Pobiera lub ustawia parametr do przekazania do Command właściwości .
CommandTarget	Pobiera lub ustawia element, na którym ma być wywoływane określone polecenie.
DependencyObjectType	Pobiera klasę DependencyObjectType , która opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject)
Description	Pobiera lub ustawia tekst do wyświetlenia dla etykietki narzędzia przycisku miniatury.
DismissWhenClicked	Pobiera lub ustawia wartość wskazującą, czy miniatura paska zadań zostanie zamknięta po kliknięciu przycisku miniatury.
Dispatcher	Pobiera element, z Dispatcher który DispatcherObject jest skojarzony. (Odziedziczone po DispatcherObject)
ImageSource	Pobiera lub ustawia obraz wyświetlany na przycisku miniatury.
IsBackgroundVisible	Pobiera lub ustawia wartość wskazującą, czy obramowanie i wyróżnienie jest wyświetlane wokół przycisku miniatury.
IsEnabled	Pobiera lub ustawia wartość wskazującą, czy przycisk miniatury jest włączony.
IsFrozen	Pobiera wartość wskazującą, czy obiekt jest obecnie modyfikowalny. (Odziedziczone po Freezable)
IsInteractive	Pobiera lub ustawia wartość wskazującą, czy użytkownik może wchodzić w interakcję z przyciskiem miniatury.
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)
Visibility	Pobiera lub ustawia wartość określającą stan wyświetlania przycisku miniatury.

Metody

CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez element DependencyPropertyKey. (Odziedziczone po DependencyObject)
Clone()	Tworzy modyfikowalny klon obiektu Freezable, tworząc głębokie kopie wartości obiektu. Podczas kopiowania właściwości zależności obiektu ta metoda kopiuje wyrażenia (które mogą nie być już rozpoznawane), ale nie animacje ani ich bieżące wartości. (Odziedziczone po Freezable)
CloneCore(Freezable)	Sprawia, że wystąpienie jest klonem (kopia głęboka) określonego Freezable obiektu przy użyciu wartości właściwości base (nieimowane). (Odziedziczone po Freezable)
CloneCurrentValue()	Tworzy modyfikowalny klon (kopię głęboką) Freezable obiektu przy użyciu jego bieżących wartości. (Odziedziczone po Freezable)
CloneCurrentValueCore(Freezable)	Sprawia, że wystąpienie jest modyfikowalnym klonem (kopia głęboka) określonego Freezable przy użyciu bieżących wartości właściwości. (Odziedziczone po Freezable)
CoerceValue(DependencyProperty)	Przekształca wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
CreateInstance()	Inicjuje nowe wystąpienie klasy Freezable. (Odziedziczone po Freezable)
CreateInstanceCore()	Po zaimplementowaniu w klasie pochodnej tworzy nowe wystąpienie klasy pochodnej Freezable . (Odziedziczone po Freezable)
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
Freeze()	Sprawia, że bieżący obiekt jest niemodyfikowalny i ustawia jego IsFrozen właściwość na true. (Odziedziczone po Freezable)
FreezeCore(Boolean)	Sprawia, Freezable że obiekt jest niemodyfikowalny lub sprawdza, czy można go niemodyfikować. (Odziedziczone po Freezable)
GetAsFrozen()	Tworzy zamrożoną kopię Freezableobiektu przy użyciu podstawowych (nieimowanych) wartości właściwości. Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable)
GetAsFrozenCore(Freezable)	Sprawia, że wystąpienie jest zamrożonym klonem określonego Freezable przy użyciu wartości właściwości base (nieimowane). (Odziedziczone po Freezable)
GetCurrentValueAsFrozen()	Tworzy zamrożoną kopię przy użyciu bieżących Freezable wartości właściwości. Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Powoduje, że bieżące wystąpienie jest zamrożonym klonem określonego Freezableelementu . Jeśli obiekt ma animowane właściwości zależności, zostaną skopiowane bieżące animowane wartości. (Odziedziczone po Freezable)
GetHashCode()	Pobiera kod skrótu dla tego DependencyObjectpliku . (Odziedziczone po DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości dla tego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia klasy DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnChanged()	Wywoływana, gdy bieżący Freezable obiekt jest modyfikowany. (Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Zapewnia, że dla elementu członkowskiego danych, który właśnie został ustawiony, są ustanawiane DependencyObjectType odpowiednie wskaźniki kontekstu. (Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Ten element członkowski obsługuje infrastrukturę Windows Presentation Foundation (WPF) i nie jest przeznaczony do użycia bezpośrednio z kodu. (Odziedziczone po Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Zastępuje implementację DependencyObject elementu OnPropertyChanged(DependencyPropertyChangedEventArgs) , aby również wywoływać wszelkie Changed procedury obsługi w odpowiedzi na zmieniającą się właściwość zależności typu Freezable. (Odziedziczone po Freezable)
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
ReadPreamble()	Zapewnia dostęp do obiektu Freezable z prawidłowego wątku. Dziedziczenie Freezable elementu musi wywoływać tę metodę na początku dowolnego interfejsu API, który odczytuje elementy członkowskie danych, które nie są właściwościami zależności. (Odziedziczone po Freezable)
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmieniania jej źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jej identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określonej przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
WritePostscript()	Changed Wywołuje zdarzenie dla klasy Freezable i wywołuje jego OnChanged() metodę. Klasy pochodzące z Freezable klasy powinny wywoływać tę metodę na końcu dowolnego interfejsu API, który modyfikuje składowe klasy, które nie są przechowywane jako właściwości zależności. (Odziedziczone po Freezable)
WritePreamble()	Sprawdza, czy element Freezable nie jest zamrożony i czy jest on uzyskiwany z prawidłowego kontekstu wątkowego. Freezable dziedziczenie powinno wywoływać tę metodę na początku dowolnego interfejsu API, który zapisuje dane członkom, które nie są właściwościami zależności. (Odziedziczone po Freezable)

Zdarzenia

Changed	Występuje, gdy Freezable obiekt lub, który zawiera, jest modyfikowany. (Odziedziczone po Freezable)
Click	Występuje po kliknięciu przycisku miniatury.

Zobacz też

• TaskbarItemInfo