FrameworkElement.OnApplyTemplate 메서드

protected:
 virtual void OnApplyTemplate() = OnApplyTemplate;

void OnApplyTemplate();

protected virtual void OnApplyTemplate();

function onApplyTemplate()

Protected Overridable Sub OnApplyTemplate ()

예제

이 예제에서는 사용자 지정 컨트롤에 의해 정의된 재정의를 보여 OnApplyTemplate 주는 예제입니다. 재정의는 잠재적으로 템플릿 및 스타일 시스템을 통해 자신의 컨트롤 템플릿을 정의하고 적용하는 호출자를 고려하도록 설계되었습니다. 정의의 일부로 컨트롤은 "UpButton"과 같이 필요한 템플릿 내에서 명명된 요소의 특성을 지정합니다. 그런 다음 OnApplyTemplate , 템플릿이 로드될 때 이 명명 계약에 따라 개체 참조를 검색하고 GetTemplateChild를 호출합니다. (설정되는 값(예: "UpButtonElement")은 클래스 수준에서 정의된 프라이빗 필드를 참조하여 클래스의 다른 멤버가 런타임에 해당 부분을 개체로 참조할 수 있도록 합니다. 또한 이 예제에서는 private 메서드 UpdateStates (정의가 표시되지 않음)를 호출합니다. 이는 컨트롤의 정의된 모든 상태를 차지하고 GoToState를 호출하여 적절한 상태를 설정하는 프라이빗 메서드를 호출하여 컨트롤의 시작 상태에 대한 시각적 상태를 설정하는 또 다른 일반적인 시나리오OnApplyTemplate입니다.

protected override void OnApplyTemplate()
{
    UpButtonElement = GetTemplateChild("UpButton") as RepeatButton;
    DownButtonElement = GetTemplateChild("DownButton") as RepeatButton;
    TextElement = GetTemplateChild("TextBlock") as TextBlock;

    UpdateStates(false);
}

설명

는 FrameworkElement 클래스 OnApplyTemplate 에서 정의한 메서드이지만 OnApplyTemplate 동작 및 재정 OnApplyTemplate 의 시나리오는 주로 Control 하위 클래스와 관련이 있습니다. 이는 일반적으로 XAML 파일에서 정의하는 Template 속성과 템플릿을 적용하는 내부 Windows 런타임 논리가 특히 컨트롤용이기 때문입니다. ContentPresenter 및 ContentControl에 대한 특수 템플릿 동작도 존재합니다.

구현자에 대한 참고 사항

이 메서드의 기본 구현은 몇 가지 기본 레이아웃 논리를 제공하는 Windows 런타임 내부 동작으로 구현됩니다. 항상 구현에서 기본 구현을 호출해야 합니다. 기본 구현을 참조하지 못하면 바람직하지 않은 레이아웃 동작이 발생할 수 있습니다.

파생 클래스는 다음 시나리오에 대한 알림 또는 진입점으로 이 메서드를 사용할 수 있습니다.

• 사용자 지정 코드를 사용하여 시각적 트리의 나머지 부분을 빌드합니다.
• 템플릿의 XAML 정의 시각적 트리가 적용된 후에만 작동할 수 있는 코드를 실행합니다. 예를 들어 이러한 부분의 멤버를 다른 템플릿 후 런타임 코드에서 참조할 수 있도록 GetTemplateChild를 호출하여 템플릿에서 가져온 명명된 요소에 대한 참조를 가져오는 코드입니다.
• 템플릿의 시각적 트리가 완료된 후에만 존재하는 것이 적합한 서비스를 소개합니다.
• 클래스 정의 이벤트 처리기를 템플릿의 일부 또는 복합 컨트롤의 컨트롤 부모에 연결합니다. 예를 들어 클래스 논리가 복합 컨트롤의 TextBox 템플릿 부분에서 라우트된 KeyDown 이벤트를 처리하도록 할 수 있습니다. 이렇게 하면 파트의 하위 수준 입력 이벤트를 기반으로 UI 상태가 업데이트되고 컨트롤 부모에 의해 발생된 컨트롤과 관련된 다른 이벤트가 대신 발생합니다.
• 다른 요소에 종속된 템플릿 내 요소의 상태 및 속성을 설정합니다. 예를 들어 속성 값은 부모 요소를 알고 있거나 특정 파생 클래스가 공통 템플릿을 사용하는 경우에만 검색할 수 있습니다. 그러나 잘 설계된 컨트롤은 VisualStateManager를 사용하여 시각적 상태를 처리해야 합니다. 이 개념에 대한 자세한 내용은 XAML 컨트롤 템플릿을 참조하세요.

OnApplyTemplate은 종종 Loaded 이벤트보다 템플릿에서 만든 시각적 트리에 대한 조정을 처리하는 데 더 적합한 지점입니다. Loaded 이벤트는 템플릿이 적용되기 전에 발생할 수 있으며 로드됨을 기준으로 시각적 트리가 불완전할 수 있습니다.

적용 대상

추가 정보

• ControlTemplate
• GetTemplateChild(String)
• 컨트롤 스타일 지정