Partilhar via

Classe ThumbButtonInfo

  • Artigo

Representa informações sobre como exibir um botão de Windows 7 miniatura da barra de tarefas.

Hierarquia de herança

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

Namespace:  Microsoft.Windows.Shell
Assembly:  Microsoft.Windows.Shell (em Microsoft.Windows.Shell.dll)

Sintaxe

'Declaração
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

O tipo ThumbButtonInfo expõe os membros a seguir.

Construtores

  Nome Descrição
Método público ThumbButtonInfo Initializes a new instance of the ThumbButtonInfo class.

Início

Propriedades

  Nome Descrição
Propriedade pública CanFreeze Obtém um valor que indica se o objeto pode ser feito unmodifiable. (Herdado de Freezable.)
Propriedade pública Command Obtém ou define o comando para invocar quando este botão miniatura é clicado.
Propriedade pública CommandParameter Obtém ou define o parâmetro para passar para o Command propriedade.
Propriedade pública CommandTarget Gets or sets the element on which to raise the specified command.
Propriedade pública DependencyObjectType Obtém o DependencyObjectType que envolve o CLR tipo de instância.  (Herdado de DependencyObject.)
Propriedade pública Description Obtém ou define o texto para exibir a dica de ferramenta do botão de miniatura.
Propriedade pública DismissWhenClicked Obtém ou define um valor que indica se a miniatura da barra de tarefas fecha quando se clica no botão de miniatura.
Propriedade pública Dispatcher Obtém o Dispatcher Este DispatcherObject está associado. (Herdado de DispatcherObject.)
Propriedade pública ImageSource Obtém ou define a imagem que é exibida no botão de miniatura.
Propriedade pública IsBackgroundVisible Obtém ou define um valor que indica se uma borda e realce é exibida ao redor do botão de miniatura.
Propriedade pública IsEnabled Obtém ou define um valor que indica se o botão de miniatura está ativado.
Propriedade pública IsFrozen Obtém um valor que indica se o objeto é modificável atualmente. (Herdado de Freezable.)
Propriedade pública IsInteractive Obtém ou define um valor que indica se o usuário pode interagir com o botão de miniatura.
Propriedade pública IsSealed Obtém um valor que indica se essa instância atualmente está lacrada (somente para leitura). (Herdado de DependencyObject.)
Propriedade pública Visibility Obtém ou define um valor que especifica o estado de exibição do botão miniatura.

Início

Métodos

  Nome Descrição
