FrameworkElement 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
Windows 런타임 UI 개체에 대한 기본 요소 클래스를 제공합니다. FrameworkElement는 UI 상호 작용 및 자동 레이아웃 시스템을 지원하는 일반적인 API를 정의합니다. FrameworkElement는 데이터 바인딩, 개체 트리 정의 및 검사, 개체 수명 추적과 관련된 API도 정의합니다.
public ref class FrameworkElement : UIElement/// [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 FrameworkElement : UIElement[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 FrameworkElement : UIElementPublic Class FrameworkElement
Inherits UIElement- 상속
- 파생
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
설명
FrameworkElement는 기본 요소입니다. XAML UI 요소 모델을 지원하기 위해 다른 많은 Windows 런타임 클래스가 상속하는 클래스입니다. FrameworkElement에서 정의하는 속성, 메서드 및 이벤트는 수백 개의 다른 Windows 런타임 클래스에서 상속됩니다.
많은 일반적인 XAML UI 클래스는 직접 또는 Panel 또는 Control과 같은 중간 기본 클래스를 통해 FrameworkElement에서 파생됩니다. 일반적으로 UI 표현(예: 템플릿 지원)을 위한 클래스에 대해 예상되는 특정 서비스가 완전히 구현되지 않으므로 FrameworkElement에서 직접 클래스를 파생하지 않습니다. 파생 사용자 지정 클래스에 대해 더 일반적으로 사용되는 기본 클래스는 다음과 같습니다.
- 봉인되지 않은 특정 컨트롤(예: TextBox).
- 컨트롤 기본 클래스(Control, ContentControl, UserControl).
- 탐색 요소(Page, Frame).
- 패널 클래스(기본 클래스 패널 또는 Grid와 같은 봉인되지 않은 특정 구현).
FrameworkElement API 및 기능
FrameworkElement는 또 다른 기본 요소인 UIElement를 확장하고 다양한 Windows 런타임 기능 영역에 대한 지원을 추가합니다.
Layout
레이아웃 시스템은 FrameworkElement에서 파생된 모든 개체를 잠재적으로 레이아웃에 참여하고 앱 UI에 표시 영역이 있어야 하는 요소로 인식합니다. 레이아웃 시스템은 MinWidth와 같이 FrameworkElement 수준에서 정의된 다양한 속성을 읽습니다. 대부분의 UI 요소는 기본 크기 조정 정보에 FrameworkElement 정의 너비 및 높이 를 사용합니다. FrameworkElement는 콘텐츠가 있는 패널 및 컨트롤이 클래스 구현에서 재정의할 수 있는 특수 레이아웃 동작에 확장 가능한 메서드를 제공합니다. 자세한 내용은 XAML을 사용하여 레이아웃 정의를 참조하세요.
레이아웃을 지원하는 FrameworkElement의 눈에 띄는 API: Height, Width, ActualHeight, ActualWidth, Margin, MeasureOverride, ArrangeOverride, HorizontalAlignment, VerticalAlignment, LayoutUpdated.
개체 수명 이벤트
개체가 처음 로드되는 시기를 알고 싶은 경우가 많습니다(로드는 루트 시각적 개체에 연결하는 개체 트리에 개체가 연결될 때로 정의됨). FrameworkElement는 코드 숨김 작업에 유용한 후크를 제공하는 개체 수명 관련 이벤트를 정의합니다. 예를 들어 개체 트리에 필요한 개체가 이미 XAML 태그에서 인스턴스화되었음을 보장하여 컬렉션에 자식 개체를 추가하거나 사용하기 직전에 자식 개체의 속성을 설정하려면 개체 수명 정보가 필요합니다. 자세한 내용은 이벤트 및 라우트된 이벤트 개요를 참조하세요.
개체 수명 이벤트를 지원하는 FrameworkElement의 눈에 띄는 API: Loaded, SizeChanged, Unloaded, OnApplyTemplate.
데이터 바인딩
데이터 바인딩에 대해 잠재적으로 상속된 데이터 컨텍스트에 대한 값을 설정하는 기능은 FrameworkElement에서 구현됩니다. FrameworkElement에는 XAML이 아닌 코드에서 데이터 바인딩을 설정하기 위한 API도 있습니다. 자세한 내용은 데이터 바인딩 심층 분석을 참조하세요.
데이터 바인딩을 지원하는 FrameworkElement의 눈에 띄는 API: DataContext, DataContextChanged, SetBinding, GetBindingExpression.
XAML 언어 및 프로그래밍 모델 통합
일반적으로 앱의 요소 구조는 UI를 만들기 위해 정의한 XAML 태그와 유사하지만 XAML을 구문 분석한 후 구조가 변경되는 경우도 있습니다. FrameworkElement는 런타임에 요소 및 요소 관계를 찾는 데 유용한 Name 속성 및 관련 API를 정의합니다. 자세한 내용은 XAML 이름 범위를 참조하세요.
XAML 및 프로그래밍 모델을 지원하는 FrameworkElement의 눈에 띄는 API: Name, FindName, Parent, BaseUri, OnApplyTemplate.
전역화
FrameworkElement 클래스는 Language 속성과 FlowDirection 속성을 정의합니다. 자세한 내용은 앱 세계화를 참조하세요.
스타일 및 테마 지원
FrameworkElement 클래스는 Style 속성과 RequestedTheme 속성을 정의합니다. 또한 Resources 속성은 일반적으로 스타일 및 템플릿뿐만 아니라 다른 공유 리소스를 정의하는 페이지 수준 XAML 리소스 사전을 정의하는 데 사용됩니다. 자세한 내용은 스타일 지정 컨트롤 및ResourceDictionary 및 XAML 리소스 참조를 참조하세요.
FrameworkElement 종속성 속성
FrameworkElement 기본 요소 클래스의 많은 읽기-쓰기 속성은 종속성 속성입니다. 종속성 속성은 스타일 및 템플릿, 데이터 바인딩, XAML 리소스 참조 및 속성 변경 논리와 같은 C++, C# 또는 Visual Basic을 사용하는 UWP 앱에 대한 기본 프로그래밍 모델 기능 중 일부를 지원합니다. 종속성 속성 및 해당 속성이 지원하는 기능에 대한 자세한 내용은 종속성 속성 개요를 참조하세요.
FrameworkElement 파생 클래스
FrameworkElement는 UI 요소의 여러 광범위한 분류를 구분하는 몇 가지 즉시 파생된 클래스의 부모 클래스입니다. 다음은 몇 가지 주목할 만한 파생 클래스입니다.
- 컨트롤: 컨트롤에는 더 많은 파생 컨트롤 클래스가 있으며, 기본적으로 Windows 런타임 UI에 사용하는 모든 XAML 컨트롤은 Control에서 파생됩니다.
- 발표자: 발표자는 일반적으로 일부 제어 시나리오에 기여하여 시각적 모양을 부여하는 클래스이지만 발표자 자체는 일반적으로 대화형이 아닙니다. 예를 들어 Border, ContentPresenter ( ScrollContentPresenter 등의 부모), ItemsPresenter, Viewbox 등이 있습니다.
- 미디어 및 웹 요소: Image, WebView, MediaElement, CaptureElement. 이러한 콘텐츠는 콘텐츠를 표시하고 콘텐츠 내에서 발생하는 어느 정도의 대화형 작업을 수행하지만 실제로는 제어되지 않습니다.
- 텍스트 표시 요소: TextBlock, RichTextBlock, RichTextBlockOverflow, 문자 모양. (텍스트 표시 요소의 콘텐츠를 선언하는 Run 및 Hyperlink와 같은 텍스트 요소는 FrameworkElement에서 파생되지 않습니다.)
- Panel 기본 클래스: Panel은 Grid, StackPanel 등과 같은 공통 패널의 부모 클래스입니다.
- Shape 기본 클래스: Shape는 Path, Rectangle 등에 대한 부모 클래스입니다.
- IconElement 기본 클래스: FontIcon, SymbolIcon 등에 대한 부모 클래스입니다.
- 기타 UI 요소: Popup, TickBar, Viewbox.
버전 기록
| Windows 버전 | SDK 버전 | 추가된 값 |
|---|---|---|
| 1607 | 14393 | AllowFocusOnInteraction |
| 1607 | 14393 | AllowFocusWhenDisabled |
| 1607 | 14393 | FocusVisualMargin |
| 1607 | 14393 | FocusVisualPrimaryBrush |
| 1607 | 14393 | FocusVisualPrimaryThickness |
| 1607 | 14393 | FocusVisualSecondaryBrush |
| 1607 | 14393 | FocusVisualSecondaryThickness |
| 1703 | 15063 | DeferTree |
| 1709 | 16299 | ActualTheme |
| 1709 | 16299 | ActualThemeChanged |
| 1809 | 17763 | EffectiveViewportChanged |
| 1809 | 17763 | InvalidateViewport |
| 1809 | 17763 | IsLoaded |
생성자
| FrameworkElement() |
FrameworkElement 파생 클래스에 대한 기본 클래스 초기화 동작을 제공합니다. |
속성
| AccessKey |
이 요소의 액세스 키(니모닉)를 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| AccessKeyScopeOwner |
원본 요소의 시각적 트리에 없는 경우에도 이 요소에 대한 액세스 키 scope 제공하는 원본 요소를 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| ActualHeight |
FrameworkElement의 렌더링된 높이를 가져옵니다. 설명 부분을 참조하세요. |
| ActualHeightProperty |
ActualHeight 종속성 속성을 식별합니다. 설명 부분을 참조하세요. |
| ActualOffset |
레이아웃 프로세스의 정렬 단계에서 계산된 부모에 상대적인 이 UIElement의 위치를 가져옵니다. (다음에서 상속됨 UIElement) |
| ActualSize |
레이아웃 프로세스의 정렬 단계에서 이 UIElement가 계산한 크기를 가져옵니다. (다음에서 상속됨 UIElement) |
| ActualTheme |
RequestedTheme과 다를 수 있는 요소에서 현재 사용되는 UI 테마를 가져옵니다. |
| ActualThemeProperty |
ActualTheme 종속성 속성을 식별합니다. |
| ActualWidth |
FrameworkElement의 렌더링된 너비를 가져옵니다. 설명 부분을 참조하세요. |
| ActualWidthProperty |
ActualWidth 종속성 속성을 식별합니다. 설명 부분을 참조하세요. |
| AllowDrop |
끌어서 놓기 작업을 위해 이 UIElement 가 놓기 대상이 될 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| AllowFocusOnInteraction |
사용자가 상호 작용할 때 요소가 자동으로 포커스를 받는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| AllowFocusOnInteractionProperty |
AllowFocusOnInteraction 종속성 속성을 식별합니다. |
| AllowFocusWhenDisabled |
비활성화된 컨트롤이 포커스를 받을 수 있는지 여부를 가져오거나 설정합니다. |
| AllowFocusWhenDisabledProperty |
AllowFocusWhenDisabled 종속성 속성을 식별합니다. |
| BaseUri |
XAML 로드 시 XAML 생성 개체의 기본 URI(Uniform Resource Identifier)를 나타내는 URI(Uniform Resource Identifier)를 가져옵니다. 이 속성은 런타임에 URI(Uniform Resource Identifier) 확인에 유용합니다. |
| CacheMode |
가능한 경우 렌더링된 콘텐츠를 복합 비트맵으로 캐시해야 했음을 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| CanBeScrollAnchor |
UIElement가 스크롤 앵커링의 후보가 될 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| CanDrag |
요소를 끌어서 놓기 작업에서 데이터로 끌 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| CenterPoint |
회전 또는 크기 조정이 발생하는 요소의 중심점을 가져오거나 설정합니다. 요소의 렌더링 위치에 영향을 줍니다. (다음에서 상속됨 UIElement) |
| Clip |
UIElement 콘텐츠의 개요를 정의하는 데 사용되는 RectangleGeometry를 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| CompositeMode |
부모 레이아웃 및 창에서 요소에 대한 대체 컴퍼지션 및 혼합 모드를 선언하는 속성을 가져오거나 설정합니다. 이는 혼합 XAML/Microsoft DirectX UI와 관련된 요소와 관련이 있습니다. (다음에서 상속됨 UIElement) |
| ContextFlyout |
이 요소와 연결된 플라이아웃을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| DataContext |
FrameworkElement에 대한 데이터 컨텍스트를 가져오거나 설정합니다. 데이터 컨텍스트의 일반적인 사용은 FrameworkElement 가 {Binding} 태그 확장을 사용하고 데이터 바인딩에 참여하는 경우입니다. |
| DataContextProperty |
DataContext 종속성 속성을 식별합니다. |
| DesiredSize |
레이아웃 프로세스의 측정 단계에서 이 UIElement 가 계산한 크기를 가져옵니다. (다음에서 상속됨 UIElement) |
| Dispatcher |
이 개체가 연결된 CoreDispatcher 를 가져옵니다. CoreDispatcher는 코드가 비 UI 스레드에서 시작된 경우에도 UI 스레드에서 DependencyObject에 액세스할 수 있는 기능을 나타냅니다. (다음에서 상속됨 DependencyObject) |
| ExitDisplayModeOnAccessKeyInvoked |
액세스 키를 호출할 때 액세스 키 표시가 해제되는지 여부를 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| FlowDirection |
레이아웃을 제어하는 부모 요소 내에서 텍스트 및 기타 UI 요소가 흐르는 방향을 가져오거나 설정합니다. 이 속성은 LeftToRight 또는 RightToLeft로 설정할 수 있습니다. 모든 요소에서 FlowDirection을 RightToLeft 로 설정하면 오른쪽 맞춤, 읽기 순서가 오른쪽에서 왼쪽으로, 컨트롤 레이아웃이 오른쪽에서 왼쪽으로 흐릅니다. |
| FlowDirectionProperty |
FlowDirection 종속성 속성을 식별합니다. |
| FocusVisualMargin |
FrameworkElement에 대한 포커스 시각적 개체의 외부 여백을 가져오거나 설정합니다. |
| FocusVisualMarginProperty |
FocusVisualMargin 종속성 속성을 식별합니다. |
| FocusVisualPrimaryBrush |
FrameworkElement에 대한 또는 포커스 시각적 개체의 바깥 테두리를 |
| FocusVisualPrimaryBrushProperty |
FocusVisualPrimaryBrush 종속성 속성을 식별합니다. |
| FocusVisualPrimaryThickness |
FrameworkElement에 대한 또는 포커스 시각적 개체의 |
| FocusVisualPrimaryThicknessProperty |
FocusVisualPrimaryThickness 종속성 속성을 식별합니다. |
| FocusVisualSecondaryBrush |
FrameworkElement에 대한 또는 포커스 시각적 개체의 내부 테두리를 |
| FocusVisualSecondaryBrushProperty |
FocusVisualSecondaryBrush 종속성 속성을 식별합니다. |
| FocusVisualSecondaryThickness |
FrameworkElement에 대한 또는 포커스 시각적 개체의 |
| FocusVisualSecondaryThicknessProperty |
FocusVisualSecondaryThickness 종속성 속성을 식별합니다. |
| Height |
FrameworkElement의 제안된 높이를 가져오거나 설정합니다. |
| HeightProperty |
Height 종속성 속성을 식별합니다. |
| HighContrastAdjustment |
고대비 테마를 사용할 때 프레임워크가 요소의 시각적 속성을 자동으로 조정하는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| HorizontalAlignment |
패널 또는 항목 컨트롤과 같은 레이아웃 부모로 구성될 때 FrameworkElement 에 적용되는 가로 맞춤 특성을 가져오거나 설정합니다. |
| HorizontalAlignmentProperty |
HorizontalAlignment 종속성 속성을 식별합니다. |
| IsAccessKeyScope |
요소가 자체 액세스 키 scope 정의하는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| IsDoubleTapEnabled |
DoubleTapped 이벤트가 해당 요소에서 발생할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| IsHitTestVisible |
이 UIElement 의 포함된 영역이 적중 횟수 테스트를 위해 실제 값을 반환할 수 있는지 여부를 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| IsHoldingEnabled |
Holding 이벤트가 해당 요소에서 발생할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| IsLoaded |
요소가 요소 트리에 추가되었으며 상호 작용할 준비가 되었는지 여부를 나타내는 값을 가져옵니다. |
| IsRightTapEnabled |
RightTapped 이벤트가 해당 요소에서 발생할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| IsTapEnabled |
Tapped 이벤트가 해당 요소에서 발생할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| KeyboardAcceleratorPlacementMode |
컨트롤 도구 설명 이 연결된 키보드 가속기 키 조합을 표시하는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| KeyboardAcceleratorPlacementTarget |
액셀러레이터 키 조합을 표시하는 컨트롤 도구 설명을 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| KeyboardAccelerators |
키보드를 사용하여 작업을 호출하는 키 조합의 컬렉션을 가져옵니다. 가속기는 일반적으로 단추 또는 메뉴 항목에 할당됩니다.
|
| KeyTipHorizontalOffset |
키 팁이 UIElement와 관련하여 배치되는 간격을 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| KeyTipPlacementMode |
UIElement의 경계와 관련하여 액세스 키 키 팁이 배치되는 위치를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| KeyTipTarget |
액세스 키 키 팁이 대상으로 하는 요소를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| KeyTipVerticalOffset |
키 팁이 UI 요소와 관련하여 얼마나 위 또는 아래로 배치되는지를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| Language |
FrameworkElement 및 개체 표현 및 UI에서 현재 FrameworkElement의 모든 자식 요소에도 적용되는 지역화/세계화 언어 정보를 가져오거나 설정합니다. |
| LanguageProperty |
언어 종속성 속성을 식별합니다. |
| Lights |
이 요소에 연결된 XamlLight 개체의 컬렉션을 가져옵니다. (다음에서 상속됨 UIElement) |
| ManipulationMode |
UIElement 동작 및 제스처와의 상호 작용에 사용되는 ManipulationModes 값을 가져오거나 설정합니다. 이 값을 설정하면 앱 코드에서 이 요소의 조작 이벤트를 처리할 수 있습니다. (다음에서 상속됨 UIElement) |
| Margin |
FrameworkElement의 외부 여백을 가져오거나 설정합니다. |
| MarginProperty |
Margin 종속성 속성을 식별합니다. |
| MaxHeight |
FrameworkElement의 최대 높이 제약 조건을 가져오거나 설정합니다. |
| MaxHeightProperty |
MaxHeight 종속성 속성을 식별합니다. |
| MaxWidth |
FrameworkElement의 최대 너비 제약 조건을 가져오거나 설정합니다. |
| MaxWidthProperty |
MaxWidth 종속성 속성을 식별합니다. |
| MinHeight |
FrameworkElement의 최소 높이 제약 조건을 가져오거나 설정합니다. |
| MinHeightProperty |
MinHeight 종속성 속성을 식별합니다. |
| MinWidth |
FrameworkElement의 최소 너비 제약 조건을 가져오거나 설정합니다. |
| MinWidthProperty |
MinWidth 종속성 속성을 식별합니다. |
| Name |
개체의 식별 이름을 가져오거나 설정합니다. XAML 프로세서가 XAML 태그에서 개체 트리를 만들 때 런타임 코드는 이 이름으로 XAML 선언 개체를 참조할 수 있습니다. |
| NameProperty |
Name 종속성 속성을 식별합니다. |
| Opacity |
개체의 불투명도를 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| OpacityTransition |
Opacity 속성의 변경 내용에 애니메이션 효과를 주는 ScalarTransition을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| Parent |
개체 트리에서 이 FrameworkElement 의 부모 개체를 가져옵니다. |
| PointerCaptures |
포인터 값으로 표시되는 캡처된 모든 포인터의 집합 을 가져옵니다. (다음에서 상속됨 UIElement) |
| Projection |
이 요소를 렌더링할 때 적용할 원근 투영(3차원 효과)을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| RenderSize |
UIElement의 최종 렌더링 크기를 가져옵니다. 사용은 권장되지 않습니다. 주의 사항을 참조하세요. (다음에서 상속됨 UIElement) |
| RenderTransform |
UIElement의 렌더링 위치에 영향을 주는 변환 정보를 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| RenderTransformOrigin |
RenderTransform에서 선언한 가능한 렌더링 변환의 원점(UIElement 경계를 기준으로)을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| RequestedTheme |
리소스 결정을 위해 UIElement (및 해당 자식 요소)에서 사용하는 UI 테마를 가져오거나 설정합니다. RequestedTheme로 지정하는 UI 테마는 앱 수준 RequestedTheme을 재정의할 수 있습니다. |
| RequestedThemeProperty |
RequestedTheme 종속성 속성을 식별합니다. |
| Resources |
로컬로 정의된 리소스 사전을 가져옵니다. XAML에서는 XAML 암시적 컬렉션 구문을 통해 리소스 항목을 속성 요소의 |
| Rotation |
시계 방향 회전 각도를 도 단위로 가져오거나 설정합니다. RotationAxis 및 CenterPoint를 기준으로 회전합니다. 요소의 렌더링 위치에 영향을 줍니다. (다음에서 상속됨 UIElement) |
| RotationAxis |
요소를 회전할 축을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| RotationTransition |
Rotation 속성의 변경 내용에 애니메이션 효과를 주는 ScalarTransition을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| Scale |
요소의 배율을 가져오거나 설정합니다. 요소의 CenterPoint를 기준으로 배율을 조정합니다. 요소의 렌더링 위치에 영향을 줍니다. (다음에서 상속됨 UIElement) |
| ScaleTransition |
Scale 속성의 변경 내용에 애니메이션 효과를 주는 Vector3Transition을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| Shadow |
요소에 의해 캐스팅된 그림자 효과를 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| Style |
레이아웃 및 렌더링 중에 이 개체에 적용되는 instance Style을 가져오거나 설정합니다. |
| StyleProperty |
Style 종속성 속성을 식별합니다. |
| TabFocusNavigation |
이 컨트롤에 대해 Tabbing 및 TabIndex 가 작동하는 방식을 수정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| Tag |
이 개체에 대한 사용자 지정 정보를 저장하는 데 사용할 수 있는 임의의 개체 값을 가져오거나 설정합니다. |
| TagProperty |
Tag 종속성 속성을 식별합니다. |
| Transform3D |
이 요소를 렌더링할 때 적용할 3차원 변환 효과를 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| TransformMatrix |
요소에 적용할 변환 행렬을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| Transitions |
UIElement에 적용되는 전환 스타일 요소의 컬렉션을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| Translation |
요소의 x, y 및 z 렌더링 위치를 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| TranslationTransition |
Translation 속성의 변경 내용에 애니메이션 효과를 주는 Vector3Transition을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| Triggers |
FrameworkElement에 대해 정의된 애니메이션에 대한 트리거 컬렉션을 가져옵니다. 일반적으로 사용되지 않습니다. 설명 부분을 참조하세요. |
| UIContext |
요소의 컨텍스트 식별자를 가져옵니다. (다음에서 상속됨 UIElement) |
| UseLayoutRounding |
개체 및 해당 시각적 하위 트리에 대한 렌더링이 렌더링을 전체 픽셀에 맞추는 반올림 동작을 사용해야 하는지 여부를 결정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| VerticalAlignment |
패널 또는 항목 컨트롤과 같은 부모 개체에서 작성될 때 FrameworkElement 에 적용되는 세로 맞춤 특성을 가져오거나 설정합니다. |
| VerticalAlignmentProperty |
VerticalAlignment 종속성 속성을 식별합니다. |
| Visibility |
UIElement의 표시 유형을 가져오거나 설정합니다. 표시되지 않는 UIElement 는 렌더링되지 않으며 원하는 크기를 레이아웃에 전달하지 않습니다. (다음에서 상속됨 UIElement) |
| Width |
FrameworkElement의 너비를 가져오거나 설정합니다. |
| WidthProperty |
Width 종속성 속성을 식별합니다. |
| XamlRoot |
이 요소를 볼 을 가져오거나 설정합니다 |
| XYFocusDownNavigationStrategy |
아래쪽 탐색의 대상 요소를 결정하는 데 사용되는 전략을 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| XYFocusKeyboardNavigation |
키보드 방향 화살표를 사용하여 탐색을 사용하거나 사용하지 않도록 설정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| XYFocusLeftNavigationStrategy |
왼쪽 탐색의 대상 요소를 결정하는 데 사용되는 전략을 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| XYFocusRightNavigationStrategy |
오른쪽 탐색의 대상 요소를 결정하는 데 사용되는 전략을 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
| XYFocusUpNavigationStrategy |
위쪽 탐색의 대상 요소를 결정하는 데 사용되는 전략을 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 UIElement) |
메서드
| AddHandler(RoutedEvent, Object, Boolean) |
지정된 라우트된 이벤트에 대해 라우트된 이벤트 처리기를 추가하여 해당 처리기를 현재 요소의 처리기 컬렉션에 추가합니다. handledEventsToo를true로 지정하여 이벤트가 다른 곳에서 처리되더라도 제공된 처리기를 호출하도록 합니다. (다음에서 상속됨 UIElement) |
| Arrange(Rect) |
자식 개체의 위치를 지정하고 UIElement의 크기를 결정합니다. 자식 요소에 대한 사용자 지정 레이아웃을 구현하는 부모 개체는 레이아웃 재정의 구현에서 이 메서드를 호출하여 재귀 레이아웃 업데이트를 구성해야 합니다. (다음에서 상속됨 UIElement) |
| ArrangeOverride(Size) |
레이아웃의 "정렬" 패스에 대한 동작을 제공합니다. 클래스는 이 메서드를 재정의하여 고유한 "Arrange" 패스 동작을 정의할 수 있습니다. |
| CancelDirectManipulations() |
현재 UIElement를 포함하는 ScrollViewer 부모에서 진행 중인 직접 조작 처리(시스템 정의 이동/확대/축소)를 취소합니다. (다음에서 상속됨 UIElement) |
| CapturePointer(Pointer) |
포인터 캡처를 UIElement로 설정합니다. 캡처되면 캡처가 있는 요소만 포인터 관련 이벤트를 발생합니다. (다음에서 상속됨 UIElement) |
| ClearValue(DependencyProperty) |
종속성 속성의 로컬 값을 지웁니다. (다음에서 상속됨 DependencyObject) |
| DeferTree(DependencyObject) |
나중에 유추를 취소할 수 있는 방식으로 XAML 시각적 트리에서 지정된 요소를 제거합니다. |
| FindName(String) |
지정된 식별자 이름이 있는 개체를 검색합니다. |
| FindSubElementsForTouchTargeting(Point, Rect) |
UIElement 하위 클래스가 터치 대상 지정을 확인하는 데 도움이 되는 자식 요소를 노출할 수 있도록 합니다. (다음에서 상속됨 UIElement) |
| GetAnimationBaseValue(DependencyProperty) |
애니메이션이 활성화되지 않은 경우 적용되는 종속성 속성에 대해 설정된 모든 기본 값을 반환합니다. (다음에서 상속됨 DependencyObject) |
| GetBindingExpression(DependencyProperty) |
지정된 속성의 바인딩을 나타내는 BindingExpression 을 반환합니다. |
| GetChildrenInTabFocusOrder() |
UIElement 하위 클래스가 Tab 포커스에 참여하는 자식 요소를 노출할 수 있도록 합니다. (다음에서 상속됨 UIElement) |
| GetValue(DependencyProperty) |
DependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다. (다음에서 상속됨 DependencyObject) |
| GoToElementStateCore(String, Boolean) |
파생 클래스에서 구현되는 경우 컨트롤 시작 시 모든 상태에 대해 XAML을 로드하는 대신 코드에서 컨트롤 템플릿에 대한 시각적 트리의 상태별 생성을 사용하도록 설정합니다. |
| InvalidateArrange() |
UIElement의 정렬 상태(레이아웃)를 무효화합니다. 무효화 후 UIElement 의 레이아웃이 업데이트되어 비동기적으로 발생합니다. (다음에서 상속됨 UIElement) |
| InvalidateMeasure() |
UIElement의 측정 상태(레이아웃)를 무효화합니다. (다음에서 상속됨 UIElement) |
| InvalidateViewport() |
유효 뷰포트를 계산하는 데 사용되는 UIElement 의 뷰포트 상태를 무효화합니다. |
| Measure(Size) |
UIElement의 DesiredSize를 업데이트. 일반적으로 레이아웃 자식에 대한 사용자 지정 레이아웃을 구현하는 개체는 자체 MeasureOverride 구현에서 이 메서드를 호출하여 재귀 레이아웃 업데이트를 형성합니다. (다음에서 상속됨 UIElement) |
| MeasureOverride(Size) |
레이아웃 주기의 "측정값" 패스에 대한 동작을 제공합니다. 클래스는 이 메서드를 재정의하여 고유한 "측정값" 전달 동작을 정의할 수 있습니다. |
| OnApplyTemplate() |
애플리케이션 코드 또는 내부 프로세스(예: 다시 빌드 레이아웃 패스)가 ApplyTemplate을 호출할 때마다 호출됩니다. 즉, UI 요소가 앱에 표시되기 직전에 메서드가 호출됩니다. 클래스의 기본 템플릿 후 논리에 영향을 주도록 이 메서드를 재정의합니다. |
| OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
BringIntoViewRequested 이벤트가 발생하기 전에 호출됩니다. (다음에서 상속됨 UIElement) |
| OnCreateAutomationPeer() |
파생 클래스에서 구현되는 경우 는 Microsoft UI 자동화 인프라에 대한 클래스별 AutomationPeer 구현을 반환합니다. (다음에서 상속됨 UIElement) |
| OnDisconnectVisualChildren() |
클래스별 콘텐츠 또는 자식 속성에서 항목을 제거할 때 레이아웃 및 논리가 작동하는 방식을 구현하려면 이 메서드를 재정의합니다. (다음에서 상속됨 UIElement) |
| OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
바로 가기 키(또는 액셀러레이터) 가 앱에서 처리될 때 호출됩니다. 키보드 가속기가 호출될 때 앱이 응답하는 방식을 처리하려면 이 메서드를 재정의합니다. (다음에서 상속됨 UIElement) |
| OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
바로 가기 키(또는 액셀러레이터) 가 앱에서 처리되기 직전에 호출됩니다. 애플리케이션 코드 또는 내부 프로세스에서 ProcessKeyboardAccelerators를 호출할 때마다 호출됩니다. 기본 가속기 처리에 영향을 주도록 이 메서드를 재정의합니다. (다음에서 상속됨 UIElement) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
애니메이션 효과를 적용할 수 있는 속성을 정의합니다. (다음에서 상속됨 UIElement) |
| PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
파생 클래스에서 재정의되는 경우 애니메이션 효과를 적용할 수 있는 속성을 정의합니다. (다음에서 상속됨 UIElement) |
| ReadLocalValue(DependencyProperty) |
로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다. (다음에서 상속됨 DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
이 DependencyObject instance 특정 DependencyProperty의 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다. (다음에서 상속됨 DependencyObject) |
| ReleasePointerCapture(Pointer) |
이 UIElement에서 특정 포인터 하나를 캡처하기 위한 포인터 캡처를 해제합니다. (다음에서 상속됨 UIElement) |
| ReleasePointerCaptures() |
이 요소가 보유한 모든 포인터 캡처를 해제합니다. (다음에서 상속됨 UIElement) |
| RemoveHandler(RoutedEvent, Object) |
이 UIElement에서 지정된 라우트된 이벤트 처리기를 제거합니다. 일반적으로 해당 처리기는 AddHandler에 의해 추가되었습니다. (다음에서 상속됨 UIElement) |
| SetBinding(DependencyProperty, BindingBase) |
제공된 바인딩 개체를 사용하여 FrameworkElement에 바인딩을 연결합니다. |
| 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 속성 값이 변경되면 발생합니다. |
| BringIntoViewRequested |
이 요소 또는 해당 하위 항목 중 하나에서 StartBringIntoView 가 호출될 때 발생합니다. (다음에서 상속됨 UIElement) |
| CharacterReceived |
입력 큐에서 구성된 단일 문자를 수신할 때 발생합니다. (다음에서 상속됨 UIElement) |
| ContextCanceled |
컨텍스트 입력 제스처가 조작 제스처로 계속 진행되어 요소에 컨텍스트 플라이아웃이 열리지 않도록 알릴 때 발생합니다. (다음에서 상속됨 UIElement) |
| ContextRequested |
사용자가 마우스 오른쪽 단추 클릭과 같은 컨텍스트 입력 제스처를 완료할 때 발생합니다. (다음에서 상속됨 UIElement) |
| DataContextChanged |
FrameworkElement.DataContext 속성의 값이 변경될 때 발생합니다. |
| DoubleTapped |
이 요소의 적중 테스트 영역에서 처리되지 않은 DoubleTap 상호 작용이 발생할 때 발생합니다. (다음에서 상속됨 UIElement) |
| DragEnter |
입력 시스템이 이 요소를 대상으로 사용하여 기본 끌기 이벤트를 보고할 때 발생합니다. (다음에서 상속됨 UIElement) |
| DragLeave |
입력 시스템이 이 요소를 원본으로 사용하여 기본 끌기 이벤트를 보고할 때 발생합니다. (다음에서 상속됨 UIElement) |
| DragOver |
입력 시스템에서 이 요소를 잠재적인 놓기 대상으로 사용하는 기본 끌기 이벤트를 보고하면 발생합니다. (다음에서 상속됨 UIElement) |
| DragStarting |
끌기 작업이 시작될 때 발생합니다. (다음에서 상속됨 UIElement) |
| Drop |
입력 시스템에서 이 요소를 놓기 대상으로 사용하는 기본 놓기 이벤트를 보고하면 발생합니다. (다음에서 상속됨 UIElement) |
| DropCompleted |
원본이 종료되면 이 요소와 함께 끌어서 놓기 작업이 수행되는 경우에 발생합니다. (다음에서 상속됨 UIElement) |
| EffectiveViewportChanged |
FrameworkElement의 유효 뷰포트가 변경될 때 발생합니다. |
| GettingFocus |
UIElement가 포커스를 받기 전에 발생합니다. 이 이벤트는 이벤트가 버블링되는 동안 포커스가 이동되지 않도록 동기적으로 발생합니다. (다음에서 상속됨 UIElement) |
| GotFocus |
UIElement가 포커스를 받을 때 발생합니다. 이 이벤트는 비동기적으로 발생하므로 버블링이 완료되기 전에 포커스가 다시 이동할 수 있습니다. (다음에서 상속됨 UIElement) |
| Holding |
처리되지 않은 보류 상호 작용이 이 요소의 적중 테스트 영역에서 발생할 때 발생합니다. (다음에서 상속됨 UIElement) |
| KeyDown |
UIElement에 포커스가 있는 동안 키보드 키를 누를 때 발생합니다. (다음에서 상속됨 UIElement) |
| KeyUp |
UIElement에 포커스가 있는 동안 키보드 키가 해제될 때 발생합니다. (다음에서 상속됨 UIElement) |
| LayoutUpdated |
레이아웃 관련 속성 변경 값 또는 레이아웃을 새로 고치는 다른 작업으로 인해 시각적 트리의 레이아웃이 변경되면 발생합니다. |
| Loaded |
FrameworkElement가 생성되어 개체 트리에 추가되고 상호 작용할 준비가 되었을 때 발생합니다. |
| Loading |
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의 값을 변경할 때 발생합니다. |
| Tapped |
처리되지 않은 탭 상호 작용이 이 요소의 적중 테스트 영역에서 발생할 때 발생합니다. (다음에서 상속됨 UIElement) |
| Unloaded |
이 개체가 더 이상 기본 개체 트리에 연결되지 않은 경우에 발생합니다. |