PrimarySelectionPolicy クラス

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

主要選択要素を指定するポリシーです。

継承階層

System.Object
  Microsoft.Windows.Design.Policies.ItemPolicy
    Microsoft.Windows.Design.Policies.SelectionPolicy
      Microsoft.Windows.Design.Policies.PrimarySelectionPolicy

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

構文

'宣言
Public Class PrimarySelectionPolicy _
    Inherits SelectionPolicy

public class PrimarySelectionPolicy : SelectionPolicy

public ref class PrimarySelectionPolicy : public SelectionPolicy

type PrimarySelectionPolicy =  
    class
        inherit SelectionPolicy
    end

public class PrimarySelectionPolicy extends SelectionPolicy

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

コンストラクター

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

このページのトップへ

プロパティ

	名前	説明
	Context	デザイナーの編集コンテキストを取得します。 (ItemPolicy から継承されます。)
	IsSurrogate	ポリシーがサロゲートポリシーであるかどうかを示す値を取得します。 (ItemPolicy から継承されます。)
	PolicyItems	このポリシーによって影響を受けるアイテムの列挙体を取得します。 (SelectionPolicy から継承されます。)

このページのトップへ

メソッド

	名前	説明
	Equals	指定した Object が、現在の Object と等しいかどうかを判断します。 (Object から継承されます。)
	Finalize	オブジェクトがガベージコレクションにより収集される前に、そのオブジェクトがリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。 (Object から継承されます。)
	GetPolicyItems	主要選択を表すポリシーアイテムを返します。 (SelectionPolicy.GetPolicyItems(Selection) をオーバーライドします。)
	GetSurrogateItems	このアイテムに対するオプションのサロゲートアイテムのセットを返します。 (ItemPolicy から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsInPolicy	指定したアイテムがポリシーに含まれるかどうかを示す値を取得します。 (SelectionPolicy から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnActivated	このポリシーがアクティブになったときに呼び出されます。 (SelectionPolicy から継承されます。)
	OnDeactivated	このポリシーが非アクティブになったときに呼び出されます。 (SelectionPolicy から継承されます。)
	OnPolicyItemsChanged	PolicyItemsChanged イベントを発生させます。 (ItemPolicy から継承されます。)
	ToString	現在のオブジェクトを表す文字列を返します。 (Object から継承されます。)

このページのトップへ

イベント

	名前	説明
	PolicyItemsChanged	ポリシーが変更されると発生します。 (ItemPolicy から継承されます。)

このページのトップへ

解説

PrimarySelectionPolicy クラスは、SelectionTool がアクティブなツールである場合に、主要選択の要素に対して有効になる ItemPolicy です。

例

主要選択のカスタムサロゲートポリシーを実装する方法を次のコード例に示します。コード全体については、「方法 : サロゲートポリシーを作成する」を参照してください。

' The DockPanelPolicy class implements a surrogate policy that
' provides container semantics for a selected item. By using 
' this policy, the DemoDockPanel container control offers 
' additional tasks and adorners on its children. 
Class DockPanelPolicy
    Inherits PrimarySelectionPolicy

    Public Overrides ReadOnly Property IsSurrogate() As Boolean 
        Get
            Return True
        End Get
    End Property

    Public Overrides Function GetSurrogateItems( _
        ByVal item As Microsoft.Windows.Design.Model.ModelItem) _
        As System.Collections.Generic.IEnumerable( _
        Of Microsoft.Windows.Design.Model.ModelItem)

        Dim parent As ModelItem = item.Parent

        Dim e As New System.Collections.Generic.List(Of ModelItem)

        If (parent IsNot Nothing) Then

            e.Add(parent)

        End If

        Return e

    End Function

End Class

// The DockPanelPolicy class implements a surrogate policy that
// provides container semantics for a selected item. By using 
// this policy, the DemoDockPanel container control offers 
// additional tasks and adorners on its children. 
class DockPanelPolicy : PrimarySelectionPolicy 
{
    public override bool IsSurrogate 
    {
        get 
        { 
            return true;
        }
    }

    public override IEnumerable<ModelItem> GetSurrogateItems(ModelItem item) 
    {
        ModelItem parent = item.Parent;

        if (parent != null)
        {
            yield return parent;
        }
    }
}