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 объектов , которые предоставляют доступ к командам Воспроизведения и Остановки из элемента панели задач. Этот пример является частью более крупного примера, предоставленного 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 предоставляет кнопки Воспроизведения, Пауза, Вперед и Назад, которые можно использовать для управления воспроизведением мультимедиа с эскиза панели задач при свернутом приложении.

Класс 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)	Обеспечивает создание соответствующих указателей контекста для элемента данных типа DependencyObjectType, который был только что задан. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Этот элемент поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от 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