문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

ControlTemplate 클래스

컨트롤 템플릿으로 적용된 요소 트리를 정의합니다.

네임스페이스:  System.Windows.Controls
어셈블리:  System.Windows(System.Windows.dll)

public sealed class ControlTemplate : FrameworkTemplate
<ControlTemplate ...>
  templateRootElement
</ControlTemplate>

XAML 값

templateRootElement

FrameworkElement 에서 파생되는 개체 요소 하나입니다. templateRootElement는 주로 다른 요소를 포함하고 있는 패널입니다.

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

  이름설명
Public 메서드Windows Phone용 Silverlight에서 지원ControlTemplate ControlTemplate 클래스의 새 인스턴스를 초기화합니다.
위쪽

  이름설명
Public 속성Windows Phone용 Silverlight에서 지원Dispatcher이 개체와 관련된 Dispatcher를 가져옵니다. (DependencyObject에서 상속됨)
Public 속성Windows Phone용 Silverlight에서 지원TargetType ControlTemplate 이 적용되는 형식을 가져오거나 설정합니다.
위쪽

  이름설명
Public 메서드Windows Phone용 Silverlight에서 지원CheckAccess호출 스레드에서 이 개체에 액세스할 수 있는지 여부를 확인합니다. (DependencyObject에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원ClearValue종속성 속성의 로컬 값을 지웁니다. (DependencyObject에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원Equals(Object)지정된 Object가 현재 Object와 같은지 여부를 확인합니다. (Object에서 상속됨)
Protected 메서드Windows Phone용 Silverlight에서 지원Finalize가비지 수집에서 Object를 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원GetAnimationBaseValueSilverlight 종속성 속성에 대해 설정되어 있고 애니메이션이 활성 상태가 아닐 때 적용되는 기준 값을 반환합니다. (DependencyObject에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원GetHashCode특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원GetValue DependencyObject 에서 종속성 속성의 현재 유효 값을 반환합니다. (DependencyObject에서 상속됨)
Protected 메서드Windows Phone용 Silverlight에서 지원MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원ReadLocalValue로컬 값이 설정된 경우, 종속성 속성의 로컬 값을 반환합니다. (DependencyObject에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원SetValue DependencyObject 에 종속성 속성의 로컬 값을 설정합니다. (DependencyObject에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
위쪽

ControlTemplate 은 일반적으로 여러 요소를 복합한 컨트롤의 모양을 정의합니다.

기존 컨트롤 클래스의 템플릿을 바꿀 컨트롤 템플릿을 정의하는 경우 컨트롤 템플릿 콘텐츠를 정의하는 데 사용하는 XAML은 기존 컨트롤 계약에 일치해야 합니다. 그렇지 않으면 컨트롤이 UI에서 올바르게 작동하지 않을 수 있습니다. 자세한 내용은 ControlTemplate을 사용하여 기존 컨트롤의 모양 사용자 지정컨트롤 스타일 및 템플릿을 참조하십시오.

ControlTemplate 을 사용하는 새 컨트롤을 만드는 경우 컨트롤 파트 모델을 사용해야 다른 사람이 컨트롤의 ControlTemplate을 바꿀 때 컨트롤이 제대로 작동합니다. 자세한 내용은 ControlTemplate을 만들어 새 컨트롤 만들기을 참조하십시오.

Silverlight에서 컨트롤 템플릿 설정은 전적으로 XAML을 정의하여 수행됩니다. FrameworkTemplate ControlTemplate의 API는 코드에 ControlTemplate을 만들어 컨트롤에 대한 템플릿을 정의하지 않으며 정의할 수 없습니다.

다음 예제에서는 Button에 대한 간단한 ControlTemplate을 만듭니다. 컨트롤 템플릿에는 하나의 Grid가 포함되어 있고 다음 동작을 지정합니다.

  • 사용자가 마우스를 Button 위에 두면 Grid가 0.5초 이상 동안 녹색에서 빨강으로 바뀝니다.

  • 사용자가 마우스를 단추 바깥으로 이동하면 Grid가 바로 다시 녹색으로 바뀝니다.


<ControlTemplate TargetType="Button">
  <Grid >
    <VisualStateManager.VisualStateGroups>
      <VisualStateGroup x:Name="CommonStates">

        <VisualStateGroup.Transitions>

          <!--Take one half second to trasition to the MouseOver state.-->
          <VisualTransition To="MouseOver" 
                              GeneratedDuration="0:0:0.5"/>
        </VisualStateGroup.Transitions>

        <VisualState x:Name="Normal" />

        <!--Change the SolidColorBrush, ButtonBrush, to red when the
            mouse is over the button.-->
        <VisualState x:Name="MouseOver">
          <Storyboard>
            <ColorAnimation Storyboard.TargetName="ButtonBrush" 
                            Storyboard.TargetProperty="Color" To="Red" />
          </Storyboard>
        </VisualState>
      </VisualStateGroup>
    </VisualStateManager.VisualStateGroups>
    <Grid.Background>
      <SolidColorBrush x:Name="ButtonBrush" Color="Green"/>
    </Grid.Background>
  </Grid>
</ControlTemplate>


Silverlight

5, 4, 3에서 지원

Windows Phone용 Silverlight

Windows Phone OS 7.1, Windows Phone OS 7.0에서 지원

Silverlight에서 지원되는 운영 체제 및 브라우저에 대한 자세한 내용은 지원되는 운영 체제 및 브라우저을 참조하십시오.

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

커뮤니티 추가 항목

추가
표시: