ThumbButtonInfo Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa informações sobre como exibir um botão na miniatura da barra de tarefas do Windows 7.
public ref class ThumbButtonInfo sealed : System::Windows::Freezable, System::Windows::Input::ICommandSourcepublic sealed class ThumbButtonInfo : System.Windows.Freezable, System.Windows.Input.ICommandSourcetype ThumbButtonInfo = class
inherit Freezable
interface ICommandSourcePublic NotInheritable Class ThumbButtonInfo
Inherits Freezable
Implements ICommandSource- Herança
- Implementações
Exemplos
O exemplo a seguir mostra como criar uma ThumbButtonInfo marcação na marcação. Contém TaskbarItemInfo uma coleção de ThumbButtonInfo objetos que fornecem acesso aos comandos Reproduzir e Parar do item da barra de tarefas. Este exemplo faz parte de um exemplo maior fornecido para a 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>
Comentários
A barra de tarefas do Windows 7 fornece funcionalidade aprimorada que permite usar o botão da barra de tarefas para comunicar o status a um usuário e expor tarefas comuns quando a janela é minimizada ou oculta. Você pode adicionar botões à miniatura da barra de tarefas para fornecer acesso a tarefas comuns sem alternar para a janela do aplicativo. Por exemplo, o Windows Media Player fornece botões Reproduzir, Pausar, Encaminhar e Voltar que você pode usar para controlar a reprodução de mídia da miniatura da barra de tarefas quando o aplicativo é minimizado.
A ThumbButtonInfo classe contém propriedades que descrevem como o shell do Windows 7 exibe os botões na miniatura da barra de tarefas. Ele fornece um wrapper gerenciado em torno da API nativa do Windows. ThumbButtonInfo os objetos estão contidos na TaskbarItemInfo.ThumbButtonInfos coleção.
A funcionalidade de barra de tarefas aprimorada não está disponível em versões do Windows anteriores ao Windows 7. No Windows 7, algumas funcionalidades podem não estar disponíveis dependendo das configurações do usuário. Por exemplo, os botões só são mostrados na miniatura da barra de tarefas quando o Windows Aero está habilitado. Seu aplicativo deve fornecer maneiras alternativas de interagir com o usuário que não depende da funcionalidade de barra de tarefas aprimorada.
A ilustração a seguir mostra uma visualização da barra de tarefas com dois botões de polegar que fornecem acesso aos comandos Reproduzir e Parar.
Exemplo de informações de da de tarefas da barra de tarefas Botões do Polegar da Barra de Tarefas do Windows
Construtores
| Nome | Description |
|---|---|
| ThumbButtonInfo() |
Inicializa uma nova instância da classe ThumbButtonInfo. |
Campos
| Nome | Description |
|---|---|
| CommandParameterProperty |
Identifica a CommandParameter propriedade de dependência. |
| CommandProperty |
Identifica a Command propriedade de dependência. |
| CommandTargetProperty |
Identifica a CommandTarget propriedade de dependência. |
| DescriptionProperty |
Identifica a Description propriedade de dependência. |
| DismissWhenClickedProperty |
Identifica a DismissWhenClicked propriedade de dependência. |
| ImageSourceProperty |
Identifica a ImageSource propriedade de dependência. |
| IsBackgroundVisibleProperty |
Identifica a IsBackgroundVisible propriedade de dependência. |
| IsEnabledProperty |
Identifica a IsEnabled propriedade de dependência. |
| IsInteractiveProperty |
Identifica a IsInteractive propriedade de dependência. |
| VisibilityProperty |
Identifica a Visibility propriedade de dependência. |
Propriedades
| Nome | Description |
|---|---|
| CanFreeze |
Obtém um valor que indica se o objeto pode ser tornado inmodificável. (Herdado de Freezable) |
| Command |
Obtém ou define o comando a ser invocado quando este botão de miniatura é clicado. |
| CommandParameter |
Obtém ou define o parâmetro a ser passado para a propriedade Command. |
| CommandTarget |
Obtém ou define o elemento no qual gerar o comando especificado. |
| DependencyObjectType |
Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject) |
| Description |
Obtém ou define o texto a ser exibido para a dica de ferramenta do botão de miniatura. |
| DismissWhenClicked |
Obtém ou define um valor que indica se a miniatura da barra de tarefas é fechada quando o botão de miniatura é clicado. |
| Dispatcher |
Obtém o Dispatcher que DispatcherObject está associado. (Herdado de DispatcherObject) |
| ImageSource |
Obtém ou define a imagem exibida no botão de miniatura. |
| IsBackgroundVisible |
Obtém ou define um valor que indica se uma borda e um realce são exibidos ao redor do botão de miniatura. |
| IsEnabled |
Obtém ou define um valor que indica se o botão de miniatura está habilitado. |
| IsFrozen |
Obtém um valor que indica se o objeto é modificável no momento. (Herdado de Freezable) |
| IsInteractive |
Obtém ou define um valor que indica se o usuário pode interagir com o botão de miniatura. |
| IsSealed |
Obtém um valor que indica se essa instância está lacrada no momento (somente leitura). (Herdado de DependencyObject) |
| Visibility |
Obtém ou define um valor que especifica o estado de exibição do botão de miniatura. |
Métodos
| Nome | Description |
|---|---|
| CheckAccess() |
Determina se o thread de chamada tem acesso a isso DispatcherObject. (Herdado de DispatcherObject) |
| ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade. A propriedade a ser desmarcada é especificada por um DependencyProperty identificador. (Herdado de DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Limpa o valor local de uma propriedade somente leitura. A propriedade a ser desmarcada é especificada por um DependencyPropertyKey. (Herdado de DependencyObject) |
| Clone() |
Cria um clone modificável do Freezable. fazendo cópias profundas dos valores do objeto. Ao copiar as propriedades de dependência do objeto, esse método copia expressões (que podem não ser mais resolvidas), mas não animações ou seus valores atuais. (Herdado de Freezable) |
| CloneCore(Freezable) |
Torna a instância um clone (cópia profunda) dos valores de propriedade base (não animados) especificados Freezable . (Herdado de Freezable) |
| CloneCurrentValue() |
Cria um clone modificável (cópia profunda) do uso de Freezable seus valores atuais. (Herdado de Freezable) |
| CloneCurrentValueCore(Freezable) |
Torna a instância um clone modificável (cópia profunda) do especificado Freezable usando valores de propriedade atuais. (Herdado de Freezable) |
| CoerceValue(DependencyProperty) |
Coagi o valor da propriedade de dependência especificada. Isso é feito invocando qualquer CoerceValueCallback função especificada nos metadados de propriedade para a propriedade de dependência como ela existe na chamada DependencyObject. (Herdado de DependencyObject) |
| CreateInstance() |
Inicializa uma nova instância da classe Freezable. (Herdado de Freezable) |
| CreateInstanceCore() |
Quando implementado em uma classe derivada, cria uma nova instância da Freezable classe derivada. (Herdado de Freezable) |
| Equals(Object) |
Determina se um fornecido DependencyObject é equivalente ao atual DependencyObject. (Herdado de DependencyObject) |
| Freeze() |
Torna o objeto atual inmodificável e define sua IsFrozen propriedade como |
| FreezeCore(Boolean) |
Torna o Freezable objeto inmodificável ou testa se ele pode se tornar não modificável. (Herdado de Freezable) |
| GetAsFrozen() |
Cria uma cópia congelada dos valores de Freezablepropriedade base (não animados). Como a cópia está congelada, todos os sub-objetos congelados são copiados por referência. (Herdado de Freezable) |
| GetAsFrozenCore(Freezable) |
Torna a instância um clone congelado dos valores de propriedade base (não animados) especificados Freezable . (Herdado de Freezable) |
| GetCurrentValueAsFrozen() |
Cria uma cópia congelada do Freezable uso de valores de propriedade atuais. Como a cópia está congelada, todos os sub-objetos congelados são copiados por referência. (Herdado de Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Torna a instância atual um clone congelado do especificado Freezable. Se o objeto tiver propriedades de dependência animadas, seus valores animados atuais serão copiados. (Herdado de Freezable) |
| GetHashCode() |
Obtém um código hash para isso DependencyObject. (Herdado de DependencyObject) |
| GetLocalValueEnumerator() |
Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente.DependencyObject (Herdado de DependencyObject) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetValue(DependencyProperty) |
Retorna o valor efetivo atual de uma propriedade de dependência nesta instância de um DependencyObject. (Herdado de DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Reavalia o valor efetivo da propriedade de dependência especificada. (Herdado de DependencyObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| OnChanged() |
Chamado quando o objeto atual Freezable é modificado. (Herdado de Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Esse membro dá suporte à infraestrutura do WPF (Windows Presentation Foundation) e não se destina a ser usado diretamente do seu código. (Herdado de Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Garante que os ponteiros de contexto apropriados sejam estabelecidos para um DependencyObjectType membro de dados que acabou de ser definido. (Herdado de Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Substitui a DependencyObject implementação de OnPropertyChanged(DependencyPropertyChangedEventArgs) invocar também os Changed manipuladores em resposta a uma propriedade de dependência de alteração do tipo Freezable. (Herdado de Freezable) |
| ReadLocalValue(DependencyProperty) |
Retorna o valor local de uma propriedade de dependência, se ela existir. (Herdado de DependencyObject) |
| ReadPreamble() |
Garante que ele Freezable esteja sendo acessado de um thread válido. Os herdadores devem Freezable chamar esse método no início de qualquer API que leia os membros de dados que não são propriedades de dependência. (Herdado de Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
Define o valor de uma propriedade de dependência sem alterar sua fonte de valor. (Herdado de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Define o valor local de uma propriedade de dependência, especificada por seu identificador de propriedade de dependência. (Herdado de DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Define o valor local de uma propriedade de dependência somente leitura, especificada pelo DependencyPropertyKey identificador da propriedade de dependência. (Herdado de DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| VerifyAccess() |
Impõe que o thread de chamada tenha acesso a isso DispatcherObject. (Herdado de DispatcherObject) |
| WritePostscript() |
Aciona o Changed evento para o Freezable método e invoca seu OnChanged() método. Classes das quais derivam Freezable devem chamar esse método no final de qualquer API que modifique os membros da classe que não são armazenados como propriedades de dependência. (Herdado de Freezable) |
| WritePreamble() |
Verifica se o Freezable não está congelado e se ele está sendo acessado de um contexto de threading válido. Freezable os herdadores devem chamar esse método no início de qualquer API que grava em membros de dados que não são propriedades de dependência. (Herdado de Freezable) |
Eventos
| Nome | Description |
|---|---|
| Changed |
Ocorre quando o objeto ou um Freezable objeto que ele contém é modificado. (Herdado de Freezable) |
| Click |
Ocorre quando o botão de miniatura é clicado. |
