DefaultInitializer-Klasse

Článek
08/23/2008

Aktualisiert: November 2007

Wird zum Konfigurieren eines neuen Objekts im Designer verwendet.

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

Syntax

'Declaration
Public MustInherit Class DefaultInitializer _
    Inherits FeatureProvider
'Usage
Dim instance As DefaultInitializer

public abstract class DefaultInitializer : FeatureProvider

public ref class DefaultInitializer abstract : public FeatureProvider

public abstract class DefaultInitializer extends FeatureProvider

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 Eigenschaftenwerte des Elements in der XAML-Ansicht angezeigt.

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

Vererbungshierarchie

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

Threadsicherheit

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