Control 클래스

정의

ControlTemplate을 사용하여 모양을 정의하는 UI 요소의 기본 클래스를 나타냅니다. ContentControl, UserControl, ItemsControl 및 몇 가지 실용적인 컨트롤에 대한 부모 클래스입니다.

public ref class Control : FrameworkElement
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Control : FrameworkElement
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Control : FrameworkElement
Public Class Control
Inherits FrameworkElement
상속
Object Platform::Object IInspectable DependencyObject UIElement FrameworkElement Control
파생
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

Control 클래스는 앱 및 해당 UI에 추가하는 많은 컨트롤의 기본 클래스입니다. Control 클래스는 동작을 거의 정의하지 않습니다. UI용 XAML에 실제 Control 요소를 추가할 수 있지만 일반적으로 Button 또는 ListBox와 같이 Control에서 직접 또는 간접적으로 상속하는 항목을 추가합니다. 사용할 수 있는 컨트롤 목록은 함수별 컨트롤을 참조하세요.

ControlTemplate 형식을 사용하는 Template 속성은 컨트롤의 시각적 모양을 지정합니다. 컨트롤의 모양을 변경하지만 해당 기능을 유지하려면 새 Control 기반 클래스를 정의하는 대신 새 ControlTemplate 을 만드는 것이 좋습니다. 자세한 내용은 컨트롤 템플릿을 참조하세요.

Control은 UserControl의 부모입니다. UserControl 은 시각적 상태가 필요하지 않은 경량 컨트롤을 위한 기본 클래스입니다. UserControl은 기술적으로 Template 속성을 상속하지만 UserControl에는 템플릿을 적용할 수 없습니다.

컨트롤에 대한 암시적 스타일

XAML에 대해 정의된 각 실제 컨트롤에는 기본 컨트롤 템플릿이 포함된 기본 스타일이 있습니다. 컨트롤에는 암시적 스타일이 있을 수 있습니다. 즉 , FrameworkElement.Style 속성이 명시적으로 설정되지 않았습니다. 해당 암시적 스타일을 사용할 수 있게 되면 컨트롤의 거의 모든 다른 속성을 해당 StyleSetter 요소로 설정할 수 있습니다. Style은 컨트롤의 나머지 논리와 별도로 컨트롤을 초기화할 수 있으며 각 속성에 대한 코드 기반 기본값이 아닌 값을 설정할 수 있습니다.

암시적 스타일은 내부적으로 XAML의 이진 표현으로 저장된 Windows 런타임 일부인 키 지정 리소스로 존재합니다. 특정 컨트롤의 스타일 또는 전체 스타일 집합의 복사본을 가져와 스타일 및 컨트롤 템플릿이 정의되는 방식을 확인할 수 있습니다.

특정 컨트롤 형식과 기본적으로 사용하는 암시적 스타일의 키/이름 간의 연결은 DefaultStyleKey 속성 값으로 설정됩니다. DefaultStyleKey 속성은 보호되므로 컨트롤 클래스를 서브클래스하는 사용자만 값을 변경할 수 있습니다. 컨트롤 instance 만드는 경우(예: XAML UI에서 컨트롤 선언) 기본 스타일은 컨트롤의 형식을 기반으로 하는 암시적 스타일입니다. 자세한 내용은 DefaultStyleKey의 설명을 참조하세요. 다른 스타일을 사용하려면 DefaultStyleKey 값을 변경할 필요가 없으며 암시적 스타일 조회와 일치하고 XAML 리소스 로 존재하는 TargetType 이 동일한 고유한 XAML 스타일을 정의하기만 하면 됩니다. 자세한 내용은 컨트롤 템플릿을 참조하세요.

시각적 상태 모델

시각적 상태 모델은 컨트롤의 템플릿에 정의된 몇 가지 속성만 수정하는 기술입니다. 컨트롤이 수행하는 작업을 나타내는 시각적 피드백을 사용자에게 제공하고 가능한 추가 UI 상호 작용에 대한 힌트를 제공하기 위해 속성 값을 변경합니다. 컨트롤은 템플릿의 일부 속성에 기간 0 또는 단기 스토리보드 애니메이션을 적용하여 수정됩니다. 상태 간 전환에 적용되는 단기 애니메이션을 정의할 수도 있습니다.

시각적 상태 자체는 컨트롤 템플릿의 일부로 정의됩니다. 각 시각적 상태에는 이름이 있으므로 컨트롤 논리는 특정 논리 상태에 필요할 때 각 시각적 상태를 로드하는 GoToState 메서드를 호출할 수 있습니다. 시각적 상태는 시각적 상태 그룹 내에서 선언되므로 서로 배타적인 시각적 상태는 한 번에 하나의 상태만 활성화되도록 할 수 있습니다. 동일한 그룹의 다른 시각적 상태가 로드되는 즉시 이전 상태의 애니메이션이 적용되지 않지만 다른 그룹의 애니메이션이 계속 실행되고 변경 내용 및 시각적 동작을 적용할 수 있습니다. 예를 들어 컨트롤에는 키보드 포커스에 대한 시각적 표시기와 포인터 오버에 대한 시각적 표시기가 있을 수 있습니다. 서로 독립적으로 조정할 수 있고 동시에 발생할 수 있는 UI 모드이므로 각각 다른 시각적 상태 그룹에 정의됩니다.

컨트롤 템플릿의 일부로 XAML에 정의되므로 UI에서 사용하는 모든 XAML 컨트롤에 대한 시각적 상태 동작을 변경할 수 있습니다. 그러나 논리는 여전히 특정 시각적 상태 그룹과 명명된 시각적 상태를 찾을 것으로 예상되는 컨트롤을 기반으로 합니다. 따라서 컨트롤 동작의 모든 측면을 사용자에게 표시하는 올바르게 명명되고 구조화된 시각적 상태를 제공하는 데 매우 주의해야 합니다. 자세한 내용은 시각적 상태에 대한 스토리보드 애니메이션을 참조하세요. 시각적 상태는 컨트롤 템플릿에도 간략하게 도입됩니다.

컨트롤의 기본 시각적 상태는 라이브러리 애니메이션을 사용하는 경우가 있습니다. 이러한 애니메이션은 UI에서 컨트롤 모양과 느낌의 중요한 부분이기 때문에 컨트롤 템플릿 또는 시각적 상태를 바꿀 때 라이브러리 애니메이션을 유지하려고 합니다. 자세한 내용은 애니메이션 개요를 참조하세요.

컨트롤 및 포커스

Control 클래스는 Focus 메서드, FocusState 속성, IsEnabledIsTabStop 속성 등 UI의 키보드 포커스 동작에 영향을 주는 여러 API를 정의합니다. 키보드 포커스를 사용하도록 설정하는 것은 각 포커스 가능 요소가 UI에 대한 탭 순서의 일부가 되기 때문에 UI에 액세스할 수 있도록 보장하는 데 중요한 부분입니다. 대화형 UI 요소만 일반적으로 키보드 포커스를 받을 수 있습니다. 예를 들어 TextBox 는 사용자가 텍스트를 입력할 수 있기 때문에 대화형이지만 TextBlock 은 읽기 전용이므로 대화형이 아닙니다. Control에서 파생되는 대부분의 클래스는 합법적으로 대화형이므로 포커스를 맞출 수 있고 탭 순서에 있어야 한다는 것이 합리적입니다.

포커스를 맞추려면 각각 true여야 합니다.

  • 표시 유형표시됩니다.
  • IsEnabledtrue입니다.
  • IsTabStoptrue입니다.
  • 컨트롤이 로드된 템플릿을 사용하여 인스턴스화해야 합니다(로드된 실행됨, 앱의 루트 시각적 개체에 연결된 컨트롤) 컨트롤을 포커스할 수 없도록 하려면 IsTabStopfalse로 설정할 수 있습니다. 그러나 컨트롤에 포커스를 두지 않으려는 이유는 UI에서 대화형이 아니므로 IsEnabledfalse 로 설정하여 모든 사용자에게 상호 작용이 부족하도록 할 수 있습니다. 많은 컨트롤에는 레이블의 텍스트 "회색"과 같이 IsEnabled =false에 대해 호출되는 미리 정의된 시각적 상태가 있습니다.

포커스 변경으로 GotFocus 또는 LostFocus 이벤트가 발생합니다. GetFocusedElement 메서드를 통해 노출되는 "FocusedElement" 값은 즉시 업데이트되지만 GotFocus 또는 LostFocus의 변경 알림은 비 동기적으로 발생합니다. 이 비동기 포커스 디자인은 컨트롤 논리가 포커스 변경에 너무 빨리 반응할 때 시각적 상태 전환이 깜박이는 것을 방지하기 위한 것입니다.

Focus 메서드를 사용하면 키보드 포커스를 프로그래밍 방식으로 컨트롤에 가져올 수 있습니다. 이 메서드를 호출할 때는 사용자가 기대하지 않을 때 키보드 포커스를 이동하는 것이 방해가 될 수 있습니다. 포커스에 대한 기본 시나리오는 UI의 전체 페이지가 로드될 때 첫 번째 키보드 포커스 지점을 설정하거나 부모 컨트롤 컨테이너가 최상위 포커스를 받은 후 컨트롤의 특정 부분으로 포커스를 설정하는 것입니다(예: 콤보 상자의 텍스트 상자 집중). 자세한 내용은 포커스를 참조 하세요. FocusState 는 포커스가 프로그래밍 방식인지 사용자 중심인지를 추적하여 시각적 상태, 특히 모든 컨트롤에 있어야 하는 키보드 포커스에 대한 시각적 포커스 표시기를 만듭니다.

이벤트 이벤트 처리기에서 재정의

OnEvent 메서드는 해당 UIElement 이벤트에 대한 미리 배선된 이벤트 처리기를 나타냅니다. Control에서 파생된 실제 컨트롤은 OnEvent 메서드를 재정의하고 이를 사용하여 해당 입력 이벤트에 대한 컨트롤 관련 처리 및 동작을 제공할 수 있습니다. 가장 일반적인 시나리오는 이벤트 처리기를 사용하여 이벤트를 이벤트 데이터에서 처리됨 으로 표시하는 것입니다. 컨트롤 코드는 컨트롤 instance 연결된 이벤트 처리기가 호출되기 전에 먼저 이 이벤트를 처리할 수 있습니다. 이벤트 데이터가 처리됨으로 표시되면 컨트롤 instance 같은 다른 처리기가 호출되지 않습니다. 또한 이벤트는 거품이 발생하지 않습니다.

Control에서 직접 구현되므로 OnEvent 메서드에는 빈 구현이 있습니다. 그러나 컨트롤의 계층 구조에 있는 각 상위 항목이 구현을 제공했을 수 있습니다. 이 구현은 내부 네이티브 코드이므로 볼 수 없습니다. 경우에 따라 컨트롤에 이미 이벤트 처리됨을 표시하는 기존 OnEvent 재정의가 있습니다. 컨트롤 에 대한 초기 OnEvent 재정의를 제공한 후에는 자체 컨트롤 클래스에서 추가로 파생되는 모든 컨트롤도 정의한 OnEvent 재정의를 상속합니다. 사용하는 모든 인스턴스에도 해당 동작이 있습니다.

참고

앱 코드는 컨트롤의 OnEvent 메서드 논리에 의해 처리됨으로 표시되었을 수 있는 이벤트를 여전히 처리할 수 있지만 UIElement.AddHandler 메서드에 handledEventsToo 매개 변수를 사용해야 합니다. 자세한 내용은 UIElement.AddHandler 또는 이벤트 및 라우트된 이벤트 개요를 참조하세요.

Control 클래스는 각각 프레임워크 수준 입력 이벤트와 연결된 몇 가지 보호된 가상 메서드를 정의합니다. 이러한 메서드는 컨트롤이 해당 컨트롤 및 모든 인스턴스에서 특정 입력 동작을 사용하도록 적용할 수 있도록 입력 이벤트에 대한 사전 유선 이벤트 처리기를 제공하기 위한 것입니다. 예를 들어 UIElement로 정의된 PointerPressed 이벤트가 있습니다. 컨트롤은 빈 정의를 사용하여 OnPointerPressed 메서드를 정의합니다. 기본 컨트롤 생성자 내에서 모든 관련 입력 이벤트에 대한 이벤트 배선에는 처음에는 아무 작업도 수행하지 않는 수신기/처리기로 OnEvent 메서드가 포함됩니다. 그러나 이제 컨트롤 작성자가 입력 이벤트에 대한 동작을 변경하는 데 필요한 것은 OnEvent 메서드에 대한 새 재정의 정의를 제공하는 것입니다(또한 생성자가 기본을 호출하는지 확인). 다른 서브클래서가 다시 재정의하지 않는 한 해당 동작은 모든 인스턴스 또는 서브클래스에 상속됩니다. OnEvent 이벤트는 순서대로 먼저 UI 정의 XAML 전에 이벤트 데이터를 조정하고 다른 수신기가 이벤트에 대해 볼 수 있는 조건을 변경할 수 있습니다.

특정 컨트롤 클래스의 기존 OnEvent 정의는 OnEvent 메서드를 직접 재정의하지 않은 경우에도 컨트롤의 소비자로서 영향을 줄 수 있습니다. 이는 기존 On 이벤트 정의가 일부 이벤트의 이벤트 데이터에서 Handled 속성 값을 true로 설정하는 이벤트에 대한 처리를 제공했기 때문입니다. 그러면 instance 기반 이벤트 처리에서 이벤트가 표시되지 않으며 처리기가 호출되지 않습니다. 여기서 일어나는 일은 컨트롤 논리와 충돌하는 하위 수준 이벤트이거나 컨트롤에 대체 논리가 있기 때문에 특정 이벤트가 컨트롤에 중요하지 않도록 강제하는 의도적인 컨트롤 디자인이 있다는 것입니다. 이 예제의 눈에 띄는 예는 ButtonBase 클래스입니다. ButtonBase 클래스에는 OnPointerPressedOnKeyDown의 네이티브 재정의를 통해 적용하는 두 가지 동작이 있습니다. 낮은 수준에서 다양한 입력 모드를 결합하고 대신 컨트롤별 Click 이벤트로 보고하기 때문에 이 작업을 수행합니다. PointerPressed 이벤트 처리기의 경우 Button instance 처리하려고 하면 처리기가 호출되지 않습니다. 네이티브 OnPointerPressedHandledtrue로 설정하고 PointerPressed가 instance 및 앱 코드로 전파되지 못하게 했기 때문입니다. OnKeyDown의 경우 논리는 특정 키(Ctrl 및 Enter)를 찾고 있었기 때문에 instance 처리기는 해당 키도 찾지 않는 한 계속 호출할 수 있습니다.

참고

실제로 입력 이벤트 중 일부에 대한 입력에 대한 OnEvent 메서드의 네이티브 처리를 해결하는 방법이 있습니다. 이렇게 하려면 handledEventsToo와 함께 AddHandler 메서드를 사용하여 처리기를 연결해야 합니다. 자세한 내용은 AddHandler 또는 이벤트 및 라우트된 이벤트 개요를 참조하세요.

텍스트 요소 부분에 상속되는 텍스트 속성

컨트롤은 텍스트 표시와 관련된 여러 속성을 정의합니다. 이러한 방법은 다음과 같습니다.

물론 모든 컨트롤이 그 안에 텍스트를 표시하기 위한 것은 아닙니다. 예를 들어 AppBarSeparator에서 FontFamily를 설정하는 것은 합법적이지만 전혀 효과가 없습니다. Control이 기본 클래스 수준에서 이러한 속성을 정의하는 이유는 컨트롤 템플릿이 {TemplateBinding} 태그 확장을 쉽게 사용하여 템플릿 내에 있는 하나 이상의 텍스트 요소 부분에 최상위 텍스트 속성을 적용할 수 있도록 하기 위해서입니다. 예를 들어 DatePicker에 대한 컨트롤 템플릿을 보면 루트가 컨테이너이고 해당 컨테이너 내에서 더 깊이는 실제로 텍스트 입력을 사용하는 여러 ComboBox 부분임을 알 수 있습니다. 이러한 각 문은 DatePicker에 설정된 최상위 FontWeight를 내의 다양한 파트에서 사용하는 것과 같은 FontWeight="{TemplateBinding FontWeight}" 문을 사용합니다.

또한 Control의 텍스트 속성은 텍스트를 표시하는 ContentPresenter 가 있는 컨트롤에 대해 암시적으로 상속됩니다. 예를 들어 단추에서 FontSize를 설정하는 경우 템플릿 또는 최상위 FontSize 값으로 템플릿이 수행하는 작업을 제어하는 ContentPresenter 부분에 명시적 {TemplateBinding} 태그 확장이 없습니다. 그러나 Control.FontSize 값은 템플릿 정의 내의 컨텍스트에 따라 ContentPresenter.FontSize 에서 암시적으로 상속되므로 Button 내의 텍스트는 설정한 Control.FontSize 를 사용하여 표시됩니다.

XAML 연결 속성

Control은 여러 XAML 연결 속성에 대한 호스트 서비스 클래스입니다.

연결된 속성에 대한 XAML 프로세서 액세스를 지원하고 동등한 getset 작업을 코드에 노출하기 위해 연결된 각 XAML 속성에는 Get 및 Set 접근자 메서드 쌍이 있습니다. 코드에서 값을 얻거나 설정하는 또 다른 방법은 종속성 속성 시스템을 사용하여 GetValue 또는 SetValue 를 호출하고 식별자 필드를 종속성 속성 식별자로 전달하는 것입니다.

연결된 속성 Description
IsTemplateFocusTarget 이 요소가 포커스 시각적 개체가 있는 컨트롤 템플릿의 일부인지 여부를 나타내는 값을 가져오거나 설정합니다.
IsTemplateKeyTipTarget 이 요소가 가 배치된 컨트롤 템플릿 KeyTip 의 일부인지 여부를 나타내는 값을 가져오거나 설정합니다.

버전 기록

Windows 버전 SDK 버전 추가된 값
1607 14393 ElementSoundMode
1607 14393 FocusDisengaged
1607 14393 FocusEngaged
1607 14393 IsFocusEngaged
1607 14393 IsFocusEngagementEnabled
1607 14393 RemoveFocusEngagement
1607 14393 RequiresPointer
1607 14393 XYFocusDown
1607 14393 XYFocusLeft
1607 14393 XYFocusRight
1607 14393 XYFocusUp
1703 15063 DefaultStyleResourceUri
1703 15063 GetIsTemplateKeyTipTarget
1703 15063 SetIsTemplateKeyTipTarget
1709 16299 OnCharacterReceived
1709 16299 OnPreviewKeyDown
1709 16299 OnPreviewKeyUp
1809 17763 BackgroundSizing
1809 17763 CornerRadius

생성자

Control()

컨트롤 파생 클래스에 대한 기본 클래스 초기화 동작을 제공합니다.

속성

AccessKey

이 요소의 액세스 키(니모닉)를 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
AccessKeyScopeOwner

원본 요소의 시각적 트리에 없는 경우에도 이 요소에 대한 액세스 키 scope 제공하는 원본 요소를 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
ActualHeight

FrameworkElement의 렌더링된 높이를 가져옵니다. 설명 부분을 참조하세요.

(다음에서 상속됨 FrameworkElement)
ActualOffset

레이아웃 프로세스의 정렬 단계 중에 계산된 부모에 상대적인 이 UIElement의 위치를 가져옵니다.

(다음에서 상속됨 UIElement)
ActualSize

레이아웃 프로세스의 정렬 단계에서 이 UIElement가 계산한 크기를 가져옵니다.

(다음에서 상속됨 UIElement)
ActualTheme

RequestedTheme과 다를 수 있는 요소에서 현재 사용되는 UI 테마를 가져옵니다.

(다음에서 상속됨 FrameworkElement)
ActualWidth

FrameworkElement의 렌더링된 너비를 가져옵니다. 설명 부분을 참조하세요.

(다음에서 상속됨 FrameworkElement)
AllowDrop

끌어서 놓기 작업을 위해 이 UIElement 가 놓기 대상이 될 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
AllowFocusOnInteraction

사용자가 상호 작용할 때 요소가 자동으로 포커스를 가져오는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
AllowFocusWhenDisabled

비활성화된 컨트롤이 포커스를 받을 수 있는지 여부를 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
Background

컨트롤의 배경을 제공하는 브러시를 가져오거나 설정합니다.

BackgroundProperty

Background 종속성 속성을 식별합니다.

BackgroundSizing

이 요소의 테두리와 관련하여 배경이 확장되는 정도를 나타내는 값을 가져오거나 설정합니다.

BackgroundSizingProperty

BackgroundSizing 종속성 속성을 식별합니다.

BaseUri

XAML 로드 시 XAML 생성 개체의 기본 URI(Uniform Resource Identifier)를 나타내는 URI(Uniform Resource Identifier)를 가져옵니다. 이 속성은 런타임에 URI(Uniform Resource Identifier) 확인에 유용합니다.

(다음에서 상속됨 FrameworkElement)
BorderBrush

컨트롤의 테두리 채우기를 설명하는 브러시를 가져오거나 설정합니다.

BorderBrushProperty

BorderBrush 종속성 속성을 식별합니다.

BorderThickness

컨트롤의 테두리 두께를 가져오거나 설정합니다.

BorderThicknessProperty

BorderThickness 종속성 속성을 식별합니다.

CacheMode

가능한 경우 렌더링된 콘텐츠를 복합 비트맵으로 캐시해야 했음을 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
CanBeScrollAnchor

UIElement가 스크롤 앵커링 후보가 될 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
CanDrag

요소를 끌어서 놓기 작업에서 데이터로 끌 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
CenterPoint

회전 또는 크기 조정이 발생하는 지점인 요소의 중심점을 가져오거나 설정합니다. 요소의 렌더링 위치에 영향을 줍니다.

(다음에서 상속됨 UIElement)
CharacterSpacing

문자 간의 균일한 간격을 1/1000 단위로 가져오거나 설정합니다.

CharacterSpacingProperty

CharacterSpacing 종속성 속성을 식별합니다.

Clip

UIElement 콘텐츠의 윤곽선을 정의하는 데 사용되는 RectangleGeometry를 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
CompositeMode

부모 레이아웃 및 창에서 요소에 대한 대체 컴퍼지션 및 혼합 모드를 선언하는 속성을 가져오거나 설정합니다. 이는 혼합 XAML/Microsoft DirectX UI와 관련된 요소와 관련이 있습니다.

(다음에서 상속됨 UIElement)
ContextFlyout

이 요소와 연결된 플라이아웃을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
CornerRadius

컨트롤 테두리의 모서리에 대한 반경을 가져오거나 설정합니다.

CornerRadiusProperty

CornerRadius 종속성 속성을 식별합니다.

DataContext

FrameworkElement에 대한 데이터 컨텍스트를 가져오거나 설정합니다. 데이터 컨텍스트의 일반적인 사용은 FrameworkElement{Binding} 태그 확장을 사용하고 데이터 바인딩에 참여하는 경우입니다.

(다음에서 상속됨 FrameworkElement)
DefaultStyleKey

컨트롤의 기본 스타일을 참조하는 키를 가져오거나 설정합니다. 사용자 지정 컨트롤 작성자는 이 속성을 사용하여 컨트롤에서 사용하는 스타일의 기본값을 변경합니다.

DefaultStyleKeyProperty

DefaultStyleKey 종속성 속성을 식별합니다.

DefaultStyleResourceUri

컨트롤의 기본 스타일을 포함하는 리소스 파일의 경로를 가져오거나 설정합니다.

DefaultStyleResourceUriProperty

DefaultStyleResourceUri 종속성 속성을 식별합니다.

DesiredSize

레이아웃 프로세스의 측정 단계에서 이 UIElement 가 계산한 크기를 가져옵니다.

(다음에서 상속됨 UIElement)
Dispatcher

이 개체가 연결된 CoreDispatcher 를 가져옵니다. CoreDispatcher는 코드가 비 UI 스레드에서 시작되더라도 UI 스레드에서 DependencyObject에 액세스할 수 있는 기능을 나타냅니다.

(다음에서 상속됨 DependencyObject)
ElementSoundMode

소리 재생 여부에 대한 컨트롤의 기본 설정을 지정하는 값을 가져오거나 설정합니다.

ElementSoundModeProperty

ElementSoundMode 종속성 속성을 식별합니다.

ExitDisplayModeOnAccessKeyInvoked

액세스 키를 호출할 때 액세스 키 표시가 해제되는지 여부를 지정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
FlowDirection

레이아웃을 제어하는 부모 요소 내에서 텍스트 및 기타 UI 요소가 흐르는 방향을 가져오거나 설정합니다. 이 속성은 LeftToRight 또는 RightToLeft로 설정할 수 있습니다. 모든 요소에서 FlowDirection을 RightToLeft 로 설정하면 오른쪽 맞춤, 읽기 순서를 오른쪽에서 왼쪽으로, 오른쪽에서 왼쪽으로 흐르는 컨트롤의 레이아웃이 설정됩니다.

(다음에서 상속됨 FrameworkElement)
FocusState

이 컨트롤에 포커스가 있는지 여부와 포커스를 얻은 모드를 지정하는 값을 가져옵니다.

FocusStateProperty

FocusState 종속성 속성을 식별합니다.

FocusVisualMargin

FrameworkElement에 대한 포커스 시각적 개체의 외부 여백을 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
FocusVisualPrimaryBrush

FrameworkElement에 대한 또는 포커스 시각적 개체의 바깥 테두리를 HighVisibility 그리는 데 사용되는 브러시를 가져오거나 Reveal 설정합니다.

(다음에서 상속됨 FrameworkElement)
FocusVisualPrimaryThickness

FrameworkElement에 대한 또는 포커스 시각적 개체의 HighVisibility 외부 테두리 두께를 가져오거나 Reveal 설정합니다.

(다음에서 상속됨 FrameworkElement)
FocusVisualSecondaryBrush

FrameworkElement에 대한 또는 포커스 시각적 개체의 안쪽 테두리를 HighVisibility 그리는 데 사용되는 브러시를 가져오거나 Reveal 설정합니다.

(다음에서 상속됨 FrameworkElement)
FocusVisualSecondaryThickness

FrameworkElement에 대한 또는 포커스 시각적 개체의 HighVisibility 내부 테두리 두께를 가져오거나 Reveal 설정합니다.

(다음에서 상속됨 FrameworkElement)
FontFamily

컨트롤에 텍스트를 표시하는 데 사용되는 글꼴을 가져오거나 설정합니다.

FontFamilyProperty

FontFamily 종속성 속성을 식별합니다.

FontSize

이 컨트롤의 텍스트 크기를 가져오거나 설정합니다.

FontSizeProperty

FontSize 종속성 속성을 식별합니다.

FontStretch

글꼴의 너비 값을 가져오거나 설정합니다.

FontStretchProperty

FontStretch 종속성 속성을 식별합니다.

FontStyle

텍스트가 렌더링되는 스타일을 가져오거나 설정합니다.

FontStyleProperty

FontStyle 종속성 속성을 식별합니다.

FontWeight

지정된 글꼴의 두께를 가져오거나 설정합니다.

FontWeightProperty

FontWeight 종속성 속성을 식별합니다.

Foreground

전경색을 설명하는 브러시를 가져오거나 설정합니다.

ForegroundProperty

포그라운드 종속성 속성을 식별합니다.

Height

FrameworkElement의 제안된 높이를 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
HighContrastAdjustment

고대비 테마를 사용할 때 프레임워크가 요소의 시각적 속성을 자동으로 조정하는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
HorizontalAlignment

패널 또는 항목 컨트롤과 같은 레이아웃 부모에서 작성될 때 FrameworkElement 에 적용되는 가로 맞춤 특성을 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
HorizontalContentAlignment

컨트롤 콘텐츠의 가로 맞춤을 가져오거나 설정합니다.

HorizontalContentAlignmentProperty

HorizontalContentAlignment 종속성 속성을 식별합니다.

IsAccessKeyScope

요소가 자체 액세스 키 scope 정의하는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
IsDoubleTapEnabled

DoubleTapped 이벤트가 해당 요소에서 발생할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
IsEnabled

사용자가 컨트롤과 상호 작용할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.

IsEnabledProperty

IsEnabled 종속성 속성을 식별합니다.

IsFocusEngaged

컨트롤 경계 내에서 포커스가 제한되는지 여부를 나타내는 값을 얻거나 설정합니다(게임 패드/원격 상호 작용용).

IsFocusEngagedProperty

IsFocusEngaged 종속성 속성을 식별합니다.

IsFocusEngagementEnabled

컨트롤 경계 내에서 포커스를 제한할 수 있는지 여부를 나타내는 값을 얻거나 설정합니다(게임 패드/원격 상호 작용용).

IsFocusEngagementEnabledProperty

IsFocusEngagementEnabled 종속성 속성을 식별합니다.

IsHitTestVisible

UIElement 의 포함된 영역이 적중 횟수 테스트를 위해 실제 값을 반환할 수 있는지 여부를 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
IsHoldingEnabled

Holding 이벤트가 해당 요소에서 발생할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
IsLoaded

요소가 요소 트리에 추가되고 상호 작용할 준비가 되었는지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 FrameworkElement)
IsRightTapEnabled

RightTapped 이벤트가 해당 요소에서 발생할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
IsTabStop

컨트롤이 탭 탐색에 포함되는지 여부를 나타내는 값을 가져오거나 설정합니다.

IsTabStopProperty

IsTabStop 종속성 속성을 식별합니다.

IsTapEnabled

Tapped 이벤트가 해당 요소에서 발생할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
IsTemplateFocusTargetProperty

Control.IsTemplateFocusTarget XAML 연결된 속성을 식별합니다.

IsTemplateKeyTipTargetProperty

Control.IsTemplateKeyTipTarget XAML 연결된 속성을 식별합니다.

IsTextScaleFactorEnabled

시스템 텍스트 크기 설정을 반영하기 위해 자동 텍스트 확대를 사용할지 여부를 가져오거나 설정합니다.

IsTextScaleFactorEnabledProperty

IsTextScaleFactorEnabled 종속성 속성을 식별합니다.

KeyboardAcceleratorPlacementMode

컨트롤 도구 설명 에 연결된 키보드 가속기 키 조합이 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
KeyboardAcceleratorPlacementTarget

가속기 키 조합을 표시하는 컨트롤 도구 설명을 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
KeyboardAccelerators

키보드를 사용하여 작업을 호출하는 키 조합의 컬렉션을 가져옵니다.

가속기는 일반적으로 단추 또는 메뉴 항목에 할당됩니다.

다양한 메뉴 항목에 대한 키보드 가속기를 보여 주는 메뉴의 예
다양한 메뉴 항목에 대한 키보드 가속기를 보여 주는 메뉴의 예

(다음에서 상속됨 UIElement)
KeyTipHorizontalOffset

키 팁이 UIElement와 관련하여 배치되는 간격을 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
KeyTipPlacementMode

UIElement 경계와 관련하여 액세스 키 키 팁이 배치되는 위치를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
KeyTipTarget

액세스 키 키 팁이 대상으로 하는 요소를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
KeyTipVerticalOffset

키 팁이 UI 요소와 관련하여 배치되는 거리를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
Language

FrameworkElement 및 개체 표현 및 UI에서 현재 FrameworkElement의 모든 자식 요소에도 적용되는 지역화/세계화 언어 정보를 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
Lights

이 요소에 연결된 XamlLight 개체의 컬렉션을 가져옵니다.

(다음에서 상속됨 UIElement)
ManipulationMode

UIElement 동작 및 제스처와의 상호 작용에 사용되는 ManipulationModes 값을 가져오거나 설정합니다. 이 값을 설정하면 앱 코드에서 이 요소의 조작 이벤트를 처리할 수 있습니다.

(다음에서 상속됨 UIElement)
Margin

FrameworkElement의 외부 여백을 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
MaxHeight

FrameworkElement의 최대 높이 제약 조건을 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
MaxWidth

FrameworkElement의 최대 너비 제약 조건을 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
MinHeight

FrameworkElement의 최소 높이 제약 조건을 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
MinWidth

FrameworkElement의 최소 너비 제약 조건을 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
Name

개체의 식별 이름을 가져오거나 설정합니다. XAML 프로세서가 XAML 태그에서 개체 트리를 만드는 경우 런타임 코드는 이 이름으로 XAML 선언 개체를 참조할 수 있습니다.

(다음에서 상속됨 FrameworkElement)
Opacity

개체의 불투명도를 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
OpacityTransition

Opacity 속성의 변경 내용에 애니메이션 효과를 주는 ScalarTransition을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
Padding

컨트롤의 안쪽 여백 속성을 가져오거나 설정합니다.

PaddingProperty

Padding 종속성 속성을 식별합니다.

Parent

개체 트리에서 이 FrameworkElement 의 부모 개체를 가져옵니다.

(다음에서 상속됨 FrameworkElement)
PointerCaptures

포인터 값으로 표시되는 캡처된 모든 포인터의 집합 가져옵니다.

(다음에서 상속됨 UIElement)
Projection

이 요소를 렌더링할 때 적용할 원근 투영(3차원 효과)을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
RenderSize

UIElement의 최종 렌더링 크기를 가져옵니다. 사용은 권장되지 않습니다. 주의 사항을 참조하세요.

(다음에서 상속됨 UIElement)
RenderTransform

UIElement의 렌더링 위치에 영향을 주는 변환 정보를 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
RenderTransformOrigin

RenderTransform에서 선언한 가능한 렌더링 변환의 원점을 가져오거나 설정하며 UIElement의 범위를 기준으로 합니다.

(다음에서 상속됨 UIElement)
RequestedTheme

리소스 결정에 UIElement (및 해당 자식 요소)에서 사용되는 UI 테마를 가져오거나 설정합니다. RequestedTheme로 지정한 UI 테마는 앱 수준 RequestedTheme을 재정의할 수 있습니다.

(다음에서 상속됨 FrameworkElement)
RequiresPointer

UI 요소가 게임 패드 또는 원격 제어와 같은 비 포인터 입력 디바이스를 사용하여 포인터 상호 작용 환경을 에뮬레이트하는 마우스 모드를 지원하는지 여부를 가져오거나 설정합니다.

RequiresPointerProperty

RequiresPointer 종속성 속성을 식별합니다.

Resources

로컬로 정의된 리소스 사전을 가져옵니다. XAML에서는 XAML 암시적 컬렉션 구문을 통해 리소스 항목을 속성 요소의 frameworkElement.Resources 자식 개체 요소로 설정할 수 있습니다.

(다음에서 상속됨 FrameworkElement)
Rotation

시계 방향 회전 각도를 도 단위로 가져오거나 설정합니다. RotationAxis 및 CenterPoint를 기준으로 회전합니다. 요소의 렌더링 위치에 영향을 줍니다.

(다음에서 상속됨 UIElement)
RotationAxis

요소를 회전할 축을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
RotationTransition

Rotation 속성의 변경 내용에 애니메이션 효과를 주는 ScalarTransition을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
Scale

요소의 배율을 가져오거나 설정합니다. 요소의 CenterPoint를 기준으로 크기를 조정합니다. 요소의 렌더링 위치에 영향을 줍니다.

(다음에서 상속됨 UIElement)
ScaleTransition

Scale 속성에 대한 변경 내용에 애니메이션 효과를 주는 Vector3Transition을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
Shadow

요소에 의해 캐스팅된 그림자 효과를 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
Style

레이아웃 및 렌더링 중에 이 개체에 적용되는 instance Style을 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
TabFocusNavigation

이 컨트롤에 대한 탭 및 TabIndex 작동 방식을 수정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
TabIndex

사용자가 Tab 키를 사용하여 앱 UI를 탐색할 때 요소가 포커스를 받는 순서를 나타내는 값을 가져오거나 설정합니다.

TabIndexProperty

TabIndex 종속성 속성을 식별합니다.

TabNavigation

이 컨트롤에 대한 탭 및 TabIndex 작동 방식을 수정하는 값을 가져오거나 설정합니다.

참고

Windows 10 크리에이터스 업데이트(빌드 10.0.15063) 이상에서는 UIElement 기본 클래스에서 TabFocusNavigation 속성을 사용하여 ControlTemplate을 사용하지 않는 탭 시퀀스에 개체를 포함할 수 있습니다.

TabNavigationProperty

TabNavigation 종속성 속성을 식별합니다.

Tag

이 개체에 대한 사용자 지정 정보를 저장하는 데 사용할 수 있는 임의의 개체 값을 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
Template

컨트롤 템플릿을 가져오거나 설정합니다. 컨트롤 템플릿은 UI에서 컨트롤의 시각적 모양을 정의하고 XAML 태그에 정의됩니다.

TemplateProperty

Template 종속성 속성을 식별합니다.

Transform3D

이 요소를 렌더링할 때 적용할 3차원 변환 효과를 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
TransformMatrix

요소에 적용할 변환 행렬을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
Transitions

UIElement에 적용되는 전환 스타일 요소의 컬렉션을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
Translation

요소의 x, y 및 z 렌더링 위치를 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
TranslationTransition

Translation 속성에 대한 변경 내용에 애니메이션 효과를 주는 Vector3Transition을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
Triggers

FrameworkElement에 대해 정의된 애니메이션에 대한 트리거 컬렉션을 가져옵니다. 일반적으로 사용되지 않습니다. 설명 부분을 참조하세요.

(다음에서 상속됨 FrameworkElement)
UIContext

요소의 컨텍스트 식별자를 가져옵니다.

(다음에서 상속됨 UIElement)
UseLayoutRounding

개체 및 시각적 하위 트리에 대한 렌더링이 렌더링을 전체 픽셀에 맞추는 반올림 동작을 사용해야 하는지 여부를 결정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
UseSystemFocusVisuals

컨트롤이 시스템에서 그린 포커스 시각적 개체 또는 컨트롤 템플릿에 정의된 포커스 시각적 개체를 사용하는지 여부를 나타내는 값을 가져오거나 설정합니다.

UseSystemFocusVisualsProperty

UseSystemFocusVisuals 종속성 속성을 식별합니다.

VerticalAlignment

패널 또는 항목 컨트롤과 같은 부모 개체에서 작성될 때 FrameworkElement 에 적용되는 세로 맞춤 특성을 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
VerticalContentAlignment

컨트롤 콘텐츠의 세로 맞춤을 가져오거나 설정합니다.

VerticalContentAlignmentProperty

VerticalContentAlignment 종속성 속성을 식별합니다.

Visibility

UIElement의 표시 유형을 가져오거나 설정합니다. 표시되지 않는 UIElement 는 렌더링되지 않으며 원하는 크기를 레이아웃에 전달하지 않습니다.

(다음에서 상속됨 UIElement)
Width

FrameworkElement의 너비를 가져오거나 설정합니다.

(다음에서 상속됨 FrameworkElement)
XamlRoot

이 요소를 볼 을 가져오거나 설정합니다 XamlRoot .

(다음에서 상속됨 UIElement)
XYFocusDown

사용자가 방향 패드(D 패드)를 누를 때 포커스를 가져오는 개체를 가져오거나 설정합니다.

XYFocusDownNavigationStrategy

아래쪽 탐색의 대상 요소를 결정하는 데 사용되는 전략을 지정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
XYFocusDownProperty

XYFocusDown 종속성 속성을 식별합니다.

XYFocusKeyboardNavigation

키보드 방향 화살표를 사용하여 탐색을 사용하거나 사용하지 않도록 설정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
XYFocusLeft

사용자가 방향 패드(D 패드)를 왼쪽으로 누를 때 포커스를 가져오는 개체를 가져오거나 설정합니다.

XYFocusLeftNavigationStrategy

왼쪽 탐색의 대상 요소를 결정하는 데 사용되는 전략을 지정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
XYFocusLeftProperty

XYFocusLeft 종속성 속성을 식별합니다.

XYFocusRight

사용자가 방향 패드(D 패드)를 오른쪽으로 누를 때 포커스를 가져오는 개체를 가져오거나 설정합니다.

XYFocusRightNavigationStrategy

오른쪽 탐색의 대상 요소를 결정하는 데 사용되는 전략을 지정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
XYFocusRightProperty

XYFocusRight 종속성 속성을 식별합니다.

XYFocusUp

사용자가 방향 패드(D 패드)를 누를 때 포커스를 가져오는 개체를 가져오거나 설정합니다.

XYFocusUpNavigationStrategy

위쪽 탐색의 대상 요소를 결정하는 데 사용되는 전략을 지정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 UIElement)
XYFocusUpProperty

XYFocusUp 종속성 속성을 식별합니다.

연결된 속성

IsTemplateFocusTarget

이 요소가 포커스 시각적 개체가 있는 컨트롤 템플릿의 일부인지 여부를 나타내는 값을 가져오거나 설정합니다.

IsTemplateKeyTipTarget

이 요소가 KeyTip이 배치된 컨트롤 템플릿의 일부인지 여부를 나타내는 값을 가져오거나 설정합니다.

메서드

AddHandler(RoutedEvent, Object, Boolean)

지정된 라우트된 이벤트에 대해 라우트된 이벤트 처리기를 추가하여 해당 처리기를 현재 요소의 처리기 컬렉션에 추가합니다. event가 다른 곳에서 처리되더라도 제공된 처리기를 호출하도록 handledEventsTootrue 로 지정합니다.

(다음에서 상속됨 UIElement)
ApplyTemplate()

해당 부분을 참조할 수 있도록 관련 컨트롤 템플릿을 로드합니다.

Arrange(Rect)

자식 개체를 배치하고 UIElement의 크기를 결정합니다. 자식 요소에 대한 사용자 지정 레이아웃을 구현하는 부모 개체는 레이아웃 재정의 구현에서 이 메서드를 호출하여 재귀 레이아웃 업데이트를 구성해야 합니다.

(다음에서 상속됨 UIElement)
ArrangeOverride(Size)

레이아웃의 "정렬" 패스에 대한 동작을 제공합니다. 클래스는 이 메서드를 재정의하여 고유한 "정렬" 패스 동작을 정의할 수 있습니다.

(다음에서 상속됨 FrameworkElement)
CancelDirectManipulations()

현재 UIElement가 포함된 ScrollViewer 부모에서 진행 중인 직접 조작 처리(시스템 정의 이동/확대/축소)를 취소합니다.

(다음에서 상속됨 UIElement)
CapturePointer(Pointer)

포인터 캡처를 UIElement로 설정합니다. 캡처된 후에는 캡처가 있는 요소만 포인터 관련 이벤트를 발생합니다.

(다음에서 상속됨 UIElement)
ClearValue(DependencyProperty)

종속성 속성의 로컬 값을 지웁니다.

(다음에서 상속됨 DependencyObject)
FindName(String)

지정된 식별자 이름이 있는 개체를 검색합니다.

(다음에서 상속됨 FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)

UIElement 하위 클래스가 터치 대상 지정을 해결하는 데 도움이 되는 자식 요소를 노출할 수 있도록 합니다.

(다음에서 상속됨 UIElement)
Focus(FocusState)

컨트롤에 포커스를 설정하려고 시도합니다.

GetAnimationBaseValue(DependencyProperty)

애니메이션이 활성화되지 않은 경우에 적용되는 종속성 속성에 대해 설정된 기본 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
GetBindingExpression(DependencyProperty)

지정된 속성의 바인딩을 나타내는 BindingExpression 을 반환합니다.

(다음에서 상속됨 FrameworkElement)
GetChildrenInTabFocusOrder()

UIElement 하위 클래스가 Tab 포커스에 참여하는 자식 요소를 노출할 수 있도록 합니다.

(다음에서 상속됨 UIElement)
GetIsTemplateFocusTarget(FrameworkElement)

대상 요소에 대한 Control.IsTemplateFocusTarget XAML 연결 속성의 값을 가져옵니다.

GetIsTemplateKeyTipTarget(DependencyObject)

대상 요소에 대한 Control.IsTemplateKeyTipTarget XAML 연결 속성의 값을 가져옵니다.

GetTemplateChild(String)

인스턴스화된 ControlTemplate 시각적 트리에서 명명된 요소를 검색합니다.

GetValue(DependencyProperty)

DependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
GoToElementStateCore(String, Boolean)

파생 클래스에서 구현되는 경우 컨트롤 시작 시 모든 상태에 대해 XAML을 로드하는 대신 코드에서 컨트롤 템플릿에 대한 시각적 트리의 상태별 생성을 사용하도록 설정합니다.

(다음에서 상속됨 FrameworkElement)
InvalidateArrange()

UIElement의 정렬 상태(레이아웃)를 무효화합니다. 무효화 후 UIElement 의 레이아웃이 업데이트되어 비동기적으로 발생합니다.

(다음에서 상속됨 UIElement)
InvalidateMeasure()

UIElement의 측정 상태(레이아웃)를 무효화합니다.

(다음에서 상속됨 UIElement)
InvalidateViewport()

유효 뷰포트를 계산하는 데 사용되는 UIElement뷰포트 상태를 무효화합니다.

(다음에서 상속됨 FrameworkElement)
Measure(Size)

UIElementDesiredSize를 업데이트. 일반적으로 레이아웃 자식에 대한 사용자 지정 레이아웃을 구현하는 개체는 자체 MeasureOverride 구현에서 이 메서드를 호출하여 재귀 레이아웃 업데이트를 형성합니다.

(다음에서 상속됨 UIElement)
MeasureOverride(Size)

레이아웃 주기의 "측정값" 패스에 대한 동작을 제공합니다. 클래스는 이 메서드를 재정의하여 고유한 "측정값" 패스 동작을 정의할 수 있습니다.

(다음에서 상속됨 FrameworkElement)
OnApplyTemplate()

애플리케이션 코드 또는 내부 프로세스(예: 다시 빌드 레이아웃 패스)가 ApplyTemplate을 호출할 때마다 호출됩니다. 즉, UI 요소가 앱에 표시되기 직전에 메서드가 호출됩니다. 클래스의 기본 템플릿 후 논리에 영향을 주도록 이 메서드를 재정의합니다.

(다음에서 상속됨 FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)

BringIntoViewRequested 이벤트가 발생하기 전에 호출됩니다.

(다음에서 상속됨 UIElement)
OnCharacterReceived(CharacterReceivedRoutedEventArgs)

CharacterReceived 이벤트가 발생하기 전에 호출됩니다.

OnCreateAutomationPeer()

파생 클래스에서 구현되는 경우 는 Microsoft UI 자동화 인프라에 대한 클래스별 AutomationPeer 구현을 반환합니다.

(다음에서 상속됨 UIElement)
OnDisconnectVisualChildren()

클래스별 콘텐츠 또는 자식 속성에서 항목을 제거할 때 레이아웃 및 논리가 작동하는 방식을 구현하려면 이 메서드를 재정의합니다.

(다음에서 상속됨 UIElement)
OnDoubleTapped(DoubleTappedRoutedEventArgs)

DoubleTapped 이벤트가 발생하기 전에 호출됩니다.

OnDragEnter(DragEventArgs)

DragEnter 이벤트가 발생하기 전에 호출됩니다.

OnDragLeave(DragEventArgs)

DragLeave 이벤트가 발생하기 전에 호출됩니다.

OnDragOver(DragEventArgs)

DragOver 이벤트가 발생하기 전에 호출됩니다.

OnDrop(DragEventArgs)

Drop 이벤트가 발생하기 전에 호출됩니다.

OnGotFocus(RoutedEventArgs)

GotFocus 이벤트가 발생하기 전에 호출됩니다.

OnHolding(HoldingRoutedEventArgs)

Holding 이벤트가 발생하기 전에 호출됩니다.

OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)

앱에서 바로 가기 키(또는 가속기) 가 처리될 때 호출됩니다. 키보드 가속기가 호출될 때 앱이 응답하는 방법을 처리하도록 이 메서드를 재정의합니다.

(다음에서 상속됨 UIElement)
OnKeyDown(KeyRoutedEventArgs)

KeyDown 이벤트가 발생하기 전에 호출됩니다.

OnKeyUp(KeyRoutedEventArgs)

KeyUp 이벤트가 발생하기 전에 호출됩니다.

OnLostFocus(RoutedEventArgs)

LostFocus 이벤트가 발생하기 전에 호출됩니다.

OnManipulationCompleted(ManipulationCompletedRoutedEventArgs)

ManipulationCompleted 이벤트가 발생하기 전에 호출됩니다.

OnManipulationDelta(ManipulationDeltaRoutedEventArgs)

ManipulationDelta 이벤트가 발생하기 전에 호출됩니다.

OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs)

ManipulationInertiaStarting 이벤트가 발생하기 전에 호출됩니다.

OnManipulationStarted(ManipulationStartedRoutedEventArgs)

ManipulationStarted 이벤트가 발생하기 전에 호출됩니다.

OnManipulationStarting(ManipulationStartingRoutedEventArgs)

ManipulationStarting 이벤트가 발생하기 전에 호출됩니다.

OnPointerCanceled(PointerRoutedEventArgs)

PointerCanceled 이벤트가 발생하기 전에 호출됩니다.

OnPointerCaptureLost(PointerRoutedEventArgs)

PointerCaptureLost 이벤트가 발생하기 전에 호출됩니다.

OnPointerEntered(PointerRoutedEventArgs)

PointerEntered 이벤트가 발생하기 전에 호출됩니다.

OnPointerExited(PointerRoutedEventArgs)

PointerExited 이벤트가 발생하기 전에 호출됩니다.

OnPointerMoved(PointerRoutedEventArgs)

PointerMoved 이벤트가 발생하기 전에 호출됩니다.

OnPointerPressed(PointerRoutedEventArgs)

PointerPressed 이벤트가 발생하기 전에 호출됩니다.

OnPointerReleased(PointerRoutedEventArgs)

PointerReleased 이벤트가 발생하기 전에 호출됩니다.

OnPointerWheelChanged(PointerRoutedEventArgs)

PointerWheelChanged 이벤트가 발생하기 전에 호출됩니다.

OnPreviewKeyDown(KeyRoutedEventArgs)

PreviewKeyDown 이벤트가 발생하기 전에 호출됩니다.

OnPreviewKeyUp(KeyRoutedEventArgs)

PreviewKeyUp 이벤트가 발생하기 전에 호출됩니다.

OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

바로 가기 키(또는 가속기) 가 앱에서 처리되기 직전에 호출됩니다. 애플리케이션 코드 또는 내부 프로세스가 ProcessKeyboardAccelerators를 호출할 때마다 호출됩니다. 기본 가속기 처리에 영향을 주도록 이 메서드를 재정의합니다.

(다음에서 상속됨 UIElement)
OnRightTapped(RightTappedRoutedEventArgs)

RightTapped 이벤트가 발생하기 전에 호출됩니다.

OnTapped(TappedRoutedEventArgs)

Tapped 이벤트가 발생하기 전에 호출됩니다.

PopulatePropertyInfo(String, AnimationPropertyInfo)

애니메이션 효과를 주는 속성을 정의합니다.

(다음에서 상속됨 UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

파생 클래스에서 재정의되는 경우 애니메이션 효과를 주는 속성을 정의합니다.

(다음에서 상속됨 UIElement)
ReadLocalValue(DependencyProperty)

로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

DependencyObject instance 특정 DependencyProperty에 대한 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다.

(다음에서 상속됨 DependencyObject)
ReleasePointerCapture(Pointer)

UIElement에서 특정 포인터 하나를 캡처하기 위한 포인터 캡처를 해제합니다.

(다음에서 상속됨 UIElement)
ReleasePointerCaptures()

이 요소가 보유한 모든 포인터 캡처를 해제합니다.

(다음에서 상속됨 UIElement)
RemoveFocusEngagement()

포커스 참여가 있는 컨트롤의 컨트롤 경계에서 포커스를 해제합니다(게임 패드/원격 상호 작용용).

RemoveHandler(RoutedEvent, Object)

UIElement에서 지정된 라우트된 이벤트 처리기를 제거합니다. 일반적으로 해당 처리기는 AddHandler에 의해 추가되었습니다.

(다음에서 상속됨 UIElement)
SetBinding(DependencyProperty, BindingBase)

제공된 바인딩 개체를 사용하여 FrameworkElement에 바인딩을 연결합니다.

(다음에서 상속됨 FrameworkElement)
SetIsTemplateFocusTarget(FrameworkElement, Boolean)

대상 요소에 대한 Control.IsTemplateFocusTarget XAML 연결 속성의 값을 설정합니다.

SetIsTemplateKeyTipTarget(DependencyObject, Boolean)

대상 요소에 대한 Control.IsTemplateKeyTipTarget XAML 연결 속성의 값을 설정합니다.

SetValue(DependencyProperty, Object)

DependencyObject에 대한 종속성 속성의 로컬 값을 설정합니다.

(다음에서 상속됨 DependencyObject)
StartAnimation(ICompositionAnimationBase)

요소에서 지정된 애니메이션을 시작합니다.

(다음에서 상속됨 UIElement)
StartBringIntoView()

XAML 프레임워크에 대한 요청을 시작하여 포함된 스크롤 가능한 영역 내에서 요소를 보기로 가져옵니다.

(다음에서 상속됨 UIElement)
StartBringIntoView(BringIntoViewOptions)

지정된 옵션을 사용하여 요소를 보기로 가져오는 XAML 프레임워크에 대한 요청을 시작합니다.

(다음에서 상속됨 UIElement)
StartDragAsync(PointerPoint)

끌어서 놓기 작업을 시작합니다.

(다음에서 상속됨 UIElement)
StopAnimation(ICompositionAnimationBase)

요소에서 지정된 애니메이션을 중지합니다.

(다음에서 상속됨 UIElement)
TransformToVisual(UIElement)

UIElement에서 지정된 개체로 좌표를 변환하는 데 사용할 수 있는 변환 개체를 반환합니다.

(다음에서 상속됨 UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

바로 가기 키에 대한 UIElement의 전체 시각적 트리를 검색하여 바로 가기 키(또는 가속기) 를 호출하려고 시도합니다.

(다음에서 상속됨 UIElement)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

RegisterPropertyChangedCallback을 호출하여 이전에 등록된 변경 알림을 취소합니다.

(다음에서 상속됨 DependencyObject)
UpdateLayout()

레이아웃에 대해 UIElement 의 자식 개체의 모든 위치가 제대로 업데이트되었는지 확인합니다.

(다음에서 상속됨 UIElement)

이벤트

AccessKeyDisplayDismissed

액세스 키를 더 이상 표시하지 않아야 하는 경우에 발생합니다.

(다음에서 상속됨 UIElement)
AccessKeyDisplayRequested

사용자가 액세스 키를 표시할 것을 요청할 때 발생합니다.

(다음에서 상속됨 UIElement)
AccessKeyInvoked

사용자가 액세스 키 시퀀스를 완료할 때 발생합니다.

(다음에서 상속됨 UIElement)
ActualThemeChanged

ActualTheme 속성 값이 변경된 경우에 발생합니다.

(다음에서 상속됨 FrameworkElement)
BringIntoViewRequested

이 요소 또는 해당 하위 항목 중 하나에서 StartBringIntoView 가 호출될 때 발생합니다.

(다음에서 상속됨 UIElement)
CharacterReceived

입력 큐에서 구성된 단일 문자를 수신할 때 발생합니다.

(다음에서 상속됨 UIElement)
ContextCanceled

컨텍스트 입력 제스처가 조작 제스처로 계속 진행되어 요소에 컨텍스트 플라이아웃을 열지 않아야 했음을 알릴 때 발생합니다.

(다음에서 상속됨 UIElement)
ContextRequested

사용자가 마우스 오른쪽 단추 클릭과 같은 컨텍스트 입력 제스처를 완료한 경우에 발생합니다.

(다음에서 상속됨 UIElement)
DataContextChanged

FrameworkElement.DataContext 속성의 값이 변경될 때 발생합니다.

(다음에서 상속됨 FrameworkElement)
DoubleTapped

처리되지 않은 DoubleTap 상호 작용이 이 요소의 적중 테스트 영역에서 발생할 때 발생합니다.

(다음에서 상속됨 UIElement)
DragEnter

입력 시스템이 이 요소를 대상으로 사용하여 기본 끌기 이벤트를 보고할 때 발생합니다.

(다음에서 상속됨 UIElement)
DragLeave

입력 시스템이 이 요소를 원본으로 사용하여 기본 끌기 이벤트를 보고할 때 발생합니다.

(다음에서 상속됨 UIElement)
DragOver

입력 시스템에서 이 요소를 잠재적인 놓기 대상으로 사용하는 기본 끌기 이벤트를 보고하면 발생합니다.

(다음에서 상속됨 UIElement)
DragStarting

끌기 작업이 시작될 때 발생합니다.

(다음에서 상속됨 UIElement)
Drop

입력 시스템에서 이 요소를 놓기 대상으로 사용하는 기본 놓기 이벤트를 보고하면 발생합니다.

(다음에서 상속됨 UIElement)
DropCompleted

원본이 종료되면 이 요소를 사용하여 끌어서 놓기 작업을 수행할 때 발생합니다.

(다음에서 상속됨 UIElement)
EffectiveViewportChanged

FrameworkElement유효 뷰포트가 변경될 때 발생합니다.

(다음에서 상속됨 FrameworkElement)
FocusDisengaged

포커스가 컨트롤 경계에서 해제될 때 발생합니다(게임 패드/원격 상호 작용용).

FocusEngaged

포커스가 컨트롤 경계 내에서 제한될 때 발생합니다(게임 패드/원격 상호 작용용).

GettingFocus

UIElement가 포커스를 받기 전에 발생합니다. 이 이벤트는 이벤트가 버블링되는 동안 포커스가 이동되지 않도록 동기적으로 발생합니다.

(다음에서 상속됨 UIElement)
GotFocus

UIElement가 포커스를 받을 때 발생합니다. 이 이벤트는 비동기적으로 발생하므로 버블링이 완료되기 전에 포커스가 다시 이동할 수 있습니다.

(다음에서 상속됨 UIElement)
Holding

처리되지 않은 보류 상호 작용이 이 요소의 적중 테스트 영역에서 발생할 때 발생합니다.

(다음에서 상속됨 UIElement)
IsEnabledChanged

IsEnabled 속성이 변경되면 발생합니다.

KeyDown

UIElement에 포커스가 있는 동안 키보드 키를 누를 때 발생합니다.

(다음에서 상속됨 UIElement)
KeyUp

UIElement에 포커스가 있는 동안 키보드 키가 해제될 때 발생합니다.

(다음에서 상속됨 UIElement)
LayoutUpdated

레이아웃 관련 속성 변경 값 또는 레이아웃을 새로 고치는 다른 작업으로 인해 시각적 트리의 레이아웃이 변경되면 발생합니다.

(다음에서 상속됨 FrameworkElement)
Loaded

FrameworkElement가 생성되어 개체 트리에 추가되고 상호 작용할 준비가 되었을 때 발생합니다.

(다음에서 상속됨 FrameworkElement)
Loading

FrameworkElement가 로드되기 시작할 때 발생합니다.

(다음에서 상속됨 FrameworkElement)
LosingFocus

UIElement가 포커스를 잃기 전에 발생합니다. 이 이벤트는 이벤트가 버블링되는 동안 포커스가 이동되지 않도록 동기적으로 발생합니다.

(다음에서 상속됨 UIElement)
LostFocus

UIElement가 포커스를 잃을 때 발생합니다. 이 이벤트는 비동기적으로 발생하므로 버블링이 완료되기 전에 포커스가 다시 이동할 수 있습니다.

(다음에서 상속됨 UIElement)
ManipulationCompleted

UIElement에 대한 조작이 완료되면 발생합니다.

(다음에서 상속됨 UIElement)
ManipulationDelta

입력 디바이스에서 조작 중에 위치를 변경하면 발생합니다.

(다음에서 상속됨 UIElement)
ManipulationInertiaStarting

조작하는 동안 입력 디바이스와 UIElement 개체의 연결이 끊어지고 관성이 시작될 때 발생합니다.

(다음에서 상속됨 UIElement)
ManipulationStarted

입력 디바이스가 UIElement에 대한 조작을 시작할 때 발생합니다.

(다음에서 상속됨 UIElement)
ManipulationStarting

조작 프로세서가 처음으로 만들어지면 발생합니다.

(다음에서 상속됨 UIElement)
NoFocusCandidateFound

사용자가 탭 또는 방향 화살표를 통해 포커스를 이동하려고 하지만 포커스 후보가 이동 방향에서 찾을 수 없으므로 포커스가 이동하지 않을 때 발생합니다.

(다음에서 상속됨 UIElement)
PointerCanceled

연락처를 비정상적으로 만든 포인터가 연락처를 잃을 때 발생합니다.

(다음에서 상속됨 UIElement)
PointerCaptureLost

이 요소가 이전에 보유한 포인터 캡처가 다른 요소 또는 다른 곳으로 이동할 때 발생합니다.

(다음에서 상속됨 UIElement)
PointerEntered

포인터가 이 요소의 적중 테스트 영역에 들어갈 때 발생합니다.

(다음에서 상속됨 UIElement)
PointerExited

포인터가 이 요소의 적중 테스트 영역을 떠날 때 발생합니다.

(다음에서 상속됨 UIElement)
PointerMoved

포인터가 이 요소의 적중 테스트 영역 내에 남아 있는 동안 포인터가 움직일 때 발생합니다.

(다음에서 상속됨 UIElement)
PointerPressed

포인터 디바이스가 이 요소 내에서 Press 동작을 시작할 때 발생합니다.

(다음에서 상속됨 UIElement)
PointerReleased

이전에 Press 작업을 시작한 포인터 디바이스가 이 요소 내에 있는 동안 해제될 때 발생합니다. Press 동작의 끝은 PointerReleased 이벤트를 발생시키지 않습니다. 대신 다른 이벤트가 발생할 수 있습니다. 자세한 내용은 비고를 참조하세요.

(다음에서 상속됨 UIElement)
PointerWheelChanged

포인터 휠의 델타 값이 변경되면 발생합니다.

(다음에서 상속됨 UIElement)
PreviewKeyDown

UIElement에 포커스가 있는 동안 키보드 키를 누를 때 발생합니다.

(다음에서 상속됨 UIElement)
PreviewKeyUp

UIElement에 포커스가 있는 동안 키보드 키가 해제될 때 발생합니다.

(다음에서 상속됨 UIElement)
ProcessKeyboardAccelerators

바로 가기 키(또는 가속기)를 누를 때 발생합니다.

(다음에서 상속됨 UIElement)
RightTapped

포인터가 요소 위에 있는 동안 오른쪽 탭 입력 자극이 발생할 때 발생합니다.

(다음에서 상속됨 UIElement)
SizeChanged

ActualHeight 또는 ActualWidth 속성이 FrameworkElement의 값을 변경할 때 발생합니다.

(다음에서 상속됨 FrameworkElement)
Tapped

처리되지 않은 상호 작용이 이 요소의 적중 테스트 영역에서 발생할 때 발생합니다.

(다음에서 상속됨 UIElement)
Unloaded

이 개체가 더 이상 기본 개체 트리에 연결되지 않은 경우에 발생합니다.

(다음에서 상속됨 FrameworkElement)

적용 대상

추가 정보