ItemPolicy 클래스

아티클
08/10/2011

디자이너의 규칙 집합을 지정하는 정책입니다.

상속 계층 구조

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

네임스페이스: Microsoft.Windows.Design.Policies
어셈블리: Microsoft.Windows.Design.Interaction(Microsoft.Windows.Design.Interaction.dll)

구문

‘선언
Public MustInherit Class ItemPolicy

public abstract class ItemPolicy

public ref class ItemPolicy abstract

[<AbstractClass>]
type ItemPolicy =  class end

public abstract class ItemPolicy

ItemPolicy 형식에서는 다음과 같은 멤버를 노출합니다.

생성자

	이름	설명
	ItemPolicy	ItemPolicy 클래스의 새 인스턴스를 초기화합니다.

위쪽

속성

	이름	설명
	Context	디자이너의 편집 컨텍스트를 가져옵니다.
	IsSurrogate	정책이 서로게이트 정책인지 여부를 나타내는 값을 가져옵니다.
	PolicyItems	정책의 모든 항목에 대한 열거형을 가져옵니다.

위쪽

메서드

	이름	설명
	Equals	지정한 Object가 현재 Object와 같은지 여부를 확인합니다. (Object에서 상속됨)
	Finalize	가비지 수집에서 회수하기 전에 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
	GetHashCode	특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
	GetSurrogateItems	이 항목에 대한 서로게이트 항목의 선택적 집합을 반환합니다.
	GetType	현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
	MemberwiseClone	현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
	OnActivated	정책이 활성화될 때 호출됩니다.
	OnDeactivated	정책이 비활성화될 때 호출됩니다.
	OnPolicyItemsChanged	PolicyItemsChanged 이벤트를 발생시킵니다.
	ToString	현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)

위쪽

이벤트

	이름	설명
	PolicyItemsChanged	정책이 변경될 때 발생합니다.

위쪽

설명

추상 ItemPolicy 클래스에서 파생하여 항목 집합과 해당 기능 공급자를 연결할 수 있습니다.

정책을 사용하여 디자이너에서 실행되는 항목의 확장성 기능을 검색합니다. 디자이너에서 확장 가능한 도구 및 표시기(Adorner) 등의 영역에서 정책이 사용됩니다. 예를 들어 SelectionPolicy 클래스는 선택 변경을 모니터링하고 선택 내용이 변경될 때 PolicyItemsChanged 이벤트를 발생시킵니다. 디자이너는 실행 중인 모든 정책의 변경 이벤트를 처리하여 적절한 작업을 수행합니다. SelectionPolicy의 경우 디자이너는 사용 가능해야 하는 활성 작업 집합 및 디자인 화면에 표시되어야 하는 표시기 집합을 쿼리합니다.

디자이너가 메타데이터에서 정책 형식을 검색하면 정책 형식의 단일 인스턴스가 활성화됩니다. 정책은 디자이너의 수명 동안 유지되며 디자이너 자체가 삭제되지 않는 한 비활성화되지 않습니다. 정책이 프로세스 전역 리소스에 대한 참조를 보유하는 경우 정책 관리자가 종료될 때 호출되는 OnDeactivated 메서드를 구현합니다.

서로게이트 정책은 기능 공급자를 찾는 데 사용되는 대체 항목 집합을 제공합니다. 서로게이트 정책은 자식 요소에 추가 작업 및 표시기를 제공하는 컨트롤 컨테이너에 사용되는 경우가 많습니다. 이러한 경우 컨테이너는 GetSurrogateItems 메서드에서 제공된 항목의 부모를 반환하는 서로게이트 정책을 제공합니다.

예제

다음 코드 예제에서는 기본 선택 내용에 대한 사용자 지정 서로게이트 정책을 구현하는 방법을 보여 줍니다. 전체 코드 목록을 보려면 방법: 서로게이트 정책 만들기을 참조하십시오.

' 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;
        }
    }
}