AttributeCallback デリゲート

[アーティクル]
08/09/2011

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

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

構文

'宣言
Public Delegate Sub AttributeCallback ( _
    builder As AttributeCallbackBuilder _
)

public delegate void AttributeCallback(
    AttributeCallbackBuilder builder
)

public delegate void AttributeCallback(
    AttributeCallbackBuilder^ builder
)

type AttributeCallback = 
    delegate of 
        builder:AttributeCallbackBuilder -> unit

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;

// The ProvideMetadata assembly-level attribute indicates to designers
// that this assembly contains a class that provides an attribute table. 
[assembly: ProvideMetadata(typeof(CustomControlLibrary.VisualStudio.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 IProvideAttributeTable. If found, designers instantiate 
    // this class and access its AttributeTable property automatically.
    internal class Metadata : IProvideAttributeTable
    {
        // Accessed by the designer to register any design-time metadata.
        public AttributeTable AttributeTable
        {
            get
            {
                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));
                    });

                return builder.CreateTable();
            }
        }
    }
}