PropertyOrder 클래스

아티클
08/10/2011

속성이 범주나 하위 속성의 목록에서 표시되는 순서를 설정하는 데 사용됩니다.

상속 계층 구조

System.Object
Microsoft.Windows.Design.OrderToken
Microsoft.Windows.Design.PropertyEditing.PropertyOrder

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

구문

‘선언
Public NotInheritable Class PropertyOrder _
    Inherits OrderToken

public sealed class PropertyOrder : OrderToken

public ref class PropertyOrder sealed : public OrderToken

[<Sealed>]
type PropertyOrder =  
    class
        inherit OrderToken
    end

public final class PropertyOrder extends OrderToken

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

속성

	이름	설명
	Default	시스템 정의 기본 순서 위치를 가져옵니다.
	Early	시스템 정의 빠른 순서 위치를 가져옵니다.
	Late	시스템 정의 늦은 순서 위치를 가져옵니다.

위쪽

메서드

	이름	설명
	CompareTo	이 순서 토큰을 지정된 순서 토큰과 비교합니다. (OrderToken에서 상속됨)
	CreateAfter	지정된 토큰 뒤에 추가되는 PropertyOrder 개체를 만듭니다.
	CreateBefore	지정된 토큰 앞에 추가되는 PropertyOrder 개체를 만듭니다.
	Equals	지정한 Object가 현재 Object와 같은지 여부를 확인합니다. (OrderToken에서 상속됨)
	Finalize	가비지 수집에서 회수하기 전에 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
	GetHashCode	특정 형식에 대한 해시 함수 역할을 합니다. (OrderToken에서 상속됨)
	GetType	현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
	MemberwiseClone	현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
	ResolveConflict	두 OrderToken 개체가 동일하게 간주되는 경우 기본 CompareTo 구현에서 호출됩니다. (OrderToken에서 상속됨)
	ToString	현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)

위쪽

설명

속성 창에서 특정 속성 집합을 함께 그룹화하기 위해 전용 PropertyOrder 인스턴스를 만듭니다.

PropertyOrder 클래스는 루트 속성과 하위 속성을 포함하는 속성 순서를 제어합니다. 루트 속성은 먼저 범주별로 정렬되고 사전순으로 정렬된 다음 최종적으로 PropertyOrder별로 정렬됩니다. 하위 속성은 PropertyOrder별로 정렬된 다음 사전순으로 정렬됩니다.

참고

GetProperties 메서드를 사용하여 속성의 순서를 결정하는 Windows Forms 디자이너에서는 이 동작이 다릅니다. WPF Designer의 경우 속성은 PropertyOrder 클래스를 사용하여 정렬됩니다.

표준 순서 토큰이 PropertyOrder 클래스에 의해 제공됩니다. 이러한 시스템 정의 순서 토큰에는 Early, Default 및 Late 속성이 포함됩니다. Early 순서 토큰은 속성 창에서 더 높은 위치를 참조합니다.

특정 속성 순서가 없는 속성에는 Default 순서가 제공됩니다. 이 클래스에서 파생하고 고유한 사용자 지정 순서 토큰을 만들어 속성 순서와 속성 그룹화를 보장할 수 있습니다.

예제

다음 코드 예제에서는 PropertyOrder에서 파생하여

Width 및 Height 속성에 사용되는 LayoutSizePriority 클래스를 구현하는 방법을 보여 줍니다. 이 클래스는 Early 순서 뒤에 만들어집니다. 따라서 목록에서 Early 속성 뒤에 나타납니다. LayoutAlignmentPriority는 HorizontalAlignment 및 VerticalAlignment 속성에 사용되며 LayoutSizePriority 뒤에 만들어집니다.

PropertyOrder 인스턴스는 PropertyOrderAttribute를 사용하여 속성에 바인딩됩니다. CreateBefore 및 CreateAfter 메서드는 Width를 Height 앞에 배치하고 HorizontalAlignment를 VerticalAlignment 앞에 배치합니다.

Imports System
Imports System.Windows
Imports System.Windows.Controls
Imports Microsoft.Windows.Design.PropertyEditing
Imports Microsoft.Windows.Design.Metadata

Public Class PropertyOrderTokens
    Private Shared layoutSizePriorityValue As PropertyOrder
    Private Shared layoutAlignmentPriorityValue As PropertyOrder


    Public Shared ReadOnly Property LayoutSizePriority() As PropertyOrder
        Get
            If layoutSizePriorityValue Is Nothing Then
                LayoutSizePriority = PropertyOrder.CreateAfter(PropertyOrder.Early)
            End If

            Return layoutSizePriorityValue
        End Get
    End Property


    Public Shared ReadOnly Property LayoutAlignmentPriority() As PropertyOrder
        Get
            If layoutAlignmentPriorityValue Is Nothing Then
                layoutAlignmentPriorityValue = PropertyOrder.CreateAfter(PropertyOrderTokens.LayoutSizePriority)
            End If

            Return layoutAlignmentPriorityValue
        End Get
    End Property
End Class

' 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.
Friend Class Metadata
    Implements IProvideAttributeTable

    ' Accessed by the designer to register any design-time metadata.
    Public ReadOnly Property AttributeTable() As AttributeTable _
        Implements IProvideAttributeTable.AttributeTable
        Get
            Dim builder As New AttributeTableBuilder()

            builder.AddCustomAttributes( _
                GetType(Button), _
                "HeightProperty", _
                New PropertyOrderAttribute( _
                    PropertyOrder.CreateAfter( _
                        PropertyOrderTokens.LayoutSizePriority)))

            builder.AddCustomAttributes( _
                GetType(Button), _
                "Width", _
                New PropertyOrderAttribute( _
                    PropertyOrder.CreateBefore( _
                        PropertyOrderTokens.LayoutSizePriority)))

            builder.AddCustomAttributes( _
                GetType(Button), _
                "VerticalAlignment", _
                New PropertyOrderAttribute( _
                    PropertyOrder.CreateAfter( _
                        PropertyOrderTokens.LayoutAlignmentPriority)))

            builder.AddCustomAttributes( _
                GetType(Button), _
                "HorizontalAlignment", _
                New PropertyOrderAttribute( _
                    PropertyOrder.CreateBefore( _
                        PropertyOrderTokens.LayoutAlignmentPriority)))

            Return builder.CreateTable()
        End Get
    End Property
End Class

using System;
using System.Windows;
using System.Windows.Controls;
using Microsoft.Windows.Design.PropertyEditing;
using Microsoft.Windows.Design.Metadata;

public static class PropertyOrderTokens
{
    private static PropertyOrder layoutSizePriority;
    private static PropertyOrder layoutAlignmentPriority;

    public static PropertyOrder LayoutSizePriority
    {
        get
        {
            if (layoutSizePriority == null)
            {
                layoutSizePriority = PropertyOrder.CreateAfter(
                    PropertyOrder.Early);
            }

            return layoutSizePriority;
        }
    }

    public static PropertyOrder LayoutAlignmentPriority
    {
        get
        {
            if (layoutAlignmentPriority == null)
            {
                layoutAlignmentPriority = PropertyOrder.CreateAfter(
                    PropertyOrderTokens.LayoutSizePriority);
            }

            return layoutAlignmentPriority;
        }
    }
}

// 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();

            builder.AddCustomAttributes(
                typeof(Button),
                "Height",
                new PropertyOrderAttribute(
                    PropertyOrder.CreateAfter(
                    PropertyOrderTokens.LayoutSizePriority)));

            builder.AddCustomAttributes(
                typeof(Button),
                "Width",
                new PropertyOrderAttribute(
                    PropertyOrder.CreateBefore(
                    PropertyOrderTokens.LayoutSizePriority)));

            builder.AddCustomAttributes(
                typeof(Button),
                "VerticalAlignment",
                new PropertyOrderAttribute(
                    PropertyOrder.CreateAfter(
                    PropertyOrderTokens.LayoutAlignmentPriority)));

            builder.AddCustomAttributes(
                typeof(Button),
                "HorizontalAlignment",
                new PropertyOrderAttribute(
                    PropertyOrder.CreateBefore(
                    PropertyOrderTokens.LayoutAlignmentPriority)));

            return builder.CreateTable();
        }
    }
}

스레드로부터의 안전성

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

참고 항목

참조

Microsoft.Windows.Design.PropertyEditing 네임스페이스

기타 리소스

속성 편집 아키텍처

WPF Designer 확장성

다음을 통해 공유

PropertyOrder 클래스

상속 계층 구조

구문

속성

메서드

설명

예제

스레드로부터의 안전성

참고 항목

참조

기타 리소스

추가 리소스