Classe DefaultInitializer

Articolo
09/12/2008

Aggiornamento: novembre 2007

Utilizzato per configurare un nuovo oggetto nella finestra di progettazione.

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

Sintassi

Public MustInherit Class DefaultInitializer _
    Inherits FeatureProvider

Dim instance As DefaultInitializer

public abstract class DefaultInitializer : FeatureProvider

public ref class DefaultInitializer abstract : public FeatureProvider

public abstract class DefaultInitializer extends FeatureProvider

Note

L'estensione dell'oggetto DefaultInitializer viene richiamata quando l'utente aggiunge un oggetto dalla casella degli strumenti all'area di progettazione. Derivare dalla classe DefaultInitializer per configurare i valori iniziali predefiniti per l'oggetto. Ad esempio, è possibile aggiungere un contenuto predefinito a un controllo pulsante o impostare la larghezza e l'altezza di un pannello su un valore costante, in modo che non venga compresso a zero quando viene aggiunto all'area di progettazione. Se creati dalla Casella degli strumenti, i valori della proprietà dell'elemento vengono mostrati nella visualizzazione XAML.

Nota:
Non impostare i valori iniziali predefiniti nel costruttore di un elemento. La finestra di progettazione potrebbe non chiamare il costruttore, pertanto i valori iniziali predefiniti non verrebbero impostati in fase di progettazione. Al contrario, utilizzare la classe DefaultInitializer o il metodo ClearValue per impostare i valori iniziali predefiniti.

Esempi

Nell'esempio di codice seguente viene mostrato come eseguire l'override del metodo InitializeDefaults per impostare il valore predefinito per la proprietà Content di un controllo Button su "Button".

Imports System
Imports Microsoft.Windows.Design.Model
Imports Microsoft.Windows.Design.Features

<Feature(GetType(ButtonDefaults))>  _
Public Class DemoButton
End Class

Class ButtonDefaults
    Inherits DefaultInitializer

    Public Overrides Sub InitializeDefaults(ByVal item As ModelItem) 
        item.Content.SetValue("Button")

    End Sub
End Class

using System;

using Microsoft.Windows.Design.Model;
using Microsoft.Windows.Design.Features;

namespace DemoControlLibrary.VisualStudio.Design
{
    [Feature(typeof(ButtonDefaults))]
    public class DemoButton { }

    class ButtonDefaults : DefaultInitializer
    {
        public override void InitializeDefaults(ModelItem item)
        {
            item.Content.SetValue("Button");
        }
    }
}