ThumbButtonInfo Clase

Definición

Espacio de nombres:

System.Windows.Shell

Ensamblado:

PresentationFramework.dll

Representa información sobre cómo mostrar un botón en la miniatura de la barra de tareas de Windows 7.

public ref class ThumbButtonInfo sealed : System::Windows::Freezable, System::Windows::Input::ICommandSource

public sealed class ThumbButtonInfo : System.Windows.Freezable, System.Windows.Input.ICommandSource

type ThumbButtonInfo = class
    inherit Freezable
    interface ICommandSource

Public NotInheritable Class ThumbButtonInfo
Inherits Freezable
Implements ICommandSource

Herencia

Object

DispatcherObject

DependencyObject

Freezable

ThumbButtonInfo

Implementaciones

ICommandSource

Ejemplos

En el ejemplo siguiente se muestra cómo crear un ThumbButtonInfo elemento en el marcado. TaskbarItemInfo contiene una colección de ThumbButtonInfo objetos que proporcionan acceso a los comandos Play y Stop del elemento de la barra de tareas. Este ejemplo forma parte de un ejemplo más grande proporcionado para la TaskbarItemInfo clase .

<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>

Comentarios

La barra de tareas de Windows 7 proporciona una funcionalidad mejorada que permite usar el botón de la barra de tareas para comunicar el estado a un usuario y exponer tareas comunes cuando la ventana está minimizada o oculta. Puede agregar botones a la miniatura de la barra de tareas para proporcionar acceso a tareas comunes sin cambiar a la ventana de la aplicación. Por ejemplo, el Reproductor de Windows Media proporciona botones Reproducir, Pausar, Reenviar y Atrás que puedes usar para controlar la reproducción multimedia desde la miniatura de la barra de tareas cuando se minimiza la aplicación.

La ThumbButtonInfo clase contiene propiedades que describen cómo el shell de Windows 7 muestra los botones en la miniatura de la barra de tareas. Proporciona un contenedor administrado en torno a la API nativa de Windows. ThumbButtonInfo los objetos están contenidos en la TaskbarItemInfo.ThumbButtonInfos colección.

La funcionalidad mejorada de la barra de tareas no está disponible en versiones de Windows anteriores a Windows 7. En Windows 7, es posible que algunas funciones no estén disponibles en función de la configuración del usuario. Por ejemplo, los botones solo se muestran en la miniatura de la barra de tareas cuando Windows Aero está habilitado. La aplicación debe proporcionar formas alternativas de interactuar con el usuario que no dependen de la funcionalidad mejorada de la barra de tareas.

En la ilustración siguiente se muestra una vista previa de la barra de tareas con dos botones pulgares que proporcionan acceso a los comandos Reproducir y Detener.

de Botones de control de la barra de tareas de Windows

Constructores

Nombre	Description
ThumbButtonInfo()	Inicializa una nueva instancia de la clase ThumbButtonInfo.

Campos

Nombre	Description
CommandParameterProperty	Identifica la CommandParameter propiedad de dependencia.
CommandProperty	Identifica la Command propiedad de dependencia.
CommandTargetProperty	Identifica la CommandTarget propiedad de dependencia.
DescriptionProperty	Identifica la Description propiedad de dependencia.
DismissWhenClickedProperty	Identifica la DismissWhenClicked propiedad de dependencia.
ImageSourceProperty	Identifica la ImageSource propiedad de dependencia.
IsBackgroundVisibleProperty	Identifica la IsBackgroundVisible propiedad de dependencia.
IsEnabledProperty	Identifica la IsEnabled propiedad de dependencia.
IsInteractiveProperty	Identifica la IsInteractive propiedad de dependencia.
VisibilityProperty	Identifica la Visibility propiedad de dependencia.

Propiedades

Nombre	Description
CanFreeze	Obtiene un valor que indica si el objeto se puede hacer no modificable. (Heredado de Freezable)
Command	Obtiene o establece el comando que se va a invocar cuando se hace clic en este botón de miniatura.
CommandParameter	Obtiene o establece el parámetro que se debe pasar a la propiedad Command.
CommandTarget	Obtiene o establece el elemento en el que se va a generar el comando especificado.
DependencyObjectType	Obtiene el DependencyObjectType objeto que encapsula el tipo CLR de esta instancia. (Heredado de DependencyObject)
Description	Obtiene o establece el texto que se va a mostrar para la información sobre herramientas del botón de miniatura.
DismissWhenClicked	Obtiene o establece un valor que indica si la miniatura de la barra de tareas se cierra cuando se hace clic en el botón miniatura.
Dispatcher	Obtiene el objeto al que DispatcherDispatcherObject está asociado. (Heredado de DispatcherObject)
ImageSource	Obtiene o establece la imagen que se muestra en el botón de miniatura.
IsBackgroundVisible	Obtiene o establece un valor que indica si se muestra un borde y un resaltado alrededor del botón de miniatura.
IsEnabled	Obtiene o establece un valor que indica si el botón de miniatura está habilitado.
IsFrozen	Obtiene un valor que indica si el objeto se puede modificar actualmente. (Heredado de Freezable)
IsInteractive	Obtiene o establece un valor que indica si el usuario puede interactuar con el botón de miniatura.
IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (solo lectura). (Heredado de DependencyObject)
Visibility	Obtiene o establece un valor que especifica el estado de visualización del botón de miniatura.

Métodos

Nombre	Description
CheckAccess()	Determina si el subproceso que llama tiene acceso a este DispatcherObject. (Heredado de DispatcherObject)
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. Un identificador especifica DependencyProperty la propiedad que se va a borrar. (Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante .DependencyPropertyKey (Heredado de DependencyObject)
Clone()	Crea un clon modificable de Freezable, haciendo copias profundas de los valores del objeto. Al copiar las propiedades de dependencia del objeto, este método copia expresiones (que podrían dejar de resolverse), pero no animaciones ni sus valores actuales. (Heredado de Freezable)
CloneCore(Freezable)	Convierte la instancia en un clon (copia profunda) del especificado Freezable mediante valores de propiedad base (no animados). (Heredado de Freezable)
CloneCurrentValue()	Crea un clon modificable (copia profunda) del Freezable utilizando sus valores actuales. (Heredado de Freezable)
CloneCurrentValueCore(Freezable)	Convierte la instancia en un clon modificable (copia profunda) del especificado Freezable mediante los valores de propiedad actuales. (Heredado de Freezable)
CoerceValue(DependencyProperty)	Coerce el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier CoerceValueCallback función especificada en metadatos de propiedad para la propiedad de dependencia tal como existe en la llamada DependencyObjecta . (Heredado de DependencyObject)
CreateInstance()	Inicializa una nueva instancia de la clase Freezable. (Heredado de Freezable)
CreateInstanceCore()	Cuando se implementa en una clase derivada, crea una nueva instancia de la Freezable clase derivada. (Heredado de Freezable)
Equals(Object)	Determina si un proporcionado DependencyObject es equivalente al objeto actual DependencyObject. (Heredado de DependencyObject)
Freeze()	Hace que el objeto actual no se pueda modificar y establezca su IsFrozen propiedad trueen . (Heredado de Freezable)
FreezeCore(Boolean)	Hace que el Freezable objeto no se pueda modificar o compruebe si se puede hacer no modificable. (Heredado de Freezable)
GetAsFrozen()	Crea una copia inmovilizada de , Freezablemediante valores de propiedad base (no animados). Dado que la copia está inmovilizada, los sub-objetos congelados se copian por referencia. (Heredado de Freezable)
GetAsFrozenCore(Freezable)	Convierte la instancia en un clon inmovilizado del especificado Freezable mediante valores de propiedad base (no animados). (Heredado de Freezable)
GetCurrentValueAsFrozen()	Crea una copia inmovilizada de mediante los valores de Freezable propiedad actuales. Dado que la copia está inmovilizada, los sub-objetos congelados se copian por referencia. (Heredado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Convierte la instancia actual en un clon inmovilizado del especificado Freezable. Si el objeto tiene propiedades de dependencia animadas, se copian sus valores animados actuales. (Heredado de Freezable)
GetHashCode()	Obtiene un código hash para este DependencyObjectobjeto . (Heredado de DependencyObject)
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia tienen valores establecidos localmente en este DependencyObject. (Heredado de DependencyObject)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de .DependencyObject (Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo de la propiedad de dependencia especificada. (Heredado de DependencyObject)
OnChanged()	Se llama cuando se modifica el objeto actual Freezable . (Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Este miembro admite la infraestructura de Windows Presentation Foundation (WPF) y no está pensada para usarse directamente desde el código. (Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Garantiza que los punteros de contexto adecuados se establecen para un DependencyObjectType miembro de datos que se acaba de establecer. (Heredado de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invalida la DependencyObject implementación de OnPropertyChanged(DependencyPropertyChangedEventArgs) para invocar también los Changed controladores en respuesta a una propiedad de dependencia cambiante de tipo Freezable. (Heredado de Freezable)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si existe. (Heredado de DependencyObject)
ReadPreamble()	Garantiza que Freezable se accede a desde un subproceso válido. Los heredadores de Freezable deben llamar a este método al principio de cualquier API que lea miembros de datos que no sean propiedades de dependencia. (Heredado de Freezable)
SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar su origen de valor. (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia. (Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Establece el valor local de una propiedad de dependencia de solo lectura, especificada por el DependencyPropertyKey identificador de la propiedad de dependencia. (Heredado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia proporcionada. (Heredado de DependencyObject)
VerifyAccess()	Exige que el subproceso de llamada tenga acceso a este DispatcherObject. (Heredado de DispatcherObject)
WritePostscript()	Genera el Changed evento para e Freezable invoca su OnChanged() método . Las clases que derivan de Freezable deben llamar a este método al final de cualquier API que modifique los miembros de clase que no se almacenan como propiedades de dependencia. (Heredado de Freezable)
WritePreamble()	Comprueba que Freezable no está inmovilizado y que se accede a él desde un contexto de subproceso válido. Freezable Los heredares deben llamar a este método al principio de cualquier API que escriba en miembros de datos que no sean propiedades de dependencia. (Heredado de Freezable)

Eventos

Nombre	Description
Changed	Se produce cuando se modifica o Freezable un objeto que contiene. (Heredado de Freezable)
Click	Se produce cuando se hace clic en el botón miniatura.

Consulte también

• TaskbarItemInfo