UIElement 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
UIElement는 시각적 모양이 있고 앱의 사용자 인터페이스의 일부로 기본 입력을 처리할 수 있는 대부분의 Windows 런타임 UI 개체에 대한 기본 클래스입니다.
public ref class UIElement : DependencyObject
public ref class UIElement : DependencyObject, IAnimationObject
public ref class UIElement : DependencyObject, IAnimationObject, IVisualElement
/// [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 UIElement : DependencyObject
/// [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 UIElement : DependencyObject, IAnimationObject
/// [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 UIElement : DependencyObject, IAnimationObject, IVisualElement
[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 UIElement : DependencyObject
[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 UIElement : DependencyObject, IAnimationObject
[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 UIElement : DependencyObject, IAnimationObject, IVisualElement
Public Class UIElement
Inherits DependencyObject
Public Class UIElement
Inherits DependencyObject
Implements IAnimationObject
Public Class UIElement
Inherits DependencyObject
Implements IAnimationObject, IVisualElement
- 상속
- 파생
- 특성
- 구현
Windows 요구 사항
디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
설명
UIElement는 기본 요소입니다. XAML UI 요소 모델을 지원하기 위해 다른 많은 Windows 런타임 클래스가 상속하는 클래스입니다. UIElement에서 정의하는 속성, 메서드 및 이벤트는 수백 개의 다른 Windows 런타임 클래스에서 상속됩니다.
UIElement는 포커스 보고(GotFocus, LostFocus)에 대한 이벤트를 정의하지만 UIElement는 프로그래밍 방식으로 포커스를 설정하기 위한 API를 정의하지 않습니다. 이 기능은 Control 클래스에 의해 정의됩니다.
UIElement는 공용 생성자를 노출하지 않습니다. 일반적으로 UIElement 또는 FrameworkElement 직접 클래스를 파생하지 않습니다. 파생 사용자 지정 클래스에 일반적으로 사용되는 기본 클래스는 다음과 같습니다.
- 봉인되지 않은 특정 컨트롤(예: TextBox
) - 컨트롤 기본 클래스(Control, ContentControl, UserControl)
- 탐색 요소(Page, Frame)
- 패널 클래스(기본 클래스 Panel또는 Grid같은 봉인되지 않은 특정 구현)
UIElement 클래스는 Windows 런타임 API에서 많은 속성 및 메서드의 형식 매개 변수로 사용됩니다. 예를 들어 BorderChild 속성은 테두리 그려지는 요소를 나타내는 단일 UIElement를 사용합니다. 정의한 사용자 지정 컨트롤을 포함하여 이러한 속성에 대해 UIElement 파생 요소를 제공할 수 있습니다.
UIElementCollection 클래스는 강력한 형식의 UIElement 항목 컬렉션을 제공합니다. UIElementCollection 여러 자식 요소를 포함하는 개체의 속성에 대한 형식으로 사용됩니다(예: Panel 클래스의 Children 속성).
UIElement API 및 기능
UIElement는 다른 기본 요소인 DependencyObject
사용자 상호 작용에 응답하기 위한 입력 및 이벤트
UI에서 표시되는 요소에 대한 대부분의 입력 동작은 UIElement 클래스에 정의되어 있습니다. 여기에는 키보드, 마우스, 터치, 끌어서 놓기 및 포커스 상호 작용에 대한 이벤트가 포함됩니다. 자세한 내용은
입력 및 사용자 상호 작용을 지원하는 UIElement의 눈에 띄는 API:
- 포인터 이벤트:PointerPressed, PointerReleased, PointerMoved, PointerEntered, PointerExited
- 키 처리 이벤트:KeyDown, KeyUp
- 포커스:GotFocus, LostFocus
- 포인터 캡처:CapturePointer, PointerCanceled, PointerCaptureLost, ReleasePointerCapture, PointerCaptures
- 끌어서 놓기:DragOver, Drop, DragEnter, DragLeave, AllowDrop
- 기본 입력 처리 방법에 영향을 주는 속성:IsHitTestVisible, AllowDrop
제스처 및 조작
제스처 및 조작은 입력 및 사용자 상호 작용을 처리하는 방법이기도 합니다. 이러한 이벤트는 시스템이 디바이스 수준 입력 작업과 상호 작용하고 사용자 상호 작용으로 해석하는 방법을 나타내기 때문에 API는 여기에 별도로 나열됩니다. 조작은 꼬집기 및 스트레칭과 같은 동적 멀티 터치 상호 작용을 처리하는 방법입니다. 제스처와 조작은 UWP 앱과의 터치 조작을 위한 터치 패턴을 제공합니다. 자세한 내용은 사용자 지정 사용자 상호 작용
제스처 및 조작을 지원하는 UIElement의 눈에 띄는 API:
- 제스처 이벤트:DoubleTapped, Holding, RightTapped, Tapped
- 조작 이벤트:ManipulationCompleted, ManipulationDelta, ManipulationInertiaStarting, ManipulationStarted, ManipulationStarting
- 제스처 및 조작 처리 방식에 영향을 주는 속성:IsHoldingEnabled 및 기타 Is*Enabled, ManipulationMode
기본 모양
Visibility 및 Opacity 속성은 특히 스타일, 템플릿 및 시각적 상태 내에서 UI에서 요소의 모양을 조정하는 데 자주 사용됩니다. Clip, RenderTransform및 전환 속성은 각각 UI 요소에 대한 상호 작용 및 다양한 모양을 생성하는 데 유용합니다.
기본 레이아웃
UIElement 클래스는 DesiredSize 및 Arrange 및 Measure 메서드와 같은 속성을 사용하여 레이아웃 특성에 대한 시작점을 제공합니다. FrameworkElement 더 많은 레이아웃 기능을 추가합니다. 자세한 내용은 XAML 및 FrameworkElement사용하여 레이아웃 정의를 참조하세요.
라우트된 이벤트
UIElement의 대부분의 입력 이벤트는 라우트된 이벤트
라우트된 이벤트를 지원하는 UIElement의 눈에 띄는 API: AddHandler, RemoveHandler, *이벤트 속성입니다.
기타 플랫폼 지원
- OnCreateAutomationPeer 사용하면 클래스가 Microsoft UI Automation 지원에 사용자 지정 AutomationPeer 사용할 수 있습니다.
- RenderTransform, TransformToVisual, 프로젝션, CompositeMode, CacheMode 및 FindSubElementsForTouchTargeting 고급 UI 레이아웃 시나리오에 유용합니다.
UIElement 종속성 속성
UIElement 기본 요소 클래스의 많은 읽기-쓰기 속성은 종속성 속성입니다. 종속성 속성은 스타일 및 템플릿, 데이터 바인딩, XAML 리소스 참조 및 속성 변경 논리와 같은 C++, C# 또는 Visual Basic을 사용하는 UWP 앱에 대한 몇 가지 기본 프로그래밍 모델 기능을 지원합니다. 종속성 속성 및 해당 속성이 지원하는 기능에 대한 자세한 내용은 종속성 속성 개요참조하세요.
UIElement 파생 클래스
UIElement에서 직접 파생되는 유일한 Windows 런타임 클래스는 FrameworkElement. FrameworkElement파생되는 클래스 목록은 FrameworkElement 참조 항목의 "FrameworkElement 파생 클래스" 섹션을 참조하세요.
버전 기록
Windows 버전 | SDK 버전 | 추가된 값 |
---|---|---|
1607 | 14393 | AccessKey |
1607 | 14393 | AccessKeyDisplayDismissed |
1607 | 14393 | AccessKeyDisplayRequested |
1607 | 14393 | AccessKeyInvoked |
1607 | 14393 | AccessKeyScopeOwner |
1607 | 14393 | ContextCanceled |
1607 | 14393 | ContextFlyout |
1607 | 14393 | ContextRequested |
1607 | 14393 | ExitDisplayModeOnAccessKeyInvoked |
1607 | 14393 | IsAccessKeyScope |
1703 | 15063 | GettingFocus |
1703 | 15063 | GettingFocusEvent |
1703 | 15063 | HighContrastAdjustment |
1703 | 15063 | KeyTipHorizontalOffset |
1703 | 15063 | KeyTipPlacementMode |
1703 | 15063 | KeyTipVerticalOffset |
1703 | 15063 | 조명 |
1703 | 15063 | LosingFocus |
1703 | 15063 | LosingFocusEvent |
1703 | 15063 | NoFocusCandidateFound |
1703 | 15063 | NoFocusCandidateFoundEvent |
1703 | 15063 | StartBringIntoView |
1703 | 15063 | StartBringIntoView(BringIntoViewOptions) |
1703 | 15063 | TabFocusNavigation |
1703 | 15063 | XYFocusDownNavigationStrategy |
1703 | 15063 | XYFocusKeyboardNavigation |
1703 | 15063 | XYFocusLeftNavigationStrategy |
1703 | 15063 | XYFocusRightNavigationStrategy |
1703 | 15063 | XYFocusUpNavigationStrategy |
1709 | 16299 | CharacterReceived |
1709 | 16299 | CharacterReceivedEvent |
1709 | 16299 | GetChildrenInTabFocusOrder |
1709 | 16299 | KeyboardAccelerators |
1709 | 16299 | OnProcessKeyboardAccelerators |
1709 | 16299 | PreviewKeyDown |
1709 | 16299 | PreviewKeyDownEvent |
1709 | 16299 | PreviewKeyUp |
1709 | 16299 | PreviewKeyUpEvent |
1709 | 16299 | ProcessKeyboardAccelerators |
1709 | 16299 | TryInvokeKeyboardAccelerator |
1803 | 17134 | BringIntoViewRequested |
1803 | 17134 | BringIntoViewRequestedEvent |
1803 | 17134 | ContextRequestedEvent |
1803 | 17134 | KeyboardAcceleratorPlacementMode |
1803 | 17134 | KeyboardAcceleratorPlacementTarget |
1803 | 17134 | KeyTipTarget |
1803 | 17134 | OnBringIntoViewRequested |
1803 | 17134 | OnKeyboardAcceleratorInvoked |
1803 | 17134 | RegisterAsScrollPort |
1809 | 17763 | CanBeScrollAnchor |
1809 | 17763 | CenterPoint |
1809 | 17763 | OpacityTransition |
1809 | 17763 | PopulatePropertyInfo |
1809 | 17763 | PopulatePropertyInfoOverride |
1809 | 17763 | 회전 |
1809 | 17763 | RotationAxis |
1809 | 17763 | RotationTransition |
1809 | 17763 | 저울 |
1809 | 17763 | ScaleTransition |
1809 | 17763 | StartAnimation |
1809 | 17763 | StopAnimation |
1809 | 17763 | TransformMatrix |
1809 | 17763 | 번역 |
1809 | 17763 | TranslationTransition |
1903 | 18362 | ActualOffset |
1903 | 18362 | ActualSize |
1903 | 18362 | 그림자 |
1903 | 18362 | UIContext |
1903 | 18362 | XamlRoot |
속성
AccessKey |
이 요소의 액세스 키(니모닉)를 가져오거나 설정합니다. |
AccessKeyProperty |
AccessKey 종속성 속성을 식별합니다. |
AccessKeyScopeOwner |
원본 요소의 시각적 트리에 없는 경우에도 이 요소에 대한 액세스 키 범위를 제공하는 원본 요소를 가져오거나 설정합니다. |
AccessKeyScopeOwnerProperty |
AccessKeyScopeOwner 종속성 속성을 식별합니다. |
ActualOffset |
레이아웃 프로세스의 정렬 패스 중에 계산된 부모에 상대적인 이 UIElement의 위치를 가져옵니다. |
ActualSize |
레이아웃 프로세스의 정렬 단계에서 이 UIElement가 계산한 크기를 가져옵니다. |
AllowDrop |
이 UIElement 끌어서 놓기 작업을 위해 놓기 대상이 될 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다. |
AllowDropProperty |
AllowDrop 종속성 속성 |
BringIntoViewRequestedEvent |
BringIntoViewRequested 라우트된 이벤트의 식별자를 가져옵니다. |
CacheMode |
렌더링된 콘텐츠가 가능한 경우 복합 비트맵으로 캐시되어야 임을 나타내는 값을 가져오거나 설정합니다. |
CacheModeProperty |
CacheMode 종속성 속성을 식별합니다. |
CanBeScrollAnchor |
UIElement 스크롤 앵커링 후보가 될 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. |
CanBeScrollAnchorProperty |
CanBeScrollAnchor 종속성 속성을 식별합니다. |
CanDrag |
요소를 끌어서 놓기 작업에서 데이터로 끌 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. |
CanDragProperty |
CanDrag 종속성 속성을 식별합니다. |
CenterPoint |
회전 또는 크기 조정이 발생하는 지점인 요소의 중심점을 가져오거나 설정합니다. 요소의 렌더링 위치에 영향을 줍니다. |
CharacterReceivedEvent |
CharacterReceived 라우트된 이벤트의 식별자를 가져옵니다. |
Clip |
UIElement내용의 개요를 정의하는 데 사용되는 RectangleGeometry 가져오거나 설정합니다. |
ClipProperty |
Clip 종속성 속성을 식별합니다. |
CompositeMode |
부모 레이아웃 및 창에서 요소에 대한 대체 컴퍼지션 및 혼합 모드를 선언하는 속성을 가져오거나 설정합니다. 이는 혼합 XAML/Microsoft DirectX UI와 관련된 요소와 관련이 있습니다. |
CompositeModeProperty |
CompositeMode 종속성 속성을 식별합니다. |
ContextFlyout |
이 요소와 연결된 플라이아웃을 가져오거나 설정합니다. |
ContextFlyoutProperty |
ContextFlyout 종속성 속성을 식별합니다. |
ContextRequestedEvent |
ContextRequested 라우트된 이벤트의 식별자를 가져옵니다. |
DesiredSize |
레이아웃 프로세스의 측정 단계에서 이 UIElement가 계산할 크기를 가져옵니다. |
Dispatcher |
이 개체가 연결된 CoreDispatcher 가져옵니다. CoreDispatcher 코드가 비 UI 스레드에서 시작된 경우에도 UI 스레드의 DependencyObject 액세스할 수 있는 기능을 나타냅니다. (다음에서 상속됨 DependencyObject) |
DoubleTappedEvent |
DoubleTapped 라우트된 이벤트의 식별자를 가져옵니다. |
DragEnterEvent |
DragEnter 라우트된 이벤트에 대한 식별자를 가져옵니다. |
DragLeaveEvent |
DragLeave 라우트된 이벤트에 대한 식별자를 가져옵니다. |
DragOverEvent |
DragOver 라우트된 이벤트에 대한 식별자를 가져옵니다. |
DropEvent |
Drop 라우트된 이벤트의 식별자를 가져옵니다. |
ExitDisplayModeOnAccessKeyInvoked |
액세스 키를 호출할 때 액세스 키 표시를 해제할지 여부를 지정하는 값을 가져오거나 설정합니다. |
ExitDisplayModeOnAccessKeyInvokedProperty |
ExitDisplayModeOnAccessKeyInvoked 종속성 속성을 식별합니다. |
GettingFocusEvent |
GettingFocus 라우트된 이벤트에 대한 식별자를 가져옵니다. |
HighContrastAdjustment |
고대비 테마를 사용할 때 프레임워크가 요소의 시각적 속성을 자동으로 조정하는지 여부를 나타내는 값을 가져오거나 설정합니다. |
HighContrastAdjustmentProperty |
HighContrastAdjustment 종속성 속성을 식별합니다. |
HoldingEvent |
Holding 라우트된 이벤트의 식별자를 가져옵니다. |
IsAccessKeyScope |
요소가 자체 액세스 키 범위를 정의하는지 여부를 나타내는 값을 가져오거나 설정합니다. |
IsAccessKeyScopeProperty |
IsAccessKeyScope 종속성 속성을 식별합니다. |
IsDoubleTapEnabled |
DoubleTapped 이벤트가 해당 요소에서 발생할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다. |
IsDoubleTapEnabledProperty |
IsDoubleTapEnabled 종속성 속성을 식별합니다. |
IsHitTestVisible |
이 UIElement 포함된 영역이 적중 테스트를 위해 실제 값을 반환할 수 있는지 여부를 가져오거나 설정합니다. |
IsHitTestVisibleProperty |
IsHitTestVisible 종속성 속성 |
IsHoldingEnabled |
Holding 이벤트가 해당 요소에서 발생할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다. |
IsHoldingEnabledProperty |
IsHoldingEnabled 종속성 속성을 |
IsRightTapEnabled |
RightTapped 이벤트가 해당 요소에서 발생할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다. |
IsRightTapEnabledProperty |
IsRightTapEnabled 종속성 속성 |
IsTapEnabled |
Tapped 이벤트가 해당 요소에서 발생할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다. |
IsTapEnabledProperty |
IsTapEnabled 종속성 속성을 식별합니다. |
KeyboardAcceleratorPlacementMode |
컨트롤 도구 설명이 연결된 키보드 액셀러레이터에 대한 키 조합을 표시할 여부를 나타내는 값을 가져오거나 설정합니다. |
KeyboardAcceleratorPlacementModeProperty |
KeyboardAcceleratorPlacementMode 종속성 속성을 식별합니다. |
KeyboardAcceleratorPlacementTarget |
가속기 키 조합을 표시하는 컨트롤 도구 설명 나타내는 값을 가져오거나 설정합니다. |
KeyboardAcceleratorPlacementTargetProperty |
KeyboardAcceleratorPlacementTarget 종속성 속성을 식별합니다. |
KeyboardAccelerators |
키보드를 사용하여 작업을 호출하는 키 조합의 컬렉션을 가져옵니다. 가속기는 일반적으로 단추 또는 메뉴 항목에 할당됩니다.
|
KeyDownEvent |
KeyDown 라우트된 이벤트에 대한 식별자를 가져옵니다. |
KeyTipHorizontalOffset |
키 팁이 UIElement와 관련하여 배치되는 간격을 나타내는 값을 가져오거나 설정합니다. |
KeyTipHorizontalOffsetProperty |
KeyTipHorizontalOffset 종속성 속성을 식별합니다. |
KeyTipPlacementMode |
UIElement의 경계와 관련하여 액세스 키 팁이 배치되는 위치를 나타내는 값을 가져오거나 설정합니다. |
KeyTipPlacementModeProperty |
KeyTipPlacementMode 종속성 속성을 식별합니다. |
KeyTipTarget |
액세스 키 키 팁의 대상이 되는 요소를 나타내는 값을 가져오거나 설정합니다. |
KeyTipTargetProperty |
KeyTipTarget 종속성 속성을 식별합니다. |
KeyTipVerticalOffset |
키 팁이 UI 요소와 관련하여 배치되는 거리를 나타내는 값을 가져오거나 설정합니다. |
KeyTipVerticalOffsetProperty |
KeyTipVerticalOffset 종속성 속성을 식별합니다. |
KeyUpEvent |
KeyUp 라우트된 이벤트에 대한 식별자를 가져옵니다. |
Lights |
이 요소에 연결된 XamlLight 개체의 컬렉션을 가져옵니다. |
LightsProperty |
Lights 종속성 속성을 식별합니다. |
LosingFocusEvent |
LosingFocus 라우트된 이벤트에 대한 식별자를 가져옵니다. |
ManipulationCompletedEvent |
ManipulationCompleted 라우트된 이벤트에 대한 식별자를 가져옵니다. |
ManipulationDeltaEvent |
ManipulationDelta 라우트된 이벤트에 대한 식별자를 가져옵니다. |
ManipulationInertiaStartingEvent |
ManipulationInertiaStarting 라우트된 이벤트에 대한 식별자를 가져옵니다. |
ManipulationMode |
UIElement 동작 및 제스처 조작에 사용되는 ManipulationModes 값을 가져오거나 설정합니다. 이 값을 설정하면 앱 코드에서 이 요소의 조작 이벤트를 처리할 수 있습니다. |
ManipulationModeProperty |
ManipulationMode 종속성 속성을 식별합니다. |
ManipulationStartedEvent |
ManipulationStarted 라우트된 이벤트에 대한 식별자를 가져옵니다. |
ManipulationStartingEvent |
ManipulationStarting 라우트된 이벤트에 대한 식별자를 가져옵니다. |
NoFocusCandidateFoundEvent |
NoFocusCandidateFound 라우트된 이벤트에 대한 식별자를 가져옵니다. |
Opacity |
개체의 불투명도를 가져오거나 설정합니다. |
OpacityProperty |
IsHitTestVisible 종속성 속성 |
OpacityTransition |
Opacity 속성의 변경 내용에 애니메이션 효과를 주는 ScalarTransition을 가져오거나 설정합니다. |
PointerCanceledEvent |
PointerCanceled 라우트된 이벤트에 대한 식별자를 가져옵니다. |
PointerCaptureLostEvent |
PointerCaptureLost 라우트된 이벤트에 대한 식별자를 가져옵니다. |
PointerCaptures |
포인터 값으로 표시되는 캡처된 모든 포인터의 집합을 가져옵니다. |
PointerCapturesProperty |
PointerCaptures 종속성 속성을 식별합니다. |
PointerEnteredEvent |
PointerEntered 라우트된 이벤트에 대한 식별자를 가져옵니다. |
PointerExitedEvent |
PointerExited 라우트된 이벤트의 식별자를 가져옵니다. |
PointerMovedEvent |
PointerMoved 라우트된 이벤트에 대한 식별자를 가져옵니다. |
PointerPressedEvent |
PointerPressed 라우트된 이벤트의 식별자를 가져옵니다. |
PointerReleasedEvent |
PointerReleased 라우트된 이벤트의 식별자를 가져옵니다. |
PointerWheelChangedEvent |
PointerWheelChanged 라우트된 이벤트에 대한 식별자를 가져옵니다. |
PreviewKeyDownEvent |
PreviewKeyDown 라우트된 이벤트의 식별자를 가져옵니다. |
PreviewKeyUpEvent |
PreviewKeyUp 라우트된 이벤트에 대한 식별자를 가져옵니다. |
Projection |
이 요소를 렌더링할 때 적용할 원근 투영(3차원 효과)을 가져오거나 설정합니다. |
ProjectionProperty |
프로젝션 종속성 속성을 식별합니다. |
RenderSize |
UIElement최종 렌더링 크기를 가져옵니다. 사용하지 않는 것이 좋습니다. 주의 사항을 참조하세요. |
RenderTransform |
UIElement렌더링 위치에 영향을 주는 변환 정보를 가져오거나 설정합니다. |
RenderTransformOrigin |
UIElement범위를 기준으로 RenderTransform선언된 가능한 렌더링 변환의 원점을 가져오거나 설정합니다. |
RenderTransformOriginProperty |
RenderTransformOrigin 종속성 속성을 식별합니다. |
RenderTransformProperty |
RenderTransform 종속성 속성을 식별합니다. |
RightTappedEvent |
rightTapped 라우트된 이벤트에 대한 |
Rotation |
시계 방향 회전 각도를 도 단위로 가져오거나 설정합니다. RotationAxis 및 CenterPoint를 기준으로 회전합니다. 요소의 렌더링 위치에 영향을 줍니다. |
RotationAxis |
요소를 회전할 축을 가져오거나 설정합니다. |
RotationTransition |
Rotation 속성의 변경 내용에 애니메이션 효과를 주는 ScalarTransition을 가져오거나 설정합니다. |
Scale |
요소의 배율을 가져오거나 설정합니다. 요소의 CenterPoint를 기준으로 배율을 조정합니다. 요소의 렌더링 위치에 영향을 줍니다. |
ScaleTransition |
Scale 속성의 변경 내용에 애니메이션 효과를 주는 Vector3Transition을 가져오거나 설정합니다. |
Shadow |
요소에 의해 캐스팅된 그림자 효과를 가져오거나 설정합니다. |
ShadowProperty |
Shadow 종속성 속성을 식별합니다. |
TabFocusNavigation |
이 컨트롤에 대해 tabbing 및 TabIndex 작동하는 방식을 수정하는 값을 가져오거나 설정합니다. |
TabFocusNavigationProperty |
TabFocusNavigation 종속성 속성을 식별합니다. |
TappedEvent |
Tapped 라우트된 이벤트의 식별자를 가져옵니다. |
Transform3D |
이 요소를 렌더링할 때 적용할 3차원 변환 효과를 가져오거나 설정합니다. |
Transform3DProperty |
Transform3D 종속성 속성을 식별합니다. |
TransformMatrix |
요소에 적용할 변환 행렬을 가져오거나 설정합니다. |
Transitions |
UIElement적용되는 Transition 스타일 요소의 컬렉션을 가져오거나 설정합니다. |
TransitionsProperty |
전환 종속성 속성을 식별합니다. |
Translation |
요소의 x, y 및 z 렌더링 위치를 가져오거나 설정합니다. |
TranslationTransition |
Translation 속성의 변경 내용에 애니메이션 효과를 주는 Vector3Transition을 가져오거나 설정합니다. |
UIContext |
요소의 컨텍스트 식별자를 가져옵니다. |
UseLayoutRounding |
개체 및 해당 시각적 하위 트리의 렌더링에서 렌더링을 전체 픽셀에 맞추는 반올림 동작을 사용해야 하는지 여부를 결정하는 값을 가져오거나 설정합니다. |
UseLayoutRoundingProperty |
UseLayoutRounding 종속성 속성 |
Visibility |
UIElement표시 여부를 가져오거나 설정합니다. 표시되지 않는 UIElement 렌더링되지 않으며 원하는 크기를 레이아웃에 전달하지 않습니다. |
VisibilityProperty |
Visibility 종속성 속성을 식별합니다. |
XamlRoot |
이 요소를 볼 |
XYFocusDownNavigationStrategy |
아래쪽 탐색의 대상 요소를 결정하는 데 사용되는 전략을 지정하는 값을 가져오거나 설정합니다. |
XYFocusDownNavigationStrategyProperty |
XYFocusDownNavigationStrategy 종속성 속성을 식별합니다. |
XYFocusKeyboardNavigation |
키보드 방향 화살표를 사용하여 탐색을 사용하거나 사용하지 않도록 설정하는 값을 가져오거나 설정합니다. |
XYFocusKeyboardNavigationProperty |
XYFocusKeyboardNavigation 종속성 속성을 식별합니다. |
XYFocusLeftNavigationStrategy |
왼쪽 탐색의 대상 요소를 결정하는 데 사용되는 전략을 지정하는 값을 가져오거나 설정합니다. |
XYFocusLeftNavigationStrategyProperty |
XYFocusLeftNavigationStrategy 종속성 속성을 식별합니다. |
XYFocusRightNavigationStrategy |
오른쪽 탐색의 대상 요소를 결정하는 데 사용되는 전략을 지정하는 값을 가져오거나 설정합니다. |
XYFocusRightNavigationStrategyProperty |
XYFocusRightNavigationStrategy 종속성 속성을 식별합니다. |
XYFocusUpNavigationStrategy |
위쪽 탐색의 대상 요소를 결정하는 데 사용되는 전략을 지정하는 값을 가져오거나 설정합니다. |
XYFocusUpNavigationStrategyProperty |
XYFocusUpNavigationStrategy 종속성 속성을 식별합니다. |
메서드
AddHandler(RoutedEvent, Object, Boolean) |
지정된 라우트된 이벤트에 대해 라우트된 이벤트 처리기를 추가하여 처리기를 현재 요소의 처리기 컬렉션에 추가합니다. handledEventsTootrue 지정하여 이벤트가 다른 곳에서 처리되는 경우에도 제공된 처리기를 호출하도록 합니다. |
Arrange(Rect) |
자식 개체를 배치하고 UIElement크기를 결정합니다. 자식 요소에 대한 사용자 지정 레이아웃을 구현하는 부모 개체는 레이아웃 재정의 구현에서 이 메서드를 호출하여 재귀 레이아웃 업데이트를 구성해야 합니다. |
CancelDirectManipulations() |
현재 UIElement포함하는 모든 ScrollViewer 부모에서 진행 중인 직접 조작 처리(시스템 정의 이동/확대/축소)를 취소합니다. |
CapturePointer(Pointer) |
포인터 캡처를 UIElement설정합니다. 캡처된 후에는 캡처가 있는 요소만 포인터 관련 이벤트를 발생합니다. |
ClearValue(DependencyProperty) |
종속성 속성의 로컬 값을 지웁니다. (다음에서 상속됨 DependencyObject) |
FindSubElementsForTouchTargeting(Point, Rect) |
UIElement 하위 클래스가 터치 대상 지정을 확인하는 데 도움이 되는 자식 요소를 노출할 수 있도록 합니다. |
GetAnimationBaseValue(DependencyProperty) |
애니메이션이 활성화되지 않은 경우 적용되는 종속성 속성에 대해 설정된 기본 값을 반환합니다. (다음에서 상속됨 DependencyObject) |
GetChildrenInTabFocusOrder() |
UIElement 하위 클래스가 Tab 포커스에 참여하는 자식 요소를 노출할 수 있도록 합니다. |
GetValue(DependencyProperty) |
DependencyObject종속성 속성의 현재 유효 값을 반환합니다. (다음에서 상속됨 DependencyObject) |
InvalidateArrange() |
UIElement대한 정렬 상태(레이아웃)를 무효화합니다. 무효화 후 UIElement 레이아웃이 업데이트되어 비동기적으로 발생합니다. |
InvalidateMeasure() |
UIElement대한 측정 상태(레이아웃)를 무효화합니다. |
Measure(Size) |
UIElementDesiredSize 업데이트합니다. 일반적으로 레이아웃 자식에 대한 사용자 지정 레이아웃을 구현하는 개체는 자체 MeasureOverride 구현에서 이 메서드를 호출하여 재귀 레이아웃 업데이트를 형성합니다. |
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
BringIntoViewRequested 이벤트가 발생하기 전에 호출됩니다. |
OnCreateAutomationPeer() |
파생 클래스에서 구현되는 경우 Microsoft UI 자동화 인프라에 대한 클래스별 AutomationPeer 구현을 반환합니다. |
OnDisconnectVisualChildren() |
클래스별 콘텐츠 또는 자식 속성에서 항목을 제거할 때 레이아웃 및 논리가 동작하는 방식을 구현하려면 이 메서드를 재정의합니다. |
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
앱에서 바로 가기 키(또는 가속기) 처리될 때 호출됩니다. 키보드 가속기가 호출될 때 앱이 응답하는 방식을 처리하도록 이 메서드를 재정의합니다. |
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
바로 가기 키(또는 가속기) 앱에서 처리되기 직전에 호출됩니다. 애플리케이션 코드 또는 내부 프로세스가 ProcessKeyboardAccelerators호출할 때마다 호출됩니다. 기본 가속기 처리에 영향을 주도록 이 메서드를 재정의합니다. |
PopulatePropertyInfo(String, AnimationPropertyInfo) |
애니메이션 효과를 적용할 수 있는 속성을 정의합니다. |
PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
파생 클래스에서 재정의되는 경우 애니메이션 효과를 적용할 수 있는 속성을 정의합니다. |
ReadLocalValue(DependencyProperty) |
로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다. (다음에서 상속됨 DependencyObject) |
RegisterAsScrollPort(UIElement) |
요소를 스크롤 가능한 뷰포트를 나타내는 것으로 등록합니다. |
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
이 DependencyObject 인스턴스에서 특정 DependencyProperty 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다. (다음에서 상속됨 DependencyObject) |
ReleasePointerCapture(Pointer) |
이 UIElement특정 포인터를 캡처하기 위한 포인터 캡처를 해제합니다. |
ReleasePointerCaptures() |
이 요소가 보유한 모든 포인터 캡처를 해제합니다. |
RemoveHandler(RoutedEvent, Object) |
이 UIElement지정된 라우트된 이벤트 처리기를 제거합니다. 일반적으로 해당 처리기는 AddHandler추가되었습니다. |
SetValue(DependencyProperty, Object) |
DependencyObject종속성 속성의 로컬 값을 설정합니다. (다음에서 상속됨 DependencyObject) |
StartAnimation(ICompositionAnimationBase) |
요소에서 지정된 애니메이션을 시작합니다. |
StartBringIntoView() |
XAML 프레임워크에 대한 요청을 시작하여 포함된 스크롤 가능한 영역 내에서 요소를 보기로 가져옵니다. |
StartBringIntoView(BringIntoViewOptions) |
지정된 옵션을 사용하여 요소를 보기로 가져오기 위해 XAML 프레임워크에 대한 요청을 시작합니다. |
StartDragAsync(PointerPoint) |
끌어서 놓기 작업을 시작합니다. |
StopAnimation(ICompositionAnimationBase) |
요소에서 지정된 애니메이션을 중지합니다. |
TransformToVisual(UIElement) |
UIElement 지정된 개체로 좌표를 변환하는 데 사용할 수 있는 변환 개체를 반환합니다. |
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) |
UIElement의 전체 시각적 트리에서 바로 가기 키를 검색하여 바로 가기 키(또는 가속기) 호출하려고 시도합니다. |
TryStartDirectManipulation(Pointer) |
현재 UIElement포함하는 ScrollViewer 부모에서 직접 조작 처리(시스템 정의 이동/확대/축소)를 다시 시작합니다. |
UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
RegisterPropertyChangedCallback호출하여 이전에 등록된 변경 알림을 취소합니다. (다음에서 상속됨 DependencyObject) |
UpdateLayout() |
UIElement 자식 개체의 모든 위치가 레이아웃에 대해 올바르게 업데이트되었는지 확인합니다. |
이벤트
AccessKeyDisplayDismissed |
액세스 키가 더 이상 표시되지 않아야 하는 경우에 발생합니다. |
AccessKeyDisplayRequested |
사용자가 액세스 키를 표시할 것을 요청할 때 발생합니다. |
AccessKeyInvoked |
사용자가 액세스 키 시퀀스를 완료할 때 발생합니다. |
BringIntoViewRequested |
이 요소 또는 해당 하위 항목 중 하나에서 StartBringIntoView 호출될 때 발생합니다. |
CharacterReceived |
입력 큐에서 구성된 단일 문자를 받을 때 발생합니다. |
ContextCanceled |
컨텍스트 입력 제스처가 조작 제스처로 계속 진행되어 컨텍스트 플라이아웃을 열어서는 안 됨을 요소에 알릴 때 발생합니다. |
ContextRequested |
사용자가 마우스 오른쪽 단추 클릭과 같은 컨텍스트 입력 제스처를 완료할 때 발생합니다. |
DoubleTapped |
이 요소의 적중 테스트 영역에서 처리되지 않은 DoubleTap 상호 작용이 발생할 때 발생합니다. |
DragEnter |
입력 시스템이 이 요소를 대상으로 사용하여 기본 끌기 이벤트를 보고할 때 발생합니다. |
DragLeave |
입력 시스템이 이 요소를 원본으로 사용하여 기본 끌기 이벤트를 보고할 때 발생합니다. |
DragOver |
입력 시스템이 이 요소를 잠재적인 놓기 대상으로 사용하여 기본 끌기 이벤트를 보고할 때 발생합니다. |
DragStarting |
끌기 작업이 시작될 때 발생합니다. |
Drop |
입력 시스템에서 이 요소를 드롭 대상으로 사용하여 기본 놓기 이벤트를 보고할 때 발생합니다. |
DropCompleted |
소스가 종료되면 이 요소와 함께 끌어서 놓기 작업이 수행되는 경우에 발생합니다. |
GettingFocus |
UIElement 포커스를 받기 전에 발생합니다. 이 이벤트는 이벤트가 버블링되는 동안 포커스가 이동되지 않도록 동기적으로 발생합니다. |
GotFocus |
UIElement 포커스를 받을 때 발생합니다. 이 이벤트는 비동기적으로 발생하므로 버블링이 완료되기 전에 포커스가 다시 이동할 수 있습니다. |
Holding |
처리되지 않은 보류 상호 작용이 이 요소의 적중 테스트 영역에서 발생할 때 발생합니다. |
KeyDown |
UIElement 포커스가 있는 동안 키보드 키를 누르면 발생합니다. |
KeyUp |
UIElement 포커스가 있는 동안 키보드 키가 해제될 때 발생합니다. |
LosingFocus |
UIElement 포커스를 잃기 전에 발생합니다. 이 이벤트는 이벤트가 버블링되는 동안 포커스가 이동되지 않도록 동기적으로 발생합니다. |
LostFocus |
UIElement 포커스를 잃을 때 발생합니다. 이 이벤트는 비동기적으로 발생하므로 버블링이 완료되기 전에 포커스가 다시 이동할 수 있습니다. |
ManipulationCompleted |
UIElement 조작이 완료되면 발생합니다. |
ManipulationDelta |
조작하는 동안 입력 디바이스의 위치가 변경되면 발생합니다. |
ManipulationInertiaStarting |
입력 디바이스가 조작 및 관성 시작 중에 UIElement 개체와의 접촉을 잃을 때 발생합니다. |
ManipulationStarted |
입력 디바이스가 UIElement조작을 시작할 때 발생합니다. |
ManipulationStarting |
조작 프로세서를 처음 만들 때 발생합니다. |
NoFocusCandidateFound |
사용자가 탭 또는 방향 화살표를 통해 포커스를 이동하려고 하지만 포커스 후보가 이동 방향에 없으므로 포커스가 이동하지 않을 때 발생합니다. |
PointerCanceled |
연락처를 만든 포인터가 비정상적으로 연락처를 잃을 때 발생합니다. |
PointerCaptureLost |
이 요소에 의해 이전에 보유된 포인터 캡처가 다른 요소 또는 다른 위치로 이동할 때 발생합니다. |
PointerEntered |
포인터가 이 요소의 적중 테스트 영역에 들어갈 때 발생합니다. |
PointerExited |
포인터가 이 요소의 적중 테스트 영역을 떠날 때 발생합니다. |
PointerMoved |
포인터가 이 요소의 적중 테스트 영역 내에 남아 있는 동안 포인터가 이동할 때 발생합니다. |
PointerPressed |
포인터 디바이스가 이 요소 내에서 누름 작업을 시작할 때 발생합니다. |
PointerReleased |
이전에 Press 작업을 시작한 포인터 디바이스가 이 요소 내에서 해제될 때 발생합니다. Press 작업의 끝은 PointerReleased 이벤트를 발생시키지 않습니다. 대신 다른 이벤트가 발생할 수 있습니다. 자세한 내용은 비고를 참조하세요. |
PointerWheelChanged |
포인터 휠의 델타 값이 변경되면 발생합니다. |
PreviewKeyDown |
UIElement 포커스가 있는 동안 키보드 키를 누르면 발생합니다. |
PreviewKeyUp |
UIElement 포커스가 있는 동안 키보드 키가 해제될 때 발생합니다. |
ProcessKeyboardAccelerators |
바로 가기 키(또는 가속기) 누를 때 발생합니다. |
RightTapped |
포인터가 요소 위에 있는 동안 오른쪽 탭 입력 자극이 발생할 때 발생합니다. |
Tapped |
처리되지 않은 탭 이 요소의 적중 테스트 영역에서 상호 작용이 발생할 때 발생합니다. |
적용 대상
추가 정보
- DependencyObject
- FrameworkElement
- 이벤트 및 라우트된 이벤트 개요
- 종속성 속성 개요
- 샘플 끌어서 놓기
- 기본 입력 샘플
- Transform3D 애니메이션 샘플