ThumbButtonInfo Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa informação sobre como mostrar 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 seguinte mostra como criar uma ThumbButtonInfo marcação in. Contém TaskbarItemInfo uma coleção de ThumbButtonInfo objetos que dão acesso aos comandos Play e Stop a partir do item da barra de tarefas. Este exemplo faz parte de um exemplo mais amplo fornecido à TaskbarItemInfo turma.
<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>
Observações
A barra de tarefas do Windows 7 oferece funcionalidades melhoradas que permitem usar o botão da barra de tarefas para comunicar o estado ao utilizador e expor tarefas comuns quando a janela está minimizada ou oculta. Pode adicionar botões à miniatura da barra de tarefas para dar acesso a tarefas comuns sem ter de mudar para a janela da aplicação. Por exemplo, Windows leitor de multimédia disponibiliza botões de Play, Pausa, Avançar e Voltar que podes usar para controlar a reprodução multimédia a partir da miniatura da barra de tarefas quando a aplicação está minimizada.
A classe ThumbButtonInfo contém propriedades que descrevem como o shell Windows 7 exibe os botões na miniatura da barra de tarefas. Fornece um wrapper gerido em torno da API nativa do Windows. ThumbButtonInfo os objetos estão incluídos na TaskbarItemInfo.ThumbButtonInfos coleção.
A funcionalidade melhorada da barra de tarefas não está disponível nas versões do Windows anteriores ao Windows 7. No Windows 7, alguma funcionalidade pode não estar disponível dependendo das definições do utilizador. Por exemplo, os botões só aparecem na miniatura da barra de tarefas quando o Windows Aero está ativado. A sua aplicação deve fornecer formas alternativas de interação com o utilizador que não dependam da funcionalidade melhorada da barra de tarefas.
A ilustração seguinte mostra uma pré-visualização da barra de tarefas com dois botões de polegares que dão acesso aos comandos Play e Stop.
Windows Botões do Polegar da Barra de Tarefas
Construtores
| Name | Description |
|---|---|
| ThumbButtonInfo() |
Inicializa uma nova instância da ThumbButtonInfo classe. |
Campos
| Name | 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
| Name | Description |
|---|---|
| CanFreeze |
Obtém um valor que indica se o objeto pode ser tornado inmodificável. (Herdado de Freezable) |
| Command |
Recebe ou define o comando para invocar quando este botão de miniatura é clicado. |
| CommandParameter |
Obtém ou define o parâmetro a transmitir à propriedade Command. |
| CommandTarget |
Obtém ou define o elemento para levantar o comando especificado. |
| DependencyObjectType |
Obtém o DependencyObjectType que envolve o tipo CLR desta instância. (Herdado de DependencyObject) |
| Description |
Obtém ou define o texto para mostrar a dica do botão de miniatura. |
| DismissWhenClicked |
Recebe ou define um valor que indica se a miniatura da barra de tarefas fecha quando o botão da miniatura é clicado. |
| Dispatcher |
Percebe o Dispatcher que isto DispatcherObject está associado. (Herdado de DispatcherObject) |
| ImageSource |
Obtém ou define a imagem que é mostrada no botão da miniatura. |
| IsBackgroundVisible |
Recebe ou define um valor que indica se uma borda e um destaque são exibidos à volta do botão da miniatura. |
| IsEnabled |
Recebe ou define um valor que indica se o botão da miniatura está ativado. |
| IsFrozen |
Recebe um valor que indica se o objeto é atualmente modificável. (Herdado de Freezable) |
| IsInteractive |
Recebe ou define um valor que indica se o utilizador pode interagir com o botão de miniatura. |
| IsSealed |
Recebe um valor que indica se esta instância está atualmente selada (apenas leitura). (Herdado de DependencyObject) |
| Visibility |
Recebe ou define um valor que especifica o estado de exibição do botão da miniatura. |
Métodos
| Name | Description |
|---|---|
| CheckAccess() |
Determina se o thread que chama tem acesso a este DispatcherObject. (Herdado de DispatcherObject) |
| ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um DependencyProperty identificador. (Herdado de DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Limpa o valor local de uma propriedade de apenas leitura. O imóvel a ser limpo é especificado 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, este método copia expressões (que podem deixar de se resolver), mas não as animações nem os seus valores atuais. (Herdado de Freezable) |
| CloneCore(Freezable) |
Torna a instância um clone (cópia profunda) dos valores especificados Freezable usando valores base (não animados). (Herdado de Freezable) |
| CloneCurrentValue() |
Cria um clone modificável (cópia profunda) do Freezable usando os seus valores atuais. (Herdado de Freezable) |
| CloneCurrentValueCore(Freezable) |
Torna a instância um clone modificável (cópia profunda) do especificado Freezable usando valores atuais de propriedades. (Herdado de Freezable) |
| CoerceValue(DependencyProperty) |
Coage o valor da propriedade de dependência especificada. Isto é conseguido invocando qualquer CoerceValueCallback função especificada nos metadados da propriedade para a propriedade de dependência tal como existe na chamada DependencyObject. (Herdado de DependencyObject) |
| CreateInstance() |
Inicializa uma nova instância da Freezable classe. (Herdado de Freezable) |
| CreateInstanceCore() |
Quando implementado numa classe derivada, cria-se uma nova instância da Freezable classe derivada. (Herdado de Freezable) |
| Equals(Object) |
Determina se um fornecido DependencyObject é equivalente à corrente DependencyObject. (Herdado de DependencyObject) |
| Freeze() |
Torna o objeto atual immodificável e define a sua IsFrozen propriedade como |
| FreezeCore(Boolean) |
Torna o Freezable objeto immodificável ou testa se pode ser tornado immodificável. (Herdado de Freezable) |
| GetAsFrozen() |
Cria uma cópia congelada do Freezable, usando valores base (não animados) da propriedade. Como a cópia está congelada, quaisquer subobjetos congelados são copiados por referência. (Herdado de Freezable) |
| GetAsFrozenCore(Freezable) |
Torna a instância um clone congelado do especificado Freezable usando valores base (não animados). (Herdado de Freezable) |
| GetCurrentValueAsFrozen() |
Cria uma cópia congelada do Freezable usando os valores atuais das propriedades. Como a cópia está congelada, quaisquer subobjetos 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, os seus valores animados atuais são copiados. (Herdado de Freezable) |
| GetHashCode() |
Obtém um código de hash para isto DependencyObject. (Herdado de DependencyObject) |
| GetLocalValueEnumerator() |
Cria um enumerador especializado para determinar quais as propriedades de dependência que têm valores localmente definidos neste DependencyObject. (Herdado de DependencyObject) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetValue(DependencyProperty) |
Devolve 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 atual Object. (Herdado de Object) |
| OnChanged() |
Chamada quando o objeto atual Freezable é modificado. (Herdado de Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Este membro suporta a infraestrutura Windows Presentation Foundation (WPF) e não foi concebido para ser usado diretamente a partir do seu código. (Herdado de Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Assegura que os apontadores de contexto apropriados são estabelecidos para um DependencyObjectType membro de dados que acabou de ser definido. (Herdado de Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Sobrepõe a DependencyObject implementação de OnPropertyChanged(DependencyPropertyChangedEventArgs) para também invocar quaisquer Changed manipuladores em resposta a uma alteração da propriedade de dependência do tipo Freezable. (Herdado de Freezable) |
| ReadLocalValue(DependencyProperty) |
Devolve o valor local de uma propriedade de dependência, se esta existir. (Herdado de DependencyObject) |
| ReadPreamble() |
Garante que está a ser acedido Freezable a partir de um thread válido. Os herdeiros de Freezable devem chamar este método no início de qualquer API que leia 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 a sua fonte de valor. (Herdado de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Define o valor local de uma propriedade de dependência, especificado pelo seu identificador de propriedade de dependência. (Herdado de DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Define o valor local de uma propriedade de dependência somente de leitura, especificado pelo DependencyPropertyKey identificador da propriedade de dependência. (Herdado de DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Devolve um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| VerifyAccess() |
Faz cumprir que o thread que chama tem acesso a este DispatcherObject. (Herdado de DispatcherObject) |
| WritePostscript() |
Eleva o Changed evento para o Freezable e invoca o seu OnChanged() método. As classes que derivam de Freezable devem chamar este método no final de qualquer API que modifique membros de classe que não estejam armazenados como propriedades de dependência. (Herdado de Freezable) |
| WritePreamble() |
Verifica se o Freezable não está congelado e que está a ser acedido a partir de um contexto de threading válido. Freezable os herdeiros devem chamar este método no início de qualquer API que escreva para membros de dados que não sejam propriedades de dependência. (Herdado de Freezable) |
evento
| Name | Description |
|---|---|
| Changed |
Ocorre quando o Freezable ou um objeto que contém é modificado. (Herdado de Freezable) |
| Click |
Acontece quando o botão da miniatura é clicado. |