RelativeSource MarkupExtension

  • 아티클

Binding 태그 확장 내에서 사용되거나 XAML에 설정되어 있는 Binding 요소의 RelativeSource 속성을 설정할 때 사용되는 RelativeSource 바인딩 소스의 속성을 지정합니다.

XAML 특성 사용

<Binding RelativeSource="{RelativeSource modeEnumValue}" ... />

XAML 특성 사용(Binding 확장 내에 중첩)

<object property="{Binding RelativeSource={RelativeSource modeEnumValue} ...}" ... />

XAML 개체 요소 사용

<Binding>
  <Binding.RelativeSource>
    <RelativeSource Mode="modeEnumValue"/>
  </Binding.RelativeSource>
</Binding>

또는

<Binding>
  <Binding.RelativeSource>
    <RelativeSource
      Mode="FindAncestor"
      AncestorType="{x:Type typeName}"
      AncestorLevel="intLevel"
    />
  </Binding.RelativeSource>
</Binding>

XAML 값

값 설명
modeEnumValue 다음 중 하나

- 문자열 토큰 Self는 Mode 속성을 Self로 설정하여 생성한 RelativeSource에 해당합니다.
- 문자열 토큰 TemplatedParent는 Mode 속성을 TemplatedParent로 설정하여 생성한 RelativeSource에 해당합니다.
- 문자열 토큰 PreviousData는 Mode 속성을 PreviousData로 설정하여 생성한 RelativeSource에 해당합니다.
- FindAncestor 모드에 대한 자세한 내용은 아래를 참조하세요.
FindAncestor 토큰 문자열 FindAncestor입니다. 이 토큰을 사용하면 RelativeSource가 상위 항목 형식과 상위 수준(선택 사항)을 지정하는 모드로 들어갑니다. 이것은 RelativeSource 속성을 Mode로 설정하여 생성한 FindAncestor에 해당합니다.
typeName FindAncestor 모드에 필수적인 요소입니다. AncestorType 속성을 채우는 형식의 이름입니다.
intLevel FindAncestor 모드에서는 선택적으로 사용할 수 있습니다. 논리 트리에서 부모 방향 쪽으로 계산되는 상위 수준입니다.

설명

{RelativeSource TemplatedParent} 바인딩 사용은 컨트롤의 UI와 컨트롤의 논리를 분리하는 더 큰 개념을 해결하는 핵심 기술입니다. 이를 통해 템플릿 정의 내에서 템플릿 기반 부모(템플릿이 적용되는 런타임 개체 인스턴스)로 바인딩할 수 있습니다. 이 경우 TemplateBinding 태그 확장은 {Binding RelativeSource={RelativeSource TemplatedParent}}와 같은 바인딩 식에 대한 약어입니다. TemplateBinding 또는 {RelativeSource TemplatedParent} 사용은 둘 다 템플릿을 정의하는 XAML 내에서만 관련되어 있습니다. 자세한 내용은 TemplateBinding 태그 확장을 참조하세요.

{RelativeSource FindAncestor}는 컨트롤이 항상 특정 상위 항목 형식의 시각적 트리에 있을 것으로 예상되는 경우 컨트롤 템플릿 또는 예측 가능한 자체 포함 UI 구성 요소에 주로 사용됩니다. 예를 들어, 항목 컨트롤의 항목은 FindAncestor를 사용하여 항목 컨트롤 부모 상위 항목의 속성에 바인딩할 수 있습니다. 또는 템플릿에 컨트롤 컴퍼지션의 일부인 요소에서 FindAncestor 바인딩을 동일한 컴퍼지션 구조에서 상위 요소로 사용할 수 있습니다.

XAML 구문 섹션에 표시된 FindAncestor 모드에 대한 개체 요소 구문에서 FindAncestor 모드의 경우에는 특히 두 번째 개체 요소 구문이 사용됩니다. FindAncestor 모드에는 AncestorType 값이 필요합니다. 찾을 상위 항목의 형식에 대한 x:Type 태그 확장 참조를 사용하여 AncestorType을 특성으로 설정해야 합니다. 바인딩 요청이 실시간으로 처리될 때 AncestorType 값이 사용됩니다.

FindAncestor 모드의 경우 선택적 속성인 AncestorLevel을 사용하면 요소 트리에 같은 형식의 상위 항목이 둘 이상 있을 때 상위 항목을 쉽게 구분할 수 있습니다.

FindAncestor 모드를 사용하는 방법에 대한 자세한 내용은 RelativeSource를 참조하십시오.

{RelativeSource Self}는 인스턴스의 한 속성이 같은 인스턴스의 다른 속성 값에 종속되어야 하고 이 두 속성 간에는 일반적인 종속 속성 관계(예: coercion)가 아직 존재하지 않는 시나리오에 유용합니다. 값이 문자 그대로 동일하고 동일하게 입력되도록 개체에 두 가지 속성이 존재하는 것은 드문 일이지만, {RelativeSource Self}가 있는 바인딩에 Converter 매개 변수를 적용하고 변환기를 사용하여 소스와 대상 형식 간에 변환할 수도 있습니다. {RelativeSource Self}에 대한 또 다른 시나리오는 MultiDataTrigger의 일부입니다.

예를 들어, 다음 XAML은 Rectangle에 어떤 값이 입력되더라도 Width은 항상 사각형이 되도록 Rectangle 요소를 정의합니다. <Rectangle Width="200" Height="{Binding RelativeSource={RelativeSource Self}, Path=Width}" .../>

{RelativeSource PreviousData}는 바인딩이 데이터 소스로 컬렉션을 사용하는 경우 또는 데이터 템플릿에서 유용합니다. {RelativeSource PreviousData}를 사용하여 컬렉션에서 인접 데이터 항목 간의 관계를 강조 표시할 수 있습니다. 관련된 기술은 데이터 소스에 있는 현재 항목과 이전 항목 사이에 MultiBinding을 구축하고 해당 바인딩에서 변환기를 사용하여 두 항목 사이의 차이점과 해당 속성을 확인하는 것입니다.

다음 예제에서 항목 템플릿의 첫 번째 TextBlock은 현재 번호를 표시합니다. 두 번째 TextBlock 바인딩은 MultiBinding입니다. 이는 명목적으로 현재 레코드와 {RelativeSource PreviousData}를 사용하여 의도적으로 이전 데이터 레코드를 사용하는 바인딩의 두 가지 Binding 구성 요소를 가집니다. 그런 다음, MultiBinding의 변환기가 차이를 계산하고 이를 바인딩으로 반환합니다.

<ListBox Name="fibolist">
    <ListBox.ItemTemplate>
        <DataTemplate>
            <StackPanel Orientation="Horizontal">
            <TextBlock Text="{Binding}"/>
            <TextBlock>, difference = </TextBlock>
                <TextBlock>
                    <TextBlock.Text>
                        <MultiBinding Converter="{StaticResource DiffConverter}">
                            <Binding/>
                            <Binding RelativeSource="{RelativeSource PreviousData}"/>
                        </MultiBinding>
                    </TextBlock.Text>
                </TextBlock>
            </StackPanel>
        </DataTemplate>
    </ListBox.ItemTemplate>
</ListBox>

여기서는 데이터 바인딩의 개념에 대해서는 설명하지 않습니다. 데이터 바인딩 개요를 참조하세요.

WPF XAML 프로세서 구현에서 이 태그 확장에 대한 처리는 RelativeSource 클래스를 통해 정의됩니다.

RelativeSource은 태그 확장입니다. 태그 확장은 특성 값을 리터럴 값 또는 처리기 이름이 아닌 다른 값이 되도록 이스케이프해야 하는 요구 사항이 있는 경우 일반적으로 구현되며 이러한 요구 사항은 특정 형식 또는 속성에 형식 변환기를 배치하는 것보다 더 포괄적입니다. XAML의 모든 태그 확장은 특성 구문에 { 및 } 문자를 사용합니다. 여기서 특성 구문은 XAML 프로세서가 태그 확장이 특성을 처리해야 함을 인식하는 데 사용하는 규칙입니다. 자세한 내용은 태그 확장 및 WPF XAML을 참조하세요.

참고 항목