AttributeCallbackBuilder, classe
Mise à jour : novembre 2007
Une instance de cette classe est passée aux délégués de rappel pour remplir progressivement les attributs d'un type.
Espace de noms : Microsoft.Windows.Design.Metadata
Assembly : Microsoft.Windows.Design (dans Microsoft.Windows.Design.dll)
Syntaxe
Public NotInheritable Class AttributeCallbackBuilder
Dim instance As AttributeCallbackBuilder
public sealed class AttributeCallbackBuilder
public ref class AttributeCallbackBuilder sealed
public final class AttributeCallbackBuilder
Notes
Utilisez AttributeCallbackBuilder pour remplir un AttributeTable à la demande. C'est particulièrement important pour les tables d'attributs qui contiennent de nombreux attributs. Si vous ne spécifiez que quelques attributs pour un type, utilisez AttributeTableBuilder par lui-même.
Avec le format de délégué, aucun attribut n'est construit tant que le concepteur n'a pas demandé de métadonnées pour le type de cible. Le AttributeTableBuilder transfère cette information de rappel dans le AttributeTable et la conserve. Par conséquent, ces délégués de rappel sont appelés uniquement à la demande. Une fois appelés, leurs résultats sont mis en cache par le AttributeTable.
Activez la création d'attribut à la demande à l'aide de la méthode AddCallback.
Exemples
L'exemple de code suivant indique comment créer et remplir une table d'attributs à l'aide de la classe AttributeCallbackBuilder.
using System;
using System.Collections;
using System.Collections.Generic;
using System.Text;
using System.ComponentModel;
using System.Reflection;
using System.Windows.Media;
using System.Windows.Controls;
using System.Windows;
using Microsoft.Windows.Design.Features;
using Microsoft.Windows.Design.Metadata;
namespace CustomControlLibrary.VisualStudio.Design
{
// Container for any general design-time metadata to initialize.
// Designers look for a type in the design-time assembly that
// implements IRegisterMetadata. If found, designers instantiate
// this class and call its Register() method automatically.
internal class Metadata : IRegisterMetadata
{
// Called by the designer to register any design-time metadata.
public void Register()
{
AttributeTableBuilder builder = new AttributeTableBuilder();
// Build the attribute table by using the AttributeCallbackBuilder
// class. The attribute table is not populated until the designer
// needs it, which is more efficient for large attribute tables.
builder.AddCallback(
typeof(Button),
delegate(AttributeCallbackBuilder callbackBuilder)
{
callbackBuilder.AddCustomAttributes(
new DefaultPropertyAttribute("Content"));
// Apply the ReadOnlyAttribute to the Background property
// of the Button class.
callbackBuilder.AddCustomAttributes(
"Background",
new ReadOnlyAttribute(true));
PropertyDescriptorCollection properties =
TypeDescriptor.GetProperties(typeof(Button));
PropertyDescriptor pd = properties["Foreground"];
callbackBuilder.AddCustomAttributes(
pd,
new ReadOnlyAttribute(true));
callbackBuilder.AddCustomAttributes(
Button.WidthProperty,
new TypeConverterAttribute(typeof(LengthConverter)),
new DescriptionAttribute("This is the width"));
MemberInfo[] members = typeof(Button).GetMember("Height");
callbackBuilder.AddCustomAttributes(
members[0],
new ReadOnlyAttribute(true));
});
MetadataStore.AddAttributeTable(builder.CreateTable());
}
}
}
Hiérarchie d'héritage
System.Object
Microsoft.Windows.Design.Metadata.AttributeCallbackBuilder
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.
Voir aussi
Référence
Membres AttributeCallbackBuilder
Microsoft.Windows.Design.Metadata, espace de noms
Autres ressources
Procédure pas à pas : création d'un ornement au moment du design