ContextItem (Clase)

Artículo
08/10/2011

Representa un único fragmento de estado en el diseñador.

Jerarquía de herencia

System.Object
  Microsoft.Windows.Design.ContextItem
    Microsoft.Windows.Design.AssemblyReferences
    Microsoft.Windows.Design.Interaction.CurrentDesignerView
    Microsoft.Windows.Design.Interaction.FocusedTask
    Microsoft.Windows.Design.Interaction.Selection
    Microsoft.Windows.Design.Interaction.Tool

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

Sintaxis

'Declaración
Public MustInherit Class ContextItem

public abstract class ContextItem

public ref class ContextItem abstract

[<AbstractClass>]
type ContextItem =  class end

public abstract class ContextItem

El tipo ContextItem expone los siguientes miembros.

Constructores

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

Arriba

Propiedades

	Nombre	Descripción
	ItemType	Cuando se invalida en una clase derivada, obtiene el tipo de elemento para este elemento de contexto de edición.

Arriba

Métodos

	Nombre	Descripción
	Equals	Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
	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).
	GetHashCode	Actúa como función hash para un tipo concreto. (Se hereda de Object).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	MemberwiseClone	Crea una copia superficial del objeto Object actual. (Se hereda de Object).
	OnItemChanged	Se invoca en un elemento de contexto antes de que se almacene en el administrador de elementos de contexto.
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).

Arriba

Comentarios

Los elementos de contexto son objetos inmutables que contienen el estado. Algunos elementos de contexto también definen métodos, que pueden realizar operaciones en el estado que contienen. ContextItem es la clase base de la que deben derivarse todos los elementos de contexto.

Un elemento de contexto puede ir y venir en un contexto de edición. Los elementos de contexto son transitorios, pero siempre tienen un valor. Aunque un elemento de contexto determinado no esté en el contexto, siempre se proporciona un valor predeterminado. Por consiguiente, el contexto nunca devuelve nullreferencia null (Nothing en Visual Basic).

A diferencia de lo que ocurre en un servicio, el valor de un elemento de contexto puede cambiar en cualquier momento. Esto significa que no debe almacenar en memoria caché los elementos de contexto. El código que utiliza el contexto puede suscribirse a SubscribeContextCallback<TContextItemType> que se genera cuando cambia un tipo determinado de elemento de contexto.

Una clase derivada de ContextItem debe definir un constructor vacío. Esta versión de constructor vacío de un elemento de contexto representa su valor predeterminado. Este valor predeterminado es el valor que devuelve GetValue si ContextItemManager no contiene ningún elemento de contexto del tipo solicitado.

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.