Classe ContextItem

Articolo
08/11/2011

Rappresenta un singolo stato nella finestra di progettazione.

Gerarchia di ereditarietà

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

Spazio dei nomi: Microsoft.Windows.Design
Assembly: Microsoft.Windows.Design.Extensibility (in Microsoft.Windows.Design.Extensibility.dll)

Sintassi

'Dichiarazione
Public MustInherit Class ContextItem

public abstract class ContextItem

public ref class ContextItem abstract

[<AbstractClass>]
type ContextItem =  class end

public abstract class ContextItem

Il tipo ContextItem espone i seguenti membri.

Costruttori

	Nome	Descrizione
	ContextItem	Inizializza una nuova istanza della classe ContextItem.

In alto

Proprietà

	Nome	Descrizione
	ItemType	Quando viene sottoposto a override in una classe derivata, ottiene un tipo di elemento per questo elemento di contesto di modifica.

In alto

Metodi

	Nome	Descrizione
	Equals	Determina se l'oggetto Object specificato è uguale all'oggetto Object corrente. (Ereditato da Object)
	Finalize	Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (Ereditato da Object)
	GetHashCode	Funge da funzione hash per un determinato tipo. (Ereditato da Object)
	GetType	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
	MemberwiseClone	Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
	OnItemChanged	Chiamato su un elemento di contesto prima di essere archiviato nel gestore di elementi di contesto.
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Note

Gli elementi di contesto sono oggetti non modificabili che contengono uno stato. Alcuni elementi di contesto inoltre definiscono metodi, che possono eseguire operazioni sullo stato che contengono. ContextItem è la classe di base da cui devono derivare tutti gli elementi di contesto.

Un elemento di contesto può entrare e uscire da un contesto di modifica. Gli elementi di contesto sono temporanei, ma hanno sempre un valore. Anche se un determinato elemento di contesto non si trova nel contesto, viene sempre fornito un valore predefinito. Pertanto, il contesto non restituisce mai nullriferimento null (Nothing in Visual Basic).

A differenza di un servizio, il valore di un elemento di contesto può cambiare in qualsiasi momento. Questo significa che gli elementi di contesto non devono essere memorizzati nella cache. Il codice che utilizza il contesto può sottoscrivere un oggetto SubscribeContextCallback<TContextItemType> che viene generato quando un determinato tipo di elemento di contesto viene modificato.

Una classe derivata da ContextItem deve definire un costruttore vuoto. Questa versione di un elemento di contesto di tipo costruttore vuoto rappresenta il valore predefinito. Questo valore predefinito rappresenta il valore restituito da GetValue se ContextItemManager non contiene un elemento di contesto del tipo richiesto.