Método público CheckAccess Determina se o segmento de chamada tem acesso a este DispatcherObject. (Herdado de DispatcherObject.)
Método público ClearValue(DependencyProperty) Limpa o valor local de uma propriedade.A propriedade seja limpo é especificada por um DependencyProperty identificador. (Herdado de DependencyObject.)
Método público ClearValue(DependencyPropertyKey) Limpa o valor local de uma propriedade somente leitura.A propriedade seja limpo é especificada por um DependencyPropertyKey. (Herdado de DependencyObject.)
Método público Clone Cria um clone modificável do Freezable, fazendo cópias profunda de todos os valores. do objetoAo copiar propriedades de dependência do objeto, esse método copia expressões (que não mais poderão resolver) mas não animações ou seus valores atuais. (Herdado de Freezable.)
Método protegido CloneCore Torna a instância um clone (cópia profunda) especificado Freezable usando valores de propriedade de base (sem animação). (Herdado de Freezable.)
Método público CloneCurrentValue Cria um clone modificável (cópia em profundidade) da Freezable usando seus valores atuais. (Herdado de Freezable.)
Método protegido CloneCurrentValueCore Torna a instância um clone modificável (cópia em profundidade) especificado Freezable usando valores de propriedade atual. (Herdado de Freezable.)
Método público CoerceValue Converte o valor especificado propriedade de dependência.Isso é feito chamando qualquer CoerceValueCallback especificada nos metadados de propriedade para a propriedade de dependência conforme ela existe na chamada de função DependencyObject. (Herdado de DependencyObject.)
Método protegido CreateInstance Initializes a new instance of the Freezable class. (Herdado de Freezable.)
Método protegido CreateInstanceCore Quando implementado em uma classe derivada, cria uma nova instância do Freezable derivado da classe. (Herdado de Freezable.)
Método público Equals Determina se um fornecido DependencyObject é equivalente à atual DependencyObject. (Herdado de DependencyObject.)
Método protegido Finalize Permite que um objeto tentar liberar recursos e executar outras operações de limpeza antes que ele é recuperado pela coleta de lixo. (Herdado de Object.)
Método público Freeze Torna o objeto atual unmodifiable e define sua IsFrozen propriedade para true. (Herdado de Freezable.)
Método protegido FreezeCore Faz o Freezable object unmodifiable ou testa se podem ser feita unmodifiable. (Herdado de Freezable.)
Método público GetAsFrozen Cria uma cópia congelada a Freezable, usando valores de propriedade de base (sem animação).Porque a cópia está congelada, qualquer subobjetos congelados são copiados por referência. (Herdado de Freezable.)
Método protegido GetAsFrozenCore Torna a instância um clone congelado especificado Freezable usando valores de propriedade de base (sem animação). (Herdado de Freezable.)
Método público GetCurrentValueAsFrozen Cria uma cópia congelada a Freezable usando valores de propriedade atual.Porque a cópia está congelada, qualquer subobjetos congelados são copiados por referência. (Herdado de Freezable.)
Método protegido GetCurrentValueAsFrozenCore Torna a instância atual de um clone congelado especificado Freezable.Se o objeto tem propriedades de dependência animado, seus valores atuais de animados são copiados. (Herdado de Freezable.)
Método público GetHashCode Obtém um código de hash para este DependencyObject. (Herdado de DependencyObject.)
Método público GetLocalValueEnumerator Cria um enumerador especializado para determinar quais propriedades de dependência localmente têm definir valores nessa DependencyObject. (Herdado de DependencyObject.)
Método público GetType Obtém o Type da instância atual. (Herdado de Object.)
Método público GetValue Retorna o valor efetivo atual de um propriedade de dependência nesta instância de um DependencyObject. (Herdado de DependencyObject.)
Método público InvalidateProperty Avalia o valor efetivo de propriedade de dependência especificado (Herdado de DependencyObject.)
Método protegido MemberwiseClone Cria uma cópia superficial do atual Object. (Herdado de Object.)
Método protegido OnChanged Chamado quando o atual Freezable objeto é modificado. (Herdado de Freezable.)
Método protegido OnFreezablePropertyChanged(DependencyObject, DependencyObject) Garante que os ponteiros de contexto apropriado estiver estabelecidos para um DependencyObjectType o membro de dados que acabou de ser definido. (Herdado de Freezable.)
Método protegido OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) Este membro dá suporte a Windows Presentation Foundation (WPF) infra-estrutura e não se destina a ser usado diretamente em seu código. (Herdado de Freezable.)
Método protegido OnPropertyChanged Substitui o DependencyObject a implementação de OnPropertyChanged também chamar Changed manipuladores em resposta a uma alteração propriedade de dependência do tipo Freezable. (Herdado de Freezable.)
Método público ReadLocalValue Retorna o valor de local de um propriedade de dependência, se ele existir. (Herdado de DependencyObject.)
Método protegido ReadPreamble Garante que o Freezable está sendo acessado de um segmento válido.Os herdeiros de Freezable deve chamar esse método no início de qualquer API que lê os membros de dados que são não dependência propriedades. (Herdado de Freezable.)
Método público SetValue(DependencyProperty, Object) Define o valor de local de um propriedade de dependência, especificado por seu identificador de propriedade de dependência. (Herdado de DependencyObject.)
Método público SetValue(DependencyPropertyKey, Object) Define o valor de local de somente leitura propriedade de dependência, especificado pelo DependencyPropertyKey identificador de propriedade de dependência. (Herdado de DependencyObject.)
Método protegido ShouldSerializeProperty Retorna um valor que indica se os processos de serialização devem serializar o valor para o fornecido propriedade de dependência. (Herdado de DependencyObject.)
Método público ToString Retorna um string que representa o objeto atual. (Herdado de Object.)
Método público VerifyAccess Impõe que o thread de chamada tem acesso a este DispatcherObject. (Herdado de DispatcherObject.)
Método protegido WritePostscript Eleva o Changed evento para o Freezable e invoca seu OnChanged método.Classes que derivam de Freezable deve chamar este método no final de qualquer API que modifica os membros de classe que não são armazenados como Propriedades de dependência. (Herdado de Freezable.)
Método protegido WritePreamble Verifica se o Freezable não está congelada e que ele está sendo acessado a partir de um contexto de segmentação válido.Freezableos herdeiros devem chamar esse método no início de qualquer API que grava os membros de dados que são não dependência propriedades. (Herdado de Freezable.)

Início

Eventos

  Nome Descrição
Evento público Changed Ocorre quando o Freezable ou um objeto que ele contém é modificado. (Herdado de Freezable.)
Evento público Click Ocorre quando o botão de miniatura é clicado.

Início

Campos

  Nome Descrição
Campo públicoMembro estático CommandParameterProperty Identifica o CommandParameter propriedade de dependência.
Campo públicoMembro estático CommandProperty Identifica o Command propriedade de dependência.
Campo públicoMembro estático CommandTargetProperty Identifica o CommandTarget propriedade de dependência.
Campo públicoMembro estático DescriptionProperty Identifica o Description propriedade de dependência.
Campo públicoMembro estático DismissWhenClickedProperty Identifica o DismissWhenClicked propriedade de dependência.
Campo públicoMembro estático ImageSourceProperty Identifica o ImageSource propriedade de dependência.
Campo públicoMembro estático IsBackgroundVisibleProperty Identifica o IsBackgroundVisible propriedade de dependência.
Campo públicoMembro estático IsEnabledProperty Identifica o IsEnabled propriedade de dependência.
Campo públicoMembro estático IsInteractiveProperty Identifica o IsInteractive propriedade de dependência.
Campo públicoMembro estático VisibilityProperty Identifica o Visibility propriedade de dependência.

Início

Comentários

O Windows 7 barra de tarefas fornece uma funcionalidade avançada que permite que você use o botão de barra de tarefas para comunicar o status de um usuário e expor as tarefas comuns quando a janela está minimizada ou oculta. Você pode adicionar botões para a miniatura da barra de tarefas para fornecer acesso a tarefas comuns sem alternar para a janela do aplicativo. Por exemplo, Windows Media Player de 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.

O ThumbButtonInfo classe contém propriedades que descrevem como o Windows 7 shell exibe os botões na barra de tarefas miniatura. Ele fornece um invólucro gerenciado da API nativa do Windows. ThumbButtonInfoobjetos estão contidos na TaskbarItemInfo.ThumbButtonInfos coleção.

A funcionalidade aprimorada da barra de tarefas não está disponível nas versões anteriores do Windows, que Windows 7. Em Windows 7, algumas funcionalidades podem não estar disponíveis dependendo de configurações. do usuário Por exemplo, os botões são mostrados apenas na miniatura da barra de tarefas quando Windows Aero está habilitado. Seu aplicativo deve fornecer formas alternativas de interação com o usuário que não depende da funcionalidade aprimorada da barra de tarefas.

A ilustração a seguir mostra uma visualização da barra de tarefas com dois botões de polegar fornecem acesso a comandos de reproduzir e parar.

Botões de miniatura de barra de tarefas do Windows

Exemplo de informações de item da barra de tarefas

Acesso thread-safe

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Consulte também

Referência

Namespace Microsoft.Windows.Shell

TaskbarItemInfo