ItemPolicy 클래스

아티클
08/22/2008

업데이트: 2007년 11월

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

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

구문

Public MustInherit Class ItemPolicy

Dim instance As ItemPolicy

public abstract class ItemPolicy

public ref class ItemPolicy abstract

public abstract class ItemPolicy

설명

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

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

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

예제

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

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