DefaultInitializer, classe

Mise à jour : novembre 2007

Utilisé pour configurer un nouvel objet dans le concepteur.

Espace de noms : Microsoft.Windows.Design.Model
Assembly : Microsoft.Windows.Design.Extensibility (dans Microsoft.Windows.Design.Extensibility.dll)

Syntaxe

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

Notes

L'extension DefaultInitializer est appelée lorsque l'utilisateur ajoute un objet de la boîte à outils sur l'aire de conception. Dérivez de la classe DefaultInitializer pour configurer des valeurs initiales par défaut pour votre objet. Par exemple, vous pouvez ajouter du contenu par défaut à un contrôle bouton ou affecter une valeur constante à la largeur et à la hauteur d'un panneau, afin qu'il ne se réduise pas à une taille nulle lorsqu'il est ajouté à l'aire de conception. En cas de création à partir de la boîte à outils, les valeurs de propriété de l'élément apparaissent en mode XAML.

Remarque :
Ne définissez pas de valeurs initiales par défaut dans le constructeur d'un élément. Le concepteur risque de ne pas pouvoir votre constructeur, auquel cas vos valeurs initiales par défaut ne sont pas définies au moment du design. En lieu et place, utilisez la classe DefaultInitializer ou la méthode ClearValue pour définir des valeurs initiales par défaut.

Exemples

L'exemple de code suivant indique comment substituer la méthode InitializeDefaults pour définir la valeur par défaut "Button" pour la propriété Content d'un contrôle 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");
        }
    }
}

Hiérarchie d'héritage

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

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.