ThumbButtonInfo Класс

Определение

Пространство имен:: System.Windows.Shell

Сборка:: PresentationFramework.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет сведения о том, как отобразить кнопку в эскизе панели задач 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

Наследование: Object

DispatcherObject

DependencyObject

Freezable
ThumbButtonInfo

Реализации: ICommandSource

Примеры

В следующем примере показано, как создать разметку ThumbButtonInfo . Содержит TaskbarItemInfo коллекцию ThumbButtonInfo объектов, которые предоставляют доступ к командам Play и Stop из элемента панели задач. Этот пример является частью более крупного примера, предоставленного TaskbarItemInfo для класса.

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

Панель задач Windows 7 предоставляет расширенные функциональные возможности, позволяющие использовать кнопку панели задач для обмена данными о состоянии пользователя и предоставления общих задач, когда окно свернуто или скрыто. Вы можете добавить кнопки на эскиз панели задач, чтобы предоставить доступ к общим задачам без переключения в окно приложения. Например, проигрыватель Windows Media предоставляет кнопки воспроизведения, приостановки, пересылки и возврата, которые можно использовать для управления воспроизведением мультимедиа из эскиза панели задач при свернутом приложении.

Класс ThumbButtonInfo содержит свойства, описывающие, как оболочка Windows 7 отображает кнопки в эскизе панели задач. Он предоставляет управляемую оболочку вокруг собственного API Windows. ThumbButtonInfo объекты содержатся в TaskbarItemInfo.ThumbButtonInfos коллекции.

Расширенные функции панели задач недоступны в версиях Windows, предшествующих Windows 7. В Windows 7 некоторые функции могут быть недоступны в зависимости от параметров пользователя. Например, кнопки отображаются только в эскизе панели задач при включении Windows Aero. Приложение должно предоставлять альтернативные способы взаимодействия с пользователем, которые не зависят от расширенных функций панели задач.

На следующем рисунке показана предварительная версия панели задач с двумя кнопками отпечатка, которые предоставляют доступ к командам воспроизведения и остановки.

Пример сведений Кнопки отпечатка панели задач Windows

Конструкторы

Имя	Описание
ThumbButtonInfo()	Инициализирует новый экземпляр класса ThumbButtonInfo.

Поля

Имя	Описание
CommandParameterProperty	Определяет CommandParameter свойство зависимостей.
CommandProperty	Определяет Command свойство зависимостей.
CommandTargetProperty	Определяет CommandTarget свойство зависимостей.
DescriptionProperty	Определяет Description свойство зависимостей.
DismissWhenClickedProperty	Определяет DismissWhenClicked свойство зависимостей.
ImageSourceProperty	Определяет ImageSource свойство зависимостей.
IsBackgroundVisibleProperty	Определяет IsBackgroundVisible свойство зависимостей.
IsEnabledProperty	Определяет IsEnabled свойство зависимостей.
IsInteractiveProperty	Определяет IsInteractive свойство зависимостей.
VisibilityProperty	Определяет Visibility свойство зависимостей.

Свойства

Имя	Описание
CanFreeze	Возвращает значение, указывающее, можно ли изменить объект. (Унаследовано от Freezable)
Command	Возвращает или задает команду для вызова при нажатии этой кнопки эскиза.
CommandParameter	Возвращает или задает параметр для передачи свойству Command .
CommandTarget	Возвращает или задает элемент, на котором необходимо вызвать указанную команду.
DependencyObjectType	Возвращает объект DependencyObjectType , который упаковывает тип СРЕДЫ CLR этого экземпляра. (Унаследовано от DependencyObject)
Description	Возвращает или задает текст, отображаемый для подсказки кнопки эскиза.
DismissWhenClicked	Возвращает или задает значение, указывающее, закрывается ли эскиз панели задач при нажатии кнопки эскиза.
Dispatcher	Dispatcher Возвращает это DispatcherObject значение, с которым связано. (Унаследовано от DispatcherObject)
ImageSource	Возвращает или задает изображение, отображаемое на кнопке эскиза.
IsBackgroundVisible	Возвращает или задает значение, указывающее, отображается ли граница и выделение вокруг кнопки эскиза.
IsEnabled	Возвращает или задает значение, указывающее, включена ли кнопка эскиза.
IsFrozen	Возвращает значение, указывающее, является ли объект изменяемым в настоящее время. (Унаследовано от Freezable)
IsInteractive	Возвращает или задает значение, указывающее, может ли пользователь взаимодействовать с кнопкой эскиза.
IsSealed	Возвращает значение, указывающее, запечатан ли этот экземпляр (только для чтения). (Унаследовано от DependencyObject)
Visibility	Возвращает или задает значение, указывающее состояние отображения кнопки эскиза.

Методы

Имя	Описание
CheckAccess()	Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)	Очищает локальное значение свойства. Свойство для очистки указывается идентификатором DependencyProperty . (Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)	Очищает локальное значение свойства только для чтения. Свойство, которое необходимо очистить, задается параметром DependencyPropertyKey. (Унаследовано от DependencyObject)
Clone()	Создает модификаторный клон Freezableобъекта, делая глубокие копии значений объекта. При копировании свойств зависимостей объекта этот метод копирует выражения (которые больше не могут разрешаться), но не анимации или их текущие значения. (Унаследовано от Freezable)
CloneCore(Freezable)	Делает экземпляр клоном (глубокой копией) указанных Freezable значений свойств с использованием базовых (не анимированных) значений свойств. (Унаследовано от Freezable)
CloneCurrentValue()	Создает модификируемую клон (глубокую копию) текущего Freezable значения. (Унаследовано от Freezable)
CloneCurrentValueCore(Freezable)	Делает экземпляр модификируемым клоном (глубокой копией) указанного Freezable с использованием текущих значений свойств. (Унаследовано от Freezable)
CoerceValue(DependencyProperty)	Принуждает значение указанного свойства зависимостей. Это достигается путем вызова любой CoerceValueCallback функции, указанной в метаданных свойств для свойства зависимостей, так как он существует при вызове DependencyObject. (Унаследовано от DependencyObject)
CreateInstance()	Инициализирует новый экземпляр класса Freezable. (Унаследовано от Freezable)
CreateInstanceCore()	При реализации в производном классе создает новый экземпляр производного Freezable класса. (Унаследовано от Freezable)
Equals(Object)	Определяет, эквивалентен ли предоставленный DependencyObject объект текущему DependencyObject. (Унаследовано от DependencyObject)
Freeze()	Делает текущий объект неизменяемым и задает для свойства значение IsFrozen`true`. (Унаследовано от Freezable)
FreezeCore(Boolean)	Freezable Делает объект неизменимым или проверяет, может ли он быть изменен. (Унаследовано от Freezable)
GetAsFrozen()	Создает замороженную копию базовых Freezable(не анимированных) значений свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetAsFrozenCore(Freezable)	Делает экземпляр замороженным клоном указанных Freezable значений свойств (не анимированных). (Унаследовано от Freezable)
GetCurrentValueAsFrozen()	Создает замороженную копию с использованием текущих значений Freezable свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Делает текущий экземпляр замороженным клоном указанного Freezable. Если объект имеет анимированные свойства зависимостей, их текущие анимированные значения копируются. (Унаследовано от Freezable)
GetHashCode()	Получает хэш-код для этого DependencyObject. (Унаследовано от DependencyObject)
GetLocalValueEnumerator()	Создает специализированный перечислитель для определения того, какие свойства зависимостей имеют локальные значения для этого DependencyObject. (Унаследовано от DependencyObject)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetValue(DependencyProperty)	Возвращает текущее эффективное значение свойства зависимостей для этого экземпляра DependencyObject. (Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)	Повторно вычисляет эффективное значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnChanged()	Вызывается при изменении текущего Freezable объекта. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Убедитесь, что для элемента данных, который только что был установлен, установлены DependencyObjectType соответствующие указатели контекста. (Унаследовано от Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Переопределяет DependencyObject реализацию OnPropertyChanged(DependencyPropertyChangedEventArgs) для вызова всех Changed обработчиков в ответ на изменение свойства зависимостей типа Freezable. (Унаследовано от Freezable)
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если оно существует. (Унаследовано от DependencyObject)
ReadPreamble()	Гарантирует, что Freezable доступ к ней осуществляется из допустимого потока. Наследующие метод Freezable должны вызывать этот метод в начале любого API, который считывает элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable)
SetCurrentValue(DependencyProperty, Object)	Задает значение свойства зависимостей, не изменяя его источник значений. (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей, указанное его идентификатором свойства зависимостей. (Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)	Задает локальное значение свойства зависимостей только для чтения, указанное DependencyPropertyKey идентификатором свойства зависимости. (Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Возвращает значение, указывающее, должны ли процессы сериализации сериализовать значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
VerifyAccess()	Принудительно применяет, что вызывающий поток имеет доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
WritePostscript()	Changed Вызывает событие для Freezable метода и вызывает его OnChanged() метод. Классы, производные от Freezable этого метода, должны вызываться в конце любого API, который изменяет элементы класса, которые не хранятся в качестве свойств зависимостей. (Унаследовано от Freezable)
WritePreamble()	Проверяет, что Freezable он не заморожен и к нему осуществляется доступ из допустимого контекста потоков. Freezable наследующие метод должны вызывать этот метод в начале любого API, записывающего элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable)

События

Имя	Описание
Changed	Происходит при Freezable изменении объекта или объекта, содержащего его. (Унаследовано от Freezable)
Click	Происходит при нажатии кнопки эскиза.

Применяется к

См. также раздел

TaskbarItemInfo

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через