ThumbButtonInfo - класс

Представляет сведения об отображении кнопки на эскизе панели задач Windows 7.

Иерархия наследования

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Freezable
        Microsoft.Windows.Shell.ThumbButtonInfo

Пространство имен:  Microsoft.Windows.Shell
Сборка:  Microsoft.Windows.Shell (в Microsoft.Windows.Shell.dll)

Синтаксис

'Декларация
Public NotInheritable Class ThumbButtonInfo _
    Inherits Freezable _
    Implements ICommandSource

public sealed class ThumbButtonInfo : Freezable, 
    ICommandSource

public ref class ThumbButtonInfo sealed : public Freezable, 
    ICommandSource

[<Sealed>]
type ThumbButtonInfo =  
    class
        inherit Freezable
        interface ICommandSource
    end

public final class ThumbButtonInfo extends Freezable implements ICommandSource

Тип ThumbButtonInfo предоставляет следующие члены.

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

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

В начало страницы

Свойства

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

В начало страницы

События

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

В начало страницы

Поля

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

В начало страницы

Заметки

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

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

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

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

Кнопки бегунка панели задач Windows

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылки

Microsoft.Windows.Shell - пространство имен

TaskbarItemInfo