종속성 속성 값 우선 순위

  • 아티클

이 항목에서는 WPF(Windows Presentation Foundation) 속성 시스템의 작업 방식이 종속성 속성 값에 영향을 주는 방식을 설명하고 속성 시스템의 일면이 속성의 유효 값이 적용되는 우선 순위에 관해 설명합니다.

필수 구성 요소

이 항목에서는 WPF 클래스에서 기존 종속성 속성의 이용자 관점에서 종속성 속성을 이해하고 종속성 속성 개요를 읽었다고 가정합니다. 이 항목의 예제를 따라 하려면 XAML도 이해하고 WPF 애플리케이션을 작성하는 방법도 알아야 합니다.

WPF 속성 시스템

WPF 속성 시스템에서는 실시간 속성 유효성 검사, 지연 바인딩, 다른 속성의 값에 관련 속성의 변경 사항 알림과 같은 기능을 사용하여 다양한 요소에 따라 종속성 속성 값을 결정할 강력한 방법을 제공합니다. 종속성 속성 값을 결정하는 데 사용되는 정확한 순서와 논리는 상당히 복잡합니다. 이 순서를 알면 불필요한 속성 설정을 피할 수 있으며 종속성 속성 값을 예상하거나 영향을 주려고 했을 때 예상과 다른 값이 나온 이유를 정확하게 파악할 수 있습니다.

종속성 속성을 여러 곳에 "설정"할 수 있음

다음은 같은 속성(Background)에 값에 영향을 줄 수 있는 세 가지 서로 다른 "set" 연산이 포함된 XAML의 예입니다.

<StackPanel>
    <StackPanel.Resources>
        <ControlTemplate x:Key="ButtonTemplate" TargetType="{x:Type Button}">
            <Border Background="{TemplateBinding Background}" BorderThickness="{TemplateBinding BorderThickness}" 
                    BorderBrush="{TemplateBinding BorderBrush}">
                <ContentPresenter HorizontalAlignment="Center" VerticalAlignment="Center" />
            </Border>
        </ControlTemplate>
    </StackPanel.Resources>

    <Button Template="{StaticResource ButtonTemplate}" Background="Red">
        <Button.Style>
            <Style TargetType="{x:Type Button}">
                <Setter Property="Background" Value="Blue"/>
                <Style.Triggers>
                    <Trigger Property="IsMouseOver" Value="True">
                        <Setter Property="Background" Value="Yellow" />
                    </Trigger>
                </Style.Triggers>
            </Style>
        </Button.Style>
        Which color do you expect?
    </Button>
</StackPanel>

여기에서 적용될 것으로 예상되는 색은 빨간색, 녹색, 파란색 중에 어느 것입니까?

애니메이션된 값과 강제 변환을 제외하면, 로컬 속성 설정이 가장 높은 우선 순위로 설정됩니다. 값을 로컬로 설정하면 그 값은 스타일이나 컨트롤 템플릿보다도 우선적으로 적용됩니다. 여기 예제에서 Background는 로컬로 Red로 설정됩니다. 따라서 이 범위에서 정의된 스타일은 그 범위에서 해당 유형의 모든 요소에 암시적으로 적용되었을 스타일임에도 불구하고 Background 속성에 값을 지정할 때 우선 순위는 최고가 아닙니다. 그 단추 인스턴스에서 로컬 값 Red를 제거하면 스타일이 우선적으로 적용되어 단추에 스타일의 Background 값을 가져옵니다. 스타일 내에서는 트리거가 우선적으로 적용되므로 마우스가 위에 있을 때는 파란색, 그렇지 않을 때는 녹색이 됩니다.

종속성 속성 설정 우선 순위 목록

다음은 속성 시스템에서 종속성 속성의 런타임 값을 할당할 때 사용하는 최종적인 순서입니다. 가장 높은 우선 순위가 가장 먼저 나열됩니다. 이 목록은 종속성 속성 개요에 나와 있는 일반적인 순서를 확장한 것입니다.

  1. 속성 시스템 강제 변환. 강제 변환에 대한 자세한 내용은 이 항목의 뒷부분에 있는 강제 변환, 애니메이션 및 기준 값을 참조하십시오.

  2. 활성 애니메이션 또는 보류 동작이 있는 애니메이션. 속성 애니메이션이 실제로 효과를 발휘하려면 기준 값이 로컬로 설정된 경우에도 애니메이션되지 않은 기준 값보다 높은 우선 순위를 가질 수 있어야 합니다. 자세한 내용은 이 항목의 뒷부분에 있는 강제 변환, 애니메이션 및 기준 값을 참조하십시오.

  3. 로컬 값. 로컬 값은 XAML에서 특성 또는 속성 요소로 설정하거나 특정 인스턴스의 속성을 사용하여 SetValue API 메서드를 호출하는 것과 같은 편리한 "래퍼" 속성을 통해 설정될 수 있습니다. 바인딩이나 리소스를 사용하여 로컬 값을 설정하면 이들 각각은 직접 값을 설정한 것과 같은 우선 순위가 적용됩니다.

  4. TemplatedParent 템플릿 속성. 요소에는 템플릿(ControlTemplate 또는 DataTemplate)의 일부로 생성된 경우 TemplatedParent가 있습니다. 적용 시기에 대한 자세한 내용은 이 항목의 뒷부분에 있는 TemplatedParent를 참조하십시오. 템플릿 내에서는 다음과 같은 우선 순위가 적용됩니다.

    1. TemplatedParent 템플릿에서 트리거합니다.

    2. TemplatedParent 템플릿의 속성 집합(일반적으로 XAML 특성을 통해).

  5. 암시적 스타일. Style 속성에만 적용됩니다. Style 속성은 해당 요소의 유형과 일치하는 키를 가진 스타일 리소스로 채워집니다. 해당 스타일 리소스가 페이지나 애플리케이션에 있어야 합니다. 암시적 스타일 리소스의 조회는 테마로 이어지지 않습니다.

  6. 스타일 트리거. 페이지나 애플리케이션의 스타일에 있는 트리거(명시적 또는 암시적인 스타일일 수 있으나 우선 순위가 더 낮은 기본 스타일은 제외).

  7. 템플릿 트리거. 스타일에 있는 템플릿 또는 직접 적용된 템플릿의 모든 트리거.

  8. 스타일 setter. 페이지 또는 애플리케이션의 스타일에 있는 Setter의 값.

  9. 기본(테마) 스타일. 이 스타일이 적용되는 시기, 그리고 테마 스타일에 있는 템플릿과 테마 스타일의 관계에 대한 자세한 내용은 이 항목의 뒷부분에 있는 기본(테마) 스타일을 참조하십시오. 기본 스타일 내에서는 다음과 같은 우선 순위가 적용됩니다.

    1. 테마 스타일의 활성 트리거.

    2. 테마 스타일의 setter.

  10. 상속. 몇 가지 종속성 속성은 상위 요소에서 하위 요소로 값을 상속하므로 애플리케이션 전체에서 각 요소에 따로 설정할 필요가 없습니다. 자세한 내용은 속성 값 상속을 참조하십시오.

  11. 종속성 속성 메타데이터의 기본값. 종속성 속성에는 해당 속성의 속성 시스템 등록에 따라 설정된 기본값이 있을 수 있습니다. 또한 종속성 속성을 상속하는 파생 클래스에서는 유형별로 해당 메타데이터를 재정의할 수 있습니다(기본값 포함). 자세한 내용은 종속성 속성 메타데이터를 참조하십시오. 기본값보다 먼저 상속을 확인하므로, 상속된 속성의 경우는 상위 요소의 기본값이 하위 요소의 기본값보다 우선적으로 적용됩니다. 따라서 상속 가능한 속성이 어디에서도 설정되어 있지 않으면 하위 요소의 기본값 대신 루트나 상위에 지정된 기본값이 사용됩니다.

TemplatedParent

우선 순위 항목으로서의 TemplatedParent는 표준 애플리케이션 마크업에서 직접 선언한 요소의 어느 속성에도 적용되지 않습니다. TemplatedParent 개념은 템플릿 적용을 통해 생긴 시각적 트리의 하위 항목에만 존재합니다. 속성 시스템은 TemplatedParent 템플릿에서 값을 검색할 때 해당 요소를 만든 템플릿을 선택합니다. TemplatedParent 템플릿의 속성 값은 일반적으로 하위 요소의 로컬 값으로 설정된 것처럼 작동하지만, 로컬 값에 비해 우선 순위가 낮은 이유는 템플릿을 공유할 가능성이 있기 때문입니다. 자세한 내용은 TemplatedParent를 참조하십시오.

스타일 속성

앞서 설명한 조회 순서는 Style 속성 하나만을 제외하고 가능한 모든 종속성 속성에 적용됩니다. Style 속성은 스타일을 적용할 수가 없어서 우선 순위 항목 5~8이 적용되지 않는다는 점이 특이합니다. 또한 Style에 애니메이션을 적용하거나 강제하는 것은 권장되지 않습니다(Style에 애니메이션을 적용하려면 사용자 지정 애니메이션 클래스가 필요함). 그러면 Style 속성을 설정할 방법은 세 가지가 남습니다.

  • 명시적 스타일. Style 속성이 직접 설정됩니다. 대부분의 시나리오에서 스타일은 인라인으로 정의되지 않고 명시적 키를 통해 리소스로 참조됩니다. 이 경우는 스타일 속성 자체가 우선 순위 항목 3인 로컬 값처럼 작동합니다.

  • 암시적 스타일. Style 속성은 직접 설정되지 않습니다. 그러나 리소스 조회 시퀀스(페이지, 애플리케이션) 어딘가에 Style이 있고 적용할 스타일의 유형과 일치하는 리소스 키를 사용하여 입력되었습니다. 이 경우 Style 속성 자체가 시퀀스에서 항목 5에 해당되는 우선 순위에 따라 작동합니다. 이 조건은 Style 속성에 대해 DependencyPropertyHelper를 사용하고 결과에서 ImplicitStyleReference를 찾아 탐색할 수 있습니다.

  • 테마 스타일이라고도 하는 기본 스타일입니다. Style 속성은 직접 설정되지 않으며 실제로 런타임까지 null로 읽습니다. 이 경우 스타일은 WPF 프레젠테이션 엔진에 포함된 런타임 테마 평가에서 옵니다.

테마에 있지 않은 암시적 스타일의 경우는 유형이 정확하게 일치해야 하며, MyButtonButton 파생 클래스는 Button의 스타일을 암시적으로 사용하지 않습니다.

기본(테마) 스타일

WPF와 함께 제공되는 모든 컨트롤에는 기본 스타일이 있습니다. 이러한 기본 스타일은 테마에 따라 달라질 수 있으므로 테마 스타일이라고도 합니다.

컨트롤의 기본 스타일에서 찾을 수 있는 가장 중요한 정보는 테마 스타일에 Template 속성의 setter로서 존재하는 컨트롤 템플릿입니다. 기본 스타일에 템플릿이 없으면 사용자 지정 스타일에 사용자 지정 템플릿이 포함되어 있지 않은 컨트롤에는 시각적인 모양이 전혀 없습니다. 기본 스타일의 템플릿은 각 컨트롤의 시각적인 모양에 기본적인 구조를 정해 주며 템플릿에 정의된 속성과 해당 컨트롤 클래스 사이의 연결을 정의합니다. 각 컨트롤은 템플릿을 완전히 교체하지 않고 컨트롤의 시각적인 모양에 영향을 줄 수 있는 속성의 집합을 노출합니다. 예를 들어 ScrollBar의 구성 요소인 Thumb 컨트롤의 기본 시각적 모양을 고려합니다.

Thumb에는 특정 사용자 지정 가능한 속성이 있습니다. Thumb의 기본 템플릿에서는 중첩된 Border 구성 요소 몇 개가 있는 기본 구조/시각적 트리를 만들어 3D 가장자리의 모양을 만듭니다. 템플릿에 속한 속성을 노출시켜 Thumb 클래스의 사용자 정의에 사용하려 할 경우 템플릿에 있는 TemplateBinding을 사용하여 그 속성을 노출해야 합니다. Thumb의 경우에서는 이러한 경계의 다양한 속성이 Background 또는 BorderThickness와 같은 속성에 대한 템플릿 바인딩을 공유합니다. 하지만 다른 특정 속성 또는 시각적 배치는 컨트롤 템플릿에 하드 코딩되거나 테마에서 직접 제공되는 값에 바인딩되어 템플릿 전체를 바꾸지 않는 한은 변경할 수 없습니다. 일반적으로, 속성이 템플릿 상위에서 오며 템플릿 바인딩을 통해 노출되지 않는 경우는, 쉽게 대상으로 지정할 방법이 없기 때문에 스타일을 통해 조정할 수 없습니다. 그러나 그 속성도 적용된 템플릿에서 상속된 속성 값이나 기본값의 영향을 받을 수는 있습니다.

테마 스타일에서는 유형을 정의에서 키로 사용합니다. 그러나 특정 요소 인스턴스에 테마를 적용할 때, 테마에서는 컨트롤의 DefaultStyleKey 속성을 확인하여 이 유형을 조회합니다. 암시적 스타일과 같이 리터럴 Type을 사용하는 방법과는 대조적입니다. DefaultStyleKey의 값은 구현자에서 변경하지 않은 경우에도 파생 클래스로 상속됩니다(속성을 변경하는 방법은 속성 수준에서 재정의하지 않고 속성 메타데이터에서 기본값을 변경하는 것임). 이 간접 참조를 사용하면 기본 클래스에서 원래는 스타일이 없었을(그 스타일에 템플릿이 없어 기본적인 시각적 모양이 전혀 없었을) 파생 요소의 테마 스타일을 정의할 수 있습니다. 따라서 Button에서 MyButton을 파생시키고 Button 기본 템플릿을 가져올 수 있습니다. MyButton의 컨트롤 작성자로서 다른 동작을 사용하려는 경우는 MyButton에서 DefaultStyleKey의 종속성 속성 메타데이터를 재정의하여 다른 키를 반환하게 한 다음, MyButton 컨트롤과 함께 패키지로 구성해야 할 MyButton의 템플릿이 포함된 관련 테마 스타일을 정의할 수 있습니다. 테마, 스타일 및 컨트롤 작성에 대한 자세한 내용은 컨트롤 제작 개요를 참조하십시오.

동적 리소스 참조 및 바인딩

동적 리소스 참조 및 바인딩 작업에서는 설정된 위치의 우선 순위를 따릅니다. 예를 들어 로컬 값에 적용한 동적 리소스는 우선 순위 항목 3에 따라 작동하고, 테마 스타일에 있는 속성 setter의 바인딩은 우선 순위 항목 9에 따라 작동합니다. 동적 리소스 참조 및 바인딩은 모두 애플리케이션의 런타임 상태에서 값을 얻을 수 있어야 하므로 특정 속성의 속성 값 우선 순위를 결정하는 실제 프로세스가 런타임으로도 확장됩니다.

동적 리소스 참조는 엄밀하게 말해 속성 시스템에 포함되지 않지만, 위에 나열된 시퀀스와 상호 작용하는 자체 조회 순서가 있습니다. 그 우선 순위에 관한 내용은 XAML 리소스에 자세히 나와 있습니다. 기본적인 우선 순위를 요약해 보면 요소에서 페이지 루트, 애플리케이션, 테마, 시스템 순입니다.

동적 리소스 및 바인딩은 설정 위치의 우선 순위를 따르지만, 값은 지연됩니다. 그 때문에 생기는 결과 중 하나는 동적 리소스나 바인딩을 로컬 값에 설정하라 경우 로컬 값의 변화가 동적 리소스나 바인딩을 완전히 대체한다는 것입니다. ClearValue 메서드를 호출하여 로컬에 설정된 값을 지운다고 해도, 동적 리소스나 바인딩이 복원되지는 않습니다. 실제로 동적 리소스나 바인딩이 있는 속성에서(리터럴 로컬 값 없이) ClearValue를 호출한 경우에는 ClearValue 호출을 통해서도 지워집니다.

SetCurrentValue

SetCurrentValue 메서드도 속성을 설정할 수 있는 방법이지만, 우선 순위를 따르지는 않습니다. 대신 SetCurrentValue를 사용하여 이전 값의 소스를 덮어쓰지 않고 속성 값을 변경할 수 있습니다. 로컬 값의 우선 순위를 지정하지 않고 값을 설정하려는 경우는 언제든지 SetCurrentValue를 사용할 수 있습니다. 예를 들어 트리거를 통해 속성을 설정한 다음, SetCurrentValue를 통해 다른 값을 할당한 경우에도 속성 시스템은 트리거를 따르며, 트리거 작동이 발생하면 속성이 변경됩니다. SetCurrentValue를 사용하면 우선 순위가 높은 소스를 제공하지 않고 속성 값을 변경할 수 있습니다. 마찬가지로, SetCurrentValue를 사용하여 바인딩을 덮어쓰지 않고 속성 값을 변경할 수 있습니다.

강제 변환, 애니메이션 및 기준 값

강제 변환 및 애니메이션은 모두 이 SDK 전체에서 "기준 값"이라고 부르는 값에 적용됩니다. 따라서 기준 값은 항목 2에 도달할 때까지 위쪽으로 평가하여 결정된 값입니다.

애니메이션의 경우, 그 애니메이션이 특정 동작의 "From" 및 "To"를 모두 지정하지 않거나 애니메이션이 완료되었을 때 기준 값으로 돌아가도록 되어 있는 경우는 애니메이션된 값에서 기준 값의 효과를 적용할 수 있습니다. 이 작동을 실제로 확인하려면 From, To 및 By 애니메이션 대상 값 샘플을 실행하십시오. 예에서 직사각형 높이의 로컬 값을 초기 로컬 값이 애니메이션에 있는 "From" 값과 달라지도록 설정해 보십시오. 애니메이션은 "From" 값을 사용하여 시작하며, 시작된 후에는 기준 값을 대체합니다. Stop FillBehavior를 지정하여 완료된 후에는 애니메이션 전의 값으로 돌아가도록 애니메이션을 지정할 수도 있습니다. 그 후에는 일반적인 우선 순위를 사용하여 기준 값을 결정합니다.

여러 애니메이션을 단일 속성에 적용할 수 있으며, 이러한 애니메이션 각각은 값 우선 순위의 여러 지점에서 정의할 수 있습니다. 그러나 이러한 애니메이션을 사용하면 높은 우선 순위의 애니메이션이 그냥 적용되지 않고 값이 복합될 수도 있습니다. 결과는 애니메이션을 정의하는 정확한 방식과 애니메이션되는 값의 유형에 따라 달라집니다. 속성 애니메이션에 대한 자세한 내용은 애니메이션 개요를 참조하십시오.

강제 변환이 가장 높은 수준에서 적용됩니다. 이미 실행 중인 애니메이션도 값을 강제 변환할 수 있습니다. 어떤 기존 종속성 속성은 WPF에 기본 제공 강제 변환이 있습니다. 사용자 지정 종속성 속성에서는 CoerceValueCallback을 작성하고 속성을 만들 때 메타데이터의 일부로 콜백을 전달하여 사용자 지정 종속성 속성의 강제 변환 동작을 정의합니다. 파생 클래스에서 해당 속성의 메타데이터를 재정의하여 기존 속성의 강제 변환 동작을 재정의할 수도 있습니다. 적용 시점에 존재하는 강제 변환의 제약 조건을 따르면서 기준 값은 유지하는 방식으로 강제 변환과 기준 값이 상호 작용합니다. 따라서 나중에 강제 변환의 제약 조건이 제거되면 강제 변환에서 가능한 가장 가까운 값을 기준 값으로 반환하며, 그러면 모든 제약 조건이 제거되는 즉시 속성에 미치는 강제 변환의 영향이 사라집니다. 강제 변환 동작에 대한 자세한 내용은 종속성 속성 콜백 및 유효성 검사를 참조하십시오.

트리거 동작

컨트롤에서 테마에 있는 기본 스타일의 일부로서 트리거 동작을 정의하는 경우가 많습니다. 컨트롤에 로컬 속성을 설정하면 트리거가 시각적으로 또는 동작을 통해 사용자 기반 이벤트에 응답하지 못할 수 있습니다. 속성 트리거가 가장 많이 사용되는 곳은 컨트롤 또는 IsSelected와 같은 상태 속성입니다. 예를 들어, 기본적으로 Button을 사용할 수 없는 경우(IsEnabled의 트리거가 false임) 테마 스타일의 Foreground 값 때문에 컨트롤이 "회색으로 흐리게" 표시됩니다. 그러나 로컬 Foreground 값을 설정하면 일반적으로 회색으로 표시되는 색이 이 속성 트리거 시나리오에서도 우선 순위에서 로컬 속성 설정에 밀립니다. 테마 수준 트리거 동작이 있는 속성의 값을 설정할 때 주의해야 하며, 해당 컨트롤의 사용자 경험을 과도하게 방해하지 않도록 주의해야 합니다.

ClearValue 및 값 우선 순위

ClearValue 메서드를 사용하면 요소에 설정된 종속성 속성에서 로컬로 적용된 값을 편리하게 지울 수 있습니다. 그러나 ClearValue를 호출한다고 해서 속성을 등록할 때 메타데이터에 설정된 기본값이 새 유효 값으로 보장되는 것은 아닙니다. 값의 우선 순위에 있는 다른 항목도 모두 여전히 활성 상태입니다. 로컬에서 설정된 값만 우선 순위 시퀀스에서 제거되었습니다. 예를 들어 테마 스타일을 통해서도 속성을 설정하는 경우 속성에 ClearValue를 호출하면 테마 값이 메타데이터 기반 기본값이 아니라 새 값으로 적용됩니다. 모든 속성 값 해당 항목을 프로세스에서 제외하고 값을 등록된 메타데이터 기본값으로 설정하려는 경우에는 종속성 속성 메타데이터를 쿼리한 다음, 기본값을 사용하여 SetValue에 대한 호출에 로컬로 속성을 설정하면 기본값을 얻을 수 있습니다.

참고 항목