Partilhar via

Classe TaskbarItemInfo

  • Artigo

Representa informações sobre como a miniatura da barra de tarefas é exibida.

Hierarquia de herança

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

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

Sintaxe

'Declaração
Public NotInheritable Class TaskbarItemInfo _
    Inherits Freezable

public sealed class TaskbarItemInfo : Freezable

public ref class TaskbarItemInfo sealed : public Freezable

[<Sealed>]
type TaskbarItemInfo =  
    class
        inherit Freezable
    end

public final class TaskbarItemInfo extends Freezable

O tipo TaskbarItemInfo expõe os membros a seguir.

Construtores

  Nome Descrição
Método público TaskbarItemInfo Initializes a new instance of the TaskbarItemInfo 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 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 de dica de ferramenta do item da barra de tarefas.
Propriedade pública Dispatcher Obtém o Dispatcher Este DispatcherObject está associado. (Herdado de DispatcherObject.)
Propriedade pública IsFrozen Obtém um valor que indica se o objeto é modificável atualmente. (Herdado de Freezable.)
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 Overlay Obtém ou define a imagem que é exibida sobre o ícone do programa no botão de barra de tarefas.
Propriedade pública ProgressState Obtém ou define um valor que indica como o indicador de progresso é exibido no botão de barra de tarefas.
Propriedade pública ProgressValue Obtém ou define um valor que indica a plenitude do indicador de progresso no botão de barra de tarefas.
Propriedade pública ThumbButtonInfos Obtém ou define uma coleção de ThumbButtonInfo objetos que estão associados a Window.
Propriedade pública ThumbnailClipMargin Obtém ou define um valor que especifica a parte da área de cliente da janela do aplicativo que é exibida na miniatura da barra de tarefas.

Início

Propriedades anexadas

  Nome Descrição
Propriedade anexada pública TaskbarItemInfo Obtém ou define um TaskbarItemInfo que está conectado a uma janela.

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úblicoMembro estático GetTaskbarItemInfo Obtém o valor da TaskbarItemInfo anexado a propriedade de um objeto.
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úblicoMembro estático SetTaskbarItemInfo Define o valor de TaskbarItemInfo anexado a propriedade de um objeto.
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.)

Início

Campos

  Nome Descrição
Campo públicoMembro estático DescriptionProperty Identifica o Description propriedade de dependência.
Campo públicoMembro estático OverlayProperty Identifica o Overlay propriedade de dependência.
Campo públicoMembro estático ProgressStateProperty Identifica o ProgressState propriedade de dependência.
Campo públicoMembro estático ProgressValueProperty Identifica o ProgressValue propriedade de dependência.
Campo públicoMembro estático TaskbarItemInfoProperty Identifica o TaskbarItemInfo propriedade de dependência.
Campo públicoMembro estático ThumbButtonInfosProperty Identifica o ThumbButtonInfos propriedade de dependência.
Campo públicoMembro estático ThumbnailClipMarginProperty Identifica o ThumbnailClipMargin propriedade de dependência.

Início

Comentários

O TaskbarItemInfo classe fornece um wrapper gerenciado para Windows 7 a funcionalidade da barra de tarefas. Para obter mais informações sobre o shell do Windows e a barra de tarefas APIs nativa, consulte Extensões da barra de tarefas.

O Windows 7 barra de tarefas fornece uma funcionalidade avançada que permite que você use o item da barra de tarefas para comunicar o status de um usuário e expor as tarefas comuns quando a janela está minimizada ou oculta. A funcionalidade que é exposta pelo TaskbarItemInfo classe não está disponível nas versões do Windows anteriores que Windows 7. Aplicativos que usam o TaskbarItemInfo classe ainda pode executar em versões anteriores do Windows; no entanto, esses aprimoramentos da barra de tarefas não estão disponíveis em versões anteriores.

Em Windows 7, algumas funcionalidades da barra de tarefas podem não estar disponível, dependendo das configurações do usuário. Por exemplo, a funcionalidade de barra de tarefas não está disponível se Windows Aero estiver desabilitada ou se o aplicativo é iniciado com permissões elevadas. Seu aplicativo deve fornecer outras maneiras de interagir com o usuário que não dependem da funcionalidade aprimorada da barra de tarefas no Windows 7.

Ícones de programa na área de notificação, o que é na extrema direita da barra de tarefas, são normalmente usados para comunicar o status do aplicativo a um usuário. Por padrão, o Windows 7 barra de tarefas oculta os ícones de programa na área de notificação. No entanto, você pode definir o Overlay propriedade para adicionar uma imagem do botão de barra de tarefas para comunicar o status, como o status online em um aplicativo de mensagens. A imagem de sobreposição permite aos usuários ver o status de aplicativo, mesmo se eles não podem ver o ícone do programa na área de notificação. Você também pode exibir o andamento da execução de tarefas no botão da barra de tarefas, definindo a ProgressState e ProgressValue Propriedades.

O Windows 7 barra de tarefas exibe uma miniatura do aplicativo quando você move o ponteiro do mouse sobre o botão da barra de tarefas. Por padrão, a janela do aplicativo inteiro é mostrada. Você pode especificar uma determinada parte da janela para exibir na miniatura, definindo a ThumbnailClipMargin propriedade. Você também pode especificar um Description que é exibido em uma dica de ferramenta acima da miniatura da barra de tarefas. A dica de ferramenta é exibida mesmo quando a miniatura não pode ser vista por causa das configurações do usuário.

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, o Window Media Player fornece reproduzir, pausar, Avançar e voltar os botões que permitem controlam a reprodução de mídia da miniatura da barra de tarefas quando o aplicativo é minimizado. Os botões na barra de tarefas miniatura são representados por ThumbButtonInfo objetos e estão continham no ThumbButtonInfos coleção.

A ilustração a seguir mostra os recursos aprimorados da Windows 7 da barra de tarefas.

Recursos avançados da 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