DefaultInitializer-Klasse

Artikel
08/10/2011

Wird zum Konfigurieren eines neuen Objekts im Designer verwendet.

Vererbungshierarchie

System.Object
Microsoft.Windows.Design.Features.FeatureProvider
Microsoft.Windows.Design.Model.DefaultInitializer

Namespace: Microsoft.Windows.Design.Model
Assembly: Microsoft.Windows.Design.Interaction (in Microsoft.Windows.Design.Interaction.dll)

Syntax

'Declaration
Public MustInherit Class DefaultInitializer _
    Inherits FeatureProvider

public abstract class DefaultInitializer : FeatureProvider

public ref class DefaultInitializer abstract : public FeatureProvider

[<AbstractClass>]
type DefaultInitializer =  
    class
        inherit FeatureProvider
    end

public abstract class DefaultInitializer extends FeatureProvider

Der DefaultInitializer-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	DefaultInitializer	Initialisiert eine neue Instanz der DefaultInitializer-Klasse.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Equals	Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	InitializeDefaults(ModelItem)	Initialisiert Standardwerte für das angegebene Element.
	InitializeDefaults(ModelItem, EditingContext)	Initialisiert mit dem bereitgestellten Bearbeitungskontext Standardwerte für das angegebene Element.
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Hinweise

Die DefaultInitializer-Erweiterung wird aufgerufen, wenn der Benutzer der Entwurfsoberfläche ein Objekt aus der Toolbox hinzufügt. Leiten Sie von der DefaultInitializer-Klasse ab, um Standardanfangswerte für das Objekt zu konfigurieren. So können Sie zum Beispiel einem Schaltflächensteuerelement Standardinhalt hinzufügen oder für einen Bereich konstante Werte für die Breite und Höhe festlegen, damit er beim Hinzufügen zur Entwurfsoberfläche nicht auf 0 (null) reduziert wird. Wenn für die Erstellung die Toolbox verwendet wurde, werden die Eigenschaftswerte des Elements in der XAML-Ansicht angezeigt.

Tipp

Legen Sie im Konstruktor eines Elements keine Standardanfangswerte fest. Möglicherweise ruft der Designer den Konstruktor nicht auf, sodass die Standardanfangswerte zur Entwurfszeit nicht festgelegt werden. Legen Sie stattdessen die Standardanfangswerte mit der DefaultInitializer-Klasse oder der ClearValue-Methode fest.

Beispiele

Im folgenden Codebeispiel wird dargestellt, wie die InitializeDefaults-Methode so überschrieben wird, dass der Standardwert für die Content-Eigenschaft eines Button-Steuerelements auf "Button" festgelegt wird.

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");
        }
    }
}

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.