RequirementAttribute クラス

RequirementValidator クラスによって使用される属性を定義します。

継承階層

System.Object
  System.Attribute
    Microsoft.Windows.Design.RequirementAttribute
      Microsoft.Windows.Design.Policies.UsesItemPolicyAttribute
      Microsoft.Windows.Design.RequiresContextItemAttribute
      Microsoft.Windows.Design.RequiresServiceAttribute

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

構文

'宣言
Public MustInherit Class RequirementAttribute _
    Inherits Attribute

public abstract class RequirementAttribute : Attribute

public ref class RequirementAttribute abstract : public Attribute

[<AbstractClass>]
type RequirementAttribute =  
    class
        inherit Attribute
    end

public abstract class RequirementAttribute extends Attribute

RequirementAttribute 型で公開されるメンバーは以下のとおりです。

コンストラクター

	名前	説明
	RequirementAttribute	RequirementAttribute クラスの新しいインスタンスを初期化します。

このページのトップへ

プロパティ

	名前	説明
	AllRequired	同じ型のすべての要件属性が必要かどうかを示す値を取得します。
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。 (Attribute から継承されます。)

このページのトップへ

メソッド

	名前	説明
	CreateSubscription	この属性に含まれている要件が変更されたら通知するようにするために使用できる RequirementSubscription オブジェクトを返します。
	Equals	インフラストラクチャ。 このインスタンスが、指定したオブジェクトに等しいかどうかを示す値を返します。 (Attribute から継承されます。)
	Finalize	オブジェクトがガベージ コレクションにより収集される前に、そのオブジェクトがリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetHashCode	対象のインスタンスのハッシュ コードを返します。 (Attribute から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsDefaultAttribute	派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 (Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (Attribute から継承されます。)
	MeetsRequirement	EditingContext がこの属性に指定されている要件を満たしているかどうかを判断します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	ToString	現在のオブジェクトを表す文字列を返します。 (Object から継承されます。)

このページのトップへ

明示的インターフェイスの実装

	名前	説明
	_Attribute.GetIDsOfNames	名前のセットを対応するディスパッチ識別子のセットにマッピングします。 (Attribute から継承されます。)
	_Attribute.GetTypeInfo	オブジェクトの型情報を取得します。この情報はインターフェイスの型情報の取得に使用できます。 (Attribute から継承されます。)
	_Attribute.GetTypeInfoCount	オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。 (Attribute から継承されます。)
	_Attribute.Invoke	オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。 (Attribute から継承されます。)

このページのトップへ

解説

機能プロバイダーや機能コネクタの要件を指定するには、RequirementAttribute 抽象クラスから派生させます。

RequirementValidator は、RequirementAttribute 属性の型を調べます。 見つかった RequirementAttribute ごとに、MeetsRequirement 抽象メソッドを呼び出し、EditingContext クラスのインスタンスを渡します。 RequiresServiceAttribute などのクラスは RequirementAttribute から派生したもので、指定された要件の存在についてコンテキストを確認します。

このシステムにより、デザイナーは編集中のコンテキストで正常に実行されるコードのみをアクティブにできます。

カスタム要件を定義するには、RequirementAttribute を派生させ、MeetsRequirement 抽象メソッドを実装します。

例

RequirementAttribute の派生である UsesItemPolicyAttribute を使用して、カスタム サロゲート ポリシーを機能プロバイダーにアタッチする方法を次のコード例に示します。 コード全体については、「方法 : サロゲート ポリシーを作成する」を参照してください。

' The DockPanelAdornerProvider class implements an adorner
' that you can use to set the Margin property by using a 
' drag operation. The DockPanelPolicy class enables a 
' container policy for offering additional tasks and 
' adorners on the panel's children.
<UsesItemPolicy(GetType(DockPanelPolicy))>  _
Class DockPanelAdornerProvider
    Inherits AdornerProvider

    Public Sub New() 
        ' The adorner is a Rectangle element.
        Dim r As New Rectangle()
        r.Width = 23.0
        r.Height = 23.0
        r.Fill = AdornerColors.GlyphFillBrush

        ' Set the rectangle's placement in the adorner panel.
        AdornerPanel.SetAdornerHorizontalAlignment(r, AdornerHorizontalAlignment.OutsideLeft)
        AdornerPanel.SetAdornerVerticalAlignment(r, AdornerVerticalAlignment.OutsideTop)

        Dim p As New AdornerPanel()
        p.Children.Add(r)

        AdornerPanel.SetTask(r, New DockPanelMarginTask())

        Adorners.Add(p)
    End Sub
End Class

// The DockPanelAdornerProvider class implements an adorner
// that you can use to set the Margin property by using a 
// drag operation. The DockPanelPolicy class enables a 
// container policy for offering additional tasks and 
// adorners on the panel's children.
[UsesItemPolicy(typeof(DockPanelPolicy))]
class DockPanelAdornerProvider : AdornerProvider
{
    public DockPanelAdornerProvider() 
    {
        // The adorner is a Rectangle element.
        Rectangle r = new Rectangle();
        r.Width = 23.0;
        r.Height = 23.0;
        r.Fill = AdornerColors.GlyphFillBrush;

        // Set the rectangle's placement in the adorner panel.
        AdornerPanel.SetAdornerHorizontalAlignment(r, AdornerHorizontalAlignment.OutsideLeft);
        AdornerPanel.SetAdornerVerticalAlignment(r, AdornerVerticalAlignment.OutsideTop);

        AdornerPanel p = new AdornerPanel();
        p.Children.Add(r);

        AdornerPanel.SetTask(r, new DockPanelMarginTask());

        Adorners.Add(p);
    }
} 

スレッド セーフ

この型のすべてのパブリック static (Visual Basic では Shared) メンバーは、スレッド セーフです。 インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

参照

参照

Microsoft.Windows.Design 名前空間

RequiresContextItemAttribute

RequiresServiceAttribute

UsesItemPolicyAttribute

その他の技術情報

方法 : サロゲート ポリシーを作成する

WPF デザイナーの機能拡張について