Compartir a través de

ThumbButtonInfo (Clase)

Representa información sobre el modo en que se muestra un botón en la miniatura de la barra de tareas de Windows 7.

Jerarquía de herencia

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

Espacio de nombres:  Microsoft.Windows.Shell
Ensamblado:  Microsoft.Windows.Shell (en Microsoft.Windows.Shell.dll)

Sintaxis

'Declaración
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

El tipo ThumbButtonInfo expone los siguientes miembros.

Constructores

  Nombre Descripción
Método público ThumbButtonInfo Inicializa una nueva instancia de la clase ThumbButtonInfo.

Arriba

Propiedades

  Nombre Descripción
Propiedad pública CanFreeze Obtiene un valor que indica si el objeto se puede convertir en no modificable. (Se hereda de Freezable).
Propiedad pública Command Obtiene o establece el comando que se invoca cuando se hace clic en este botón de miniatura.
Propiedad pública CommandParameter Obtiene o establece el parámetro que se va a pasar a la propiedad Command.
Propiedad pública CommandTarget Obtiene o establece el elemento en el que se produce el comando especificado.
Propiedad pública DependencyObjectType Obtiene el objeto DependencyObjectType que ajusta el tipo CLR de esta instancia.  (Se hereda de DependencyObject).
Propiedad pública Description Obtiene o establece el texto que aparece en la información sobre herramientas del botón de miniatura.
Propiedad pública 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 de miniatura.
Propiedad pública Dispatcher Obtiene el objeto Dispatcher al que está asociado DispatcherObject. (Se hereda de DispatcherObject).
Propiedad pública ImageSource Obtiene o establece la imagen que aparece en el botón de miniatura.
Propiedad pública IsBackgroundVisible Obtiene o establece un valor que indica si alrededor del botón de miniatura aparece un borde y un efecto de resaltado.
Propiedad pública IsEnabled Obtiene o establece un valor que indica si el botón de miniatura está habilitado.
Propiedad pública IsFrozen Obtiene un valor que indica si el objeto es modificable actualmente. (Se hereda de Freezable).
Propiedad pública IsInteractive Obtiene o establece un valor que indica si el usuario puede interactuar con el botón de miniatura.
Propiedad pública IsSealed Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura). (Se hereda de DependencyObject).
Propiedad pública Visibility Obtiene o establece un valor que especifica el estado de vista del botón de miniatura.

Arriba

Métodos

  Nombre Descripción
Método público CheckAccess Determina si el subproceso de la llamada tiene acceso a DispatcherObject. (Se hereda de DispatcherObject).
Método público ClearValue(DependencyProperty) Borra el valor local de una propiedad.La propiedad que se va a borrar se especifica mediante un identificador de DependencyProperty. (Se hereda de DependencyObject).
Método público ClearValue(DependencyPropertyKey) Borra el valor local de una propiedad de sólo lectura.DependencyPropertyKey especifica la propiedad que se va a borrar. (Se hereda de DependencyObject).
Método público Clone Crea un clon modificable del objeto Freezable y hace copias en profundidad de sus valores.Al copiar las propiedades de dependencia del objeto, este método copia las expresiones (que puede que ya no se resuelvan) pero no las animaciones ni sus valores actuales. (Se hereda de Freezable).
Método protegido CloneCore Convierte la instancia en un clon (copia en profundidad) de la clase Freezable especificada con los valores de la propiedad base (no animada). (Se hereda de Freezable).
Método público CloneCurrentValue Crea un clon modificable (copia en profundidad) de Freezable con sus valores actuales. (Se hereda de Freezable).
Método protegido CloneCurrentValueCore Convierte la instancia en un clon modificable (en profundidad) del objeto Freezable especificado utilizando los valores de las propiedades actuales. (Se hereda de Freezable).
Método público CoerceValue Convierte el valor de la propiedad de dependencia especificada.Esto se logra invocando cualquier función de CoerceValueCallback especificada en los metadatos de la propiedad de dependencia cuando existe en el objeto DependencyObject de llamada. (Se hereda de DependencyObject).
Método protegido CreateInstance Inicializa una nueva instancia de la clase Freezable. (Se hereda de Freezable).
Método protegido CreateInstanceCore Cuando se implementa en una clase derivada, crea una nueva instancia de la clase Freezable derivada. (Se hereda de Freezable).
Método público Equals Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual. (Se hereda de DependencyObject).
Método protegido Finalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método público Freeze Convierte el objeto actual en no modificable y establece su propiedad IsFrozen en true. (Se hereda de Freezable).
Método protegido FreezeCore Convierte el objeto Freezable en no modificable o prueba si se puede convertir en no modificable. (Se hereda de Freezable).
Método público GetAsFrozen Crea una copia inmovilizada de Freezable, con los valores de la propiedad base (no animada).Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia. (Se hereda de Freezable).
Método protegido GetAsFrozenCore Convierte la instancia en un clon inmovilizado de la clase Freezable especificada con los valores de la propiedad base (no animada). (Se hereda de Freezable).
Método público GetCurrentValueAsFrozen Crea una copia inmovilizada de Freezable con los valores de propiedad actuales.Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia. (Se hereda de Freezable).
Método protegido GetCurrentValueAsFrozenCore Convierte la instancia actual en un clon inmovilizado de la clase Freezable especificada.Si el objeto tiene propiedades de dependencia animadas, se copian sus valores animados actuales. (Se hereda de Freezable).
Método público GetHashCode Obtiene un código hash de este objeto DependencyObject. (Se hereda de DependencyObject).
Método público GetLocalValueEnumerator Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject. (Se hereda de DependencyObject).
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método público GetValue Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de DependencyObject. (Se hereda de DependencyObject).
Método público InvalidateProperty Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Se hereda de DependencyObject).
Método protegido MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método protegido OnChanged Se llama cuando se modifica el objeto Freezable actual. (Se hereda de Freezable).
Método protegido OnFreezablePropertyChanged(DependencyObject, DependencyObject) Se asegura de que se establecen los punteros contextuales adecuados para un miembro de datos DependencyObjectType que se acaba de establecer. (Se hereda de Freezable).
Método protegido OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) Este miembro admite la infraestructura de Windows Presentation Foundation (WPF) y no se debe usar directamente desde el código. (Se hereda de Freezable).
Método protegido OnPropertyChanged Invalida la implementación de DependencyObject de OnPropertyChanged para invocar también cualquier controlador Changed como respuesta a un cambio de propiedad de dependencia de tipo Freezable. (Se hereda de Freezable).
Método público ReadLocalValue Devuelve el valor local de una propiedad de dependencia, si existe. (Se hereda de DependencyObject).
Método protegido ReadPreamble Se asegura de que se tiene acceso a Freezable desde un subproceso válido.Los herederos de Freezable deben llamar a este método al inicio de las API que lean miembros de datos que no son propiedades de dependencia. (Se hereda de Freezable).
Método público SetValue(DependencyProperty, Object) Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia. (Se hereda de DependencyObject).
Método público SetValue(DependencyPropertyKey, Object) Establece el valor local de una propiedad de dependencia de sólo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia. (Se hereda de DependencyObject).
Método protegido ShouldSerializeProperty Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia proporcionada. (Se hereda de DependencyObject).
Método público ToString Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
Método público VerifyAccess Exige que el subproceso de la llamada tenga acceso a DispatcherObject. (Se hereda de DispatcherObject).
Método protegido WritePostscript Provoca el evento Changed de Freezable e invoca su método OnChanged.Las clases que se derivan de Freezable deben llamar a este método al final de cualquier API que modifique miembros de clase que no se almacenen como propiedades de dependencia. (Se hereda de Freezable).
Método protegido WritePreamble Comprueba que no se inmovilice Freezable y que se tiene acceso desde un contexto de subproceso válido.Los herederos de Freezable deben llamar a este método al inicio de cualquier API que escriba en miembros de datos que no sean propiedades de dependencia. (Se hereda de Freezable).

Arriba

Eventos

  Nombre Descripción
Evento público Changed Se produce cuando se modifican la clase Freezable o un objeto que la contiene. (Se hereda de Freezable).
Evento público Click Se produce cuando se hace clic en el botón de miniatura.

Arriba

Campos

  Nombre Descripción
Campo públicoMiembro estático CommandParameterProperty Identifica la propiedad de dependencia CommandParameter.
Campo públicoMiembro estático CommandProperty Identifica la propiedad de dependencia Command.
Campo públicoMiembro estático CommandTargetProperty Identifica la propiedad de dependencia CommandTarget.
Campo públicoMiembro estático DescriptionProperty Identifica la propiedad de dependencia Description.
Campo públicoMiembro estático DismissWhenClickedProperty Identifica la propiedad de dependencia DismissWhenClicked.
Campo públicoMiembro estático ImageSourceProperty Identifica la propiedad de dependencia ImageSource.
Campo públicoMiembro estático IsBackgroundVisibleProperty Identifica la propiedad de dependencia IsBackgroundVisible.
Campo públicoMiembro estático IsEnabledProperty Identifica la propiedad de dependencia IsEnabled.
Campo públicoMiembro estático IsInteractiveProperty Identifica la propiedad de dependencia IsInteractive.
Campo públicoMiembro estático VisibilityProperty Identifica la propiedad de dependencia Visibility.

Arriba

Comentarios

La barra de tareas Windows 7 proporciona funcionalidad mejorada que le permite usar el botón de la barra de tareas para comunicar su estado a un usuario, así como exponer las tareas comunes cuando la ventana se minimiza u oculta. Puede agregar botones a la miniatura de la barra de tareas para proporcionar acceso a tareas comunes sin necesidad de cambiar a la ventana de la aplicación. Por ejemplo, el Reproductor de Windows Media proporciona los botones Reproducir, Pausa, Adelante y Atrás que puede usar para controlar la reproducción de multimedia desde la barra de tareas en miniatura cuando se minimiza la aplicación.

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

La funcionalidad de la barra de tareas mejorada no está disponible en versiones de Windows anteriores a Windows 7. En Windows 7, puede que alguna funcionalidad no esté disponible dependiendo de los valores del usuario. Por ejemplo, los botones solo se muestran en la barra de tareas en miniatura cuando Windows Aero está habilitado. La aplicación debería proporcionar maneras alternativas de interactuar con el usuario que no dependan de la funcionalidad de la barra de tareas mejorada.

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

Botones miniatura de la barra de tareas de Windows

Ejemplo de información de elemento de barra de tareas

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también

Referencia

Microsoft.Windows.Shell (Espacio de nombres)

TaskbarItemInfo

  • Last updated on