정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

ControlTemplate 클래스

컨트롤의 여러 인스턴스에서 공유할 수 있는 Control의 표시 구조 및 동작 측면을 지정합니다.

네임스페이스:  System.Windows.Controls
어셈블리:  PresentationFramework(PresentationFramework.dll)
XAML의 XMLNS: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

[DictionaryKeyPropertyAttribute("TargetType")]
[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
public class ControlTemplate : FrameworkTemplate
<ControlTemplate>
  <VisualTreeRootNode>
VisualTreeNodeContents
  </VisualTreeRootNode>
</ControlTemplate>

XAML 값

ControlTemplate

ControlTemplate 또는 파생된 클래스에 관한 개체 요소.

VisualTreeRootNode

ControlTemplate 의 자식(또는 파생 클래스)으로서의 XAML 라는 단일 요소 템플릿에는 단일 루트 노드가 있어야 합니다. 유용한 템플릿을 생성하려면 VisualTreeRootNode로 선택한 요소가 대개 여러 자식 요소를 지원하는 고유한 콘텐츠 모델을 지원해야 합니다.

VisualTreeNodeContents

사용할 템플릿을 완료하는 하나 이상의 요소입니다. VisualTreeRootNode로 선택된 요소는 단일 자식만 지원하므로 VisualTreeNodeContents로 선언될 수 있는 요소는 하나뿐입니다. 또한 드문 경우지만 선택한 VisualTreeRootNode에서 텍스트 콘텐츠 속성을 지원하는 경우 텍스트 콘텐츠를 제공할 수도 있습니다.

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

  이름설명
Public 메서드ControlTemplate() ControlTemplate 클래스의 새 인스턴스를 초기화합니다.
Public 메서드ControlTemplate(Type)지정된 대상 형식을 사용하여 ControlTemplate 클래스의 새 인스턴스를 초기화합니다.
위쪽

  이름설명
Public 속성DispatcherDispatcherObject와 연결된 Dispatcher를 가져옵니다. (DispatcherObject에서 상속됨)
Public 속성HasContent이 템플릿의 콘텐츠가 최적화되어 있는지 여부를 나타내는 값을 가져옵니다. (FrameworkTemplate에서 상속됨)
Public 속성IsSealed이 개체가 변경할 수 없는 변경 불가능 상태인지 여부를 나타내는 값을 가져옵니다. (FrameworkTemplate에서 상속됨)
Public 속성Resources이 템플릿의 범위 내에서 사용할 수 있는 리소스의 컬렉션을 가져오거나 설정합니다. (FrameworkTemplate에서 상속됨)
Public 속성TargetTypeControlTemplate을 적용할 형식을 가져오거나 설정합니다.
Public 속성Template작성자가 템플릿을 정의하거나 적용할 때 해당 템플릿의 XAML 노드를 기록/재생하는 개체에 대한 참조를 가져오거나 설정합니다. (FrameworkTemplate에서 상속됨)
Public 속성Triggers속성 변경 내용을 적용하거나 지정된 조건에 따라 작업을 수행하는 TriggerBase 개체 컬렉션을 가져옵니다.
Public 속성VisualTree템플릿의 루트 노드를 가져오거나 설정합니다. (FrameworkTemplate에서 상속됨)
위쪽

  이름설명
Public 메서드CheckAccess호출 스레드가 이 DispatcherObject에 액세스할 수 있는지 여부를 확인합니다. (DispatcherObject에서 상속됨)
Public 메서드Equals(Object)지정한 Object가 현재 Object와 같은지 여부를 확인합니다. (Object에서 상속됨)
Protected 메서드Finalize 개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드FindName이 템플릿 내에 정의된 지정한 이름과 연관된 요소를 찾습니다. (FrameworkTemplate에서 상속됨)
Public 메서드GetHashCode특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드LoadContent템플릿의 콘텐츠를 개체의 인스턴스로 로드하고 콘텐츠의 루트 요소를 반환합니다. (FrameworkTemplate에서 상속됨)
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드RegisterName현재 이름 범위에 새 이름/개체 쌍을 등록합니다. (FrameworkTemplate에서 상속됨)
Public 메서드Seal템플릿을 변경할 수 없도록 잠급니다. (FrameworkTemplate에서 상속됨)
Public 메서드ShouldSerializeResources이 클래스의 인스턴스에서 serialization 프로세스를 통해 Resources 속성의 값을 serialize해야 하는지 여부를 나타내는 값을 반환합니다. (FrameworkTemplate에서 상속됨)
Public 메서드ShouldSerializeVisualTree이 클래스의 인스턴스에서 serialization 프로세스를 통해 VisualTree 속성의 값을 serialize해야 하는지 여부를 나타내는 값을 반환합니다. (FrameworkTemplate에서 상속됨)
Public 메서드ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
Public 메서드UnregisterNameXAML 이름 범위에서 이름/개체 매핑을 제거합니다. (FrameworkTemplate에서 상속됨)
Protected 메서드ValidateTemplatedParent규칙 집합에 대해 템플릿 부모를 확인합니다. (FrameworkTemplate.ValidateTemplatedParent(FrameworkElement)을(를) 재정의함)
Public 메서드VerifyAccess호출 스레드에서 이 DispatcherObject에 액세스할 수 있는지 확인합니다. (DispatcherObject에서 상속됨)
위쪽

  이름설명
명시적 인터페이스 구현Private 메서드INameScope.FindName인프라입니다. 제공된 식별 이름이 있는 개체를 반환합니다. (FrameworkTemplate에서 상속됨)
명시적 인터페이스 구현Private 메서드IQueryAmbient.IsAmbientPropertyAvailable지정된 앰비언트 속성을 현재 범위에서 사용할 수 있는지 여부를 쿼리합니다. (FrameworkTemplate에서 상속됨)
위쪽

ControlTemplate 을 사용하면 컨트롤의 표시 구조를 지정할 수 있습니다. 컨트롤 작성자는 기본 ControlTemplate을 정의할 수 있으며 응용 프로그램 작성자는 ControlTemplate을 재정의하여 컨트롤의 표시 구조를 다시 생성할 수 있습니다.

컨트롤 템플릿은 WPF 스타일 및 템플릿 모델에서 제공되는 다양한 기능 중 하나입니다. 스타일 및 템플릿 모델에서는 융통성 있는 기능이 다양하게 제공되므로 대부분의 경우 컨트롤을 직접 작성할 필요가 없습니다. 컨트롤의 시각화를 변경하거나 기존 컨트롤의 ControlTemplate을 바꾸려는 응용 프로그램 작성자의 경우 스타일 지정 및 템플릿 항목에 있는 예제 및 자세한 설명을 참조하십시오.

컨트롤을 직접 작성하는 경우에는 컨트롤 제작 개요의 "사용자 지정 컨트롤 만들기"를 참조하십시오.

ControlTemplate 은 스타일을 포함하여 외부 사용자 및 개체에서 볼 수 없는 독립된 세부 구현 단위입니다. 컨트롤 템플릿의 내용은 해당 컨트롤 템플릿 내에서만 조작할 수 있습니다.

다음 예제에서는 ButtonControlTemplate을 설정하는 Button Style을 보여 줍니다.


<Style TargetType="Button">
  <!--Set to true to not get any properties from the themes.-->
  <Setter Property="OverridesDefaultStyle" Value="True"/>
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="Button">
        <Grid>
          <Ellipse Fill="{TemplateBinding Background}"/>
          <ContentPresenter HorizontalAlignment="Center"
                            VerticalAlignment="Center"/>
        </Grid>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>


이 스타일을 적용하면 ButtonEllipse로 표시됩니다.

단추 ControlTemplate 샘플

Control Template 속성을 위의 예제에서처럼 새 ControlTemplate으로 설정하면 전체 템플릿이 대체됩니다. 포커스가 있거나 눌렀을 때 Button이 표시되는 모양은 모두 대체하는 기본 단추 모양의 일부입니다. 따라서 필요에 따라 다음 예제와 같이 단추를 눌렀을 때의 모양 등을 정의에 추가할 수 있습니다.


<Style TargetType="Button">
  <Setter Property="SnapsToDevicePixels"
          Value="true" />
  <Setter Property="OverridesDefaultStyle"
          Value="true" />
  <Setter Property="FocusVisualStyle"
          Value="{StaticResource ButtonFocusVisual}" />
  <Setter Property="MinHeight"
          Value="23" />
  <Setter Property="MinWidth"
          Value="75" />
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="Button">
        <Border TextBlock.Foreground="{TemplateBinding Foreground}"
                x:Name="Border"
                CornerRadius="2"
                BorderThickness="1">
          <Border.BorderBrush>
            <LinearGradientBrush StartPoint="0,0"
                                 EndPoint="0,1">
              <LinearGradientBrush.GradientStops>
                <GradientStopCollection>
                  <GradientStop Color="{DynamicResource BorderLightColor}"
                                Offset="0.0" />
                  <GradientStop Color="{DynamicResource BorderDarkColor}"
                                Offset="1.0" />
                </GradientStopCollection>
              </LinearGradientBrush.GradientStops>
            </LinearGradientBrush>

          </Border.BorderBrush>
          <Border.Background>
            <LinearGradientBrush EndPoint="0.5,1"
                                 StartPoint="0.5,0">
              <GradientStop Color="{DynamicResource ControlLightColor}"
                            Offset="0" />
              <GradientStop Color="{DynamicResource ControlMediumColor}"
                            Offset="1" />
            </LinearGradientBrush>
          </Border.Background>
          <VisualStateManager.VisualStateGroups>
            <VisualStateGroup x:Name="CommonStates">
              <VisualStateGroup.Transitions>
                <VisualTransition GeneratedDuration="0:0:0.5" />
                <VisualTransition GeneratedDuration="0"
                                  To="Pressed" />
              </VisualStateGroup.Transitions>
              <VisualState x:Name="Normal" />
              <VisualState x:Name="MouseOver">
                <Storyboard>
                  <ColorAnimationUsingKeyFrames Storyboard.TargetProperty="(Panel.Background).
                      (GradientBrush.GradientStops)[1].(GradientStop.Color)"
                                                Storyboard.TargetName="Border">
                    <EasingColorKeyFrame KeyTime="0"
                                         Value="{StaticResource ControlMouseOverColor}" />
                  </ColorAnimationUsingKeyFrames>
                </Storyboard>
              </VisualState>
              <VisualState x:Name="Pressed">
                <Storyboard>
                  <ColorAnimationUsingKeyFrames Storyboard.TargetProperty="(Panel.Background).
                      (GradientBrush.GradientStops)[1].(GradientStop.Color)"
                                                Storyboard.TargetName="Border">
                    <EasingColorKeyFrame KeyTime="0"
                                         Value="{StaticResource ControlPressedColor}" />
                  </ColorAnimationUsingKeyFrames>
                  <ColorAnimationUsingKeyFrames Storyboard.TargetProperty="(Border.BorderBrush).
                      (GradientBrush.GradientStops)[0].(GradientStop.Color)"
                                                Storyboard.TargetName="Border">
                    <EasingColorKeyFrame KeyTime="0"
                                         Value="{StaticResource PressedBorderDarkColor}" />
                  </ColorAnimationUsingKeyFrames>
                  <ColorAnimationUsingKeyFrames Storyboard.TargetProperty="(Border.BorderBrush).
                      (GradientBrush.GradientStops)[1].(GradientStop.Color)"
                                                Storyboard.TargetName="Border">
                    <EasingColorKeyFrame KeyTime="0"
                                         Value="{StaticResource PressedBorderLightColor}" />
                  </ColorAnimationUsingKeyFrames>
                </Storyboard>
              </VisualState>
              <VisualState x:Name="Disabled">
                <Storyboard>
                  <ColorAnimationUsingKeyFrames Storyboard.TargetProperty="(Panel.Background).
                      (GradientBrush.GradientStops)[1].(GradientStop.Color)"
                                                Storyboard.TargetName="Border">
                    <EasingColorKeyFrame KeyTime="0"
                                         Value="{StaticResource DisabledControlDarkColor}" />
                  </ColorAnimationUsingKeyFrames>
                  <ColorAnimationUsingKeyFrames
                      Storyboard.TargetProperty="(TextBlock.Foreground).(SolidColorBrush.Color)"
                                                Storyboard.TargetName="Border">
                    <EasingColorKeyFrame KeyTime="0"
                                         Value="{StaticResource DisabledForegroundColor}" />
                  </ColorAnimationUsingKeyFrames>
                  <ColorAnimationUsingKeyFrames Storyboard.TargetProperty="(Border.BorderBrush).
                      (GradientBrush.GradientStops)[1].(GradientStop.Color)"
                                                Storyboard.TargetName="Border">
                    <EasingColorKeyFrame KeyTime="0"
                                         Value="{StaticResource DisabledBorderDarkColor}" />
                  </ColorAnimationUsingKeyFrames>
                </Storyboard>
              </VisualState>
            </VisualStateGroup>
          </VisualStateManager.VisualStateGroups>
          <ContentPresenter Margin="2"
                            HorizontalAlignment="Center"
                            VerticalAlignment="Center"
                            RecognizesAccessKey="True" />
        </Border>
        <ControlTemplate.Triggers>
          <Trigger Property="IsDefault"
                   Value="true">

            <Setter TargetName="Border"
                    Property="BorderBrush">
              <Setter.Value>
                <LinearGradientBrush StartPoint="0,0"
                                     EndPoint="0,1">
                  <GradientBrush.GradientStops>
                    <GradientStopCollection>
                      <GradientStop Color="{DynamicResource DefaultBorderBrushLightBrush}"
                                    Offset="0.0" />
                      <GradientStop Color="{DynamicResource DefaultBorderBrushDarkColor}"
                                    Offset="1.0" />
                    </GradientStopCollection>
                  </GradientBrush.GradientStops>
                </LinearGradientBrush>

              </Setter.Value>
            </Setter>
          </Trigger>
        </ControlTemplate.Triggers>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>


이 예제는 여기에 나와 있지 않은 리소스를 참조합니다. 전체 샘플을 보려면 Styling with ControlTemplates 샘플을 참조하십시오. 이 샘플은 다양한 컨트롤에 대한 컨트롤 템플릿 예제를 제공하며 가장 효율적으로 컨트롤 템플릿 만들기를 시작할 수 있도록 합니다.

.NET Framework

4, 3.5, 3.0에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

Windows 7, Windows Vista SP1 이상, Windows XP SP3, Windows Server 2008(Server Core는 지원되지 않음), Windows Server 2008 R2(Server Core는 SP1 이상에서 지원됨), Windows Server 2003 SP2

.NET Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

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

커뮤니티 추가 항목

표시:
© 2014 Microsoft