AttributeCallback デリゲート

更新 : 2007 年 11 月

型の属性が必要な場合に呼び出されます。

名前空間 : Microsoft.Windows.Design.Metadata
アセンブリ : Microsoft.Windows.Design (Microsoft.Windows.Design.dll 内)

構文

'宣言
Public Delegate Sub AttributeCallback ( _
    builder As AttributeCallbackBuilder _
)
'使用
Dim instance As New AttributeCallback(AddressOf HandlerMethod)

public delegate void AttributeCallback(
    AttributeCallbackBuilder builder
)

public delegate void AttributeCallback(
    AttributeCallbackBuilder^ builder
)

JScript では、デリゲートは使用できません。

パラメータ

builder
型 : Microsoft.Windows.Design.Metadata.AttributeCallbackBuilder

属性の追加に使用できる AttributeCallbackBuilder。AttributeCallbackBuilder デリゲートは、メタデータを要求している型に対してのみ属性を作成できます。

解説

大きい属性テーブルを作成する場合は、AttributeCallback デリゲートを使用します。コールバックパターンを使用することにより、デザイナが型のデザイン時メタデータを要求するまで、属性テーブルの作成を延期できます。

例

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