TaskbarItemInfo (Clase)

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

Jerarquía de herencia

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

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

Sintaxis

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

El tipo TaskbarItemInfo expone los siguientes miembros.

Constructores

	Nombre	Descripción
	TaskbarItemInfo	Inicializa una nueva instancia de la clase TaskbarItemInfo.

Arriba

Propiedades

	Nombre	Descripción
	CanFreeze	Obtiene un valor que indica si el objeto se puede convertir en no modificable. (Se hereda de Freezable).
	DependencyObjectType	Obtiene el objeto DependencyObjectType que ajusta el tipo CLR de esta instancia.  (Se hereda de DependencyObject).
	Description	Obtiene o establece el texto de la información sobre herramientas del elemento de la barra de tareas.
	Dispatcher	Obtiene el objeto Dispatcher al que está asociado DispatcherObject. (Se hereda de DispatcherObject).
	IsFrozen	Obtiene un valor que indica si el objeto es modificable actualmente. (Se hereda de Freezable).
	IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura). (Se hereda de DependencyObject).
	Overlay	Obtiene o establece la imagen que aparece sobre el icono de programa en el botón de la barra de tareas.
	ProgressState	Obtiene o establece un valor que especifica el modo en que el indicador de progreso se muestra en el botón de la barra de tareas.
	ProgressValue	Obtiene o establece un valor que indica el llenado del indicador de progreso del botón de la barra de tareas.
	ThumbButtonInfos	Obtiene o establece la colección de objetos ThumbButtonInfo asociados a Window.
	ThumbnailClipMargin	Obtiene o establece un valor que especifica la parte del área de cliente de la ventana de la aplicación que aparece en la miniatura de la barra de tareas.

Arriba

Propiedades asociadas

	Nombre	Descripción
	TaskbarItemInfo	Obtiene o establece TaskbarItemInfo que se adjunta a una ventana.

Arriba

Métodos

	Nombre	Descripción
	CheckAccess	Determina si el subproceso de la llamada tiene acceso a DispatcherObject. (Se hereda de DispatcherObject).
	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).
	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).
	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).
	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).
	CloneCurrentValue	Crea un clon modificable (copia en profundidad) de Freezable con sus valores actuales. (Se hereda de Freezable).
	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).
	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).
	CreateInstance	Inicializa una nueva instancia de la clase Freezable. (Se hereda de Freezable).
	CreateInstanceCore	Cuando se implementa en una clase derivada, crea una nueva instancia de la clase Freezable derivada. (Se hereda de Freezable).
	Equals	Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual. (Se hereda de DependencyObject).
	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).
	Freeze	Convierte el objeto actual en no modificable y establece su propiedad IsFrozen en true. (Se hereda de Freezable).
	FreezeCore	Convierte el objeto Freezable en no modificable o prueba si se puede convertir en no modificable. (Se hereda de Freezable).
	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).
	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).
	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).
	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).
	GetHashCode	Obtiene un código hash de este objeto DependencyObject. (Se hereda de DependencyObject).
	GetLocalValueEnumerator	Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject. (Se hereda de DependencyObject).
	GetTaskbarItemInfo	Obtiene el valor de la propiedad adjunta TaskbarItemInfo de un objeto.
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	GetValue	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de DependencyObject. (Se hereda de DependencyObject).
	InvalidateProperty	Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Se hereda de DependencyObject).
	MemberwiseClone	Crea una copia superficial del objeto Object actual. (Se hereda de Object).
	OnChanged	Se llama cuando se modifica el objeto Freezable actual. (Se hereda de Freezable).
	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).
	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).
	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).
	ReadLocalValue	Devuelve el valor local de una propiedad de dependencia, si existe. (Se hereda de DependencyObject).
	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).
	SetTaskbarItemInfo	Establece el valor de la propiedad adjunta TaskbarItemInfo de un objeto.
	SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia. (Se hereda de DependencyObject).
	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).
	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).
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
	VerifyAccess	Exige que el subproceso de la llamada tenga acceso a DispatcherObject. (Se hereda de DispatcherObject).
	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).
	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
	Changed	Se produce cuando se modifican la clase Freezable o un objeto que la contiene. (Se hereda de Freezable).

Arriba

Campos

	Nombre	Descripción
	DescriptionProperty	Identifica la propiedad de dependencia Description.
	OverlayProperty	Identifica la propiedad de dependencia Overlay.
	ProgressStateProperty	Identifica la propiedad de dependencia ProgressState.
	ProgressValueProperty	Identifica la propiedad de dependencia ProgressValue.
	TaskbarItemInfoProperty	Identifica la propiedad de dependencia TaskbarItemInfo.
	ThumbButtonInfosProperty	Identifica la propiedad de dependencia ThumbButtonInfos.
	ThumbnailClipMarginProperty	Identifica la propiedad de dependencia ThumbnailClipMargin.

Arriba

Comentarios

La clase TaskbarItemInfo proporciona un contenedor administrado para la funcionalidad de barra de tareas Windows 7. Para obtener más información sobre el uso del shell de Windows y API de barra de tareas nativas, vea Taskbar Extensions.

La barra de tareas Windows 7 proporciona funcionalidad mejorada que le permite usar el elemento 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. La funcionalidad que expone la clase TaskbarItemInfo no está disponible en versiones de Windows anteriores a Windows 7. Las aplicaciones que usan la clase TaskbarItemInfo todavía se pueden ejecutar en versiones de Windows anteriores; sin embargo, estas mejoras de la barra de tareas no están disponibles en las versiones anteriores.

En Windows 7, puede que algunas funciones de la barra de tareas no estén disponibles, dependiendo de la configuración del usuario. Por ejemplo, la funcionalidad de la barra de tareas no está disponible si Windows Aero está deshabilitado o si la aplicación se inicia con permisos elevados. La aplicación debería proporcionar otras maneras para interactuar con el usuario que no dependan de la funcionalidad de la barra de tareas mejorada en Windows 7.

Los iconos de programa en el área de notificación, que se encuentra en el extremo derecho de la barra de tareas, se usan normalmente para comunicar el estado de la aplicación a un usuario. De forma predeterminada, la barra de tareas de Windows 7 oculta los iconos de programa en el área de notificación. Sin embargo, puede establecer la propiedad Overlay para agregar una imagen al botón de la barra de tareas para comunicar el estado, como el estado de conexión en una aplicación de mensajería. La imagen de superposición permite a los usuarios ver el estado de la aplicación incluso cuando no pueden ver el icono de programa en el área de notificación. También puede mostrar el progreso de las tareas en ejecución en el botón de la barra de tareas estableciendo las propiedades ProgressValue y ProgressState.

La barra de tareas Windows 7 muestra una miniatura de la aplicación cuando se mueve el puntero del mouse sobre el botón de la barra de tareas. De manera predeterminada, se muestra toda la ventana de la aplicación. Puede especificar una parte concreta de la ventana para mostrar en la miniatura estableciendo la propiedad ThumbnailClipMargin. También puede especificar Description que se muestra en la información sobre herramientas sobre la miniatura de la barra de tareas. La información sobre herramientas se muestra incluso cuando la miniatura no se puede ver debido a la configuración del usuario.

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 le permiten controlar la reproducción de multimedia desde la barra de tareas en miniatura cuando se minimiza la aplicación. Los objetos ThumbButtonInfo representan los botones la miniatura de la barra de tareas y se contienen en la colección ThumbButtonInfos.

En la ilustración siguiente se muestra las características mejoradas de la barra de tareas de Windows 7.

Características mejoradas de la barra de tareas de Windows

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)