UIElement 클래스

2013-12-13

UIElement는 시각적 모양이 있고 기본 입력을 처리할 수 있는 대부분의 개체에 대한 기본 클래스입니다.

Namespace:  System.Windows
어셈블리:  System.Windows(System.Windows.dll)

public abstract class UIElement : DependencyObject

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

  이름설명
Public 속성AllowDropUIElement가 끌어서 놓기 작업 용도의 놓기 대상이 될 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다.
Public 속성CacheMode가능한 경우 렌더링된 내용을 캐시해야 함을 나타내는 값을 가져오거나 설정합니다.
Public 속성ClipUIElement의 콘텐츠 윤곽선을 정의하는 데 사용되는 Geometry를 가져오거나 설정합니다.
Public 속성DesiredSize레이아웃 프로세스의 측정 처리 단계에서 이 UIElement가 계산한 크기를 가져옵니다.
Public 속성Dispatcher이 개체와 관련된 Dispatcher를 가져옵니다. (DependencyObject에서 상속됨)
Public 속성IsHitTestVisibleUIElement의 포함된 영역이 적중 테스트에 대해 true 값을 반환할 수 있는지 여부를 가져오거나 설정합니다.
Public 속성Opacity개체의 불투명도 수준을 가져오거나 설정합니다.
Public 속성OpacityMask이 개체의 영역에 대한 불투명도를 변경하는 데 사용된 브러시를 가져오거나 설정합니다.
Public 속성ProjectionUIElement를 렌더링할 때 적용할 원근감 프로젝션(3차원 효과)을 가져오거나 설정합니다.
Public 속성RenderSizeUIElement의 마지막으로 렌더링된 크기를 가져옵니다.
Public 속성RenderTransformUIElement의 렌더링 위치에 영향을 주는 변환 정보를 가져오거나 설정합니다.
Public 속성RenderTransformOriginUIElement의 영역을 기준으로 RenderTransform에서 선언하는 가능한 렌더링 변환의 원점을 가져오거나 설정합니다.
Public 속성UseLayoutRounding개체 및 해당 시각적 하위 트리를 렌더링할 때 전체 픽셀에 맞게 렌더링하는 반올림 동작을 사용할지 여부를 결정하는 값을 가져오거나 설정합니다.
Public 속성VisibilityUIElement의 표시 유형을 가져오거나 설정합니다. 표시되지 않는 UIElement는 렌더링되지 않으며 필요한 크기를 레이아웃에 알려 주지 않습니다.
맨 위

  이름설명
Public 메서드AddHandler지정된 라우트된 이벤트에 대한 라우트된 이벤트 처리기를 현재 요소의 처리기 컬렉션에 추가하는 방식으로 추가합니다. handledEventsTootrue로 지정하여 이벤트 경로를 따라 다른 요소에 의해 이미 처리된 것으로 표시된 라우트된 이벤트에 대해 제공된 처리기를 호출합니다.
Public 메서드Arrange자식 개체 요소를 배치하고 UIElement의 크기를 결정합니다. 자식 요소에 대한 사용자 지정 레이아웃을 구현하는 부모 개체는 이 메서드를 자체 레이아웃 재정의 구현에서 호출하여 재귀적 레이아웃 업데이트를 형성합니다.
Public 메서드CaptureMouse터치 캡처를 UIElement로 설정합니다.
Public 메서드CheckAccess호출 스레드에서 이 개체에 액세스할 수 있는지 여부를 확인합니다. (DependencyObject에서 상속됨)
Public 메서드ClearValue종속성 속성의 로컬 값을 지웁니다. (DependencyObject에서 상속됨)
Public 메서드Equals(Object)지정한 Object가 현재 Object와 같은지 확인합니다. (Object에서 상속됨)
Protected 메서드Finalize가비지 수집기에서 Object를 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드GetAnimationBaseValueWindows Phone 종속성 속성에 대해 설정되어 있고 애니메이션이 활성 상태가 아닐 때 적용되는 기준 값을 반환합니다. (DependencyObject에서 상속됨)
Public 메서드GetHashCode특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드GetValueDependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다. (DependencyObject에서 상속됨)
Public 메서드InvalidateArrangeUIElement의 정렬 상태(레이아웃)를 무효화합니다. 무효화된 후에는 UIElement의 레이아웃이 업데이트됩니다. 이 업데이트 작업은 비동기적으로 수행됩니다.
Public 메서드InvalidateMeasureUIElement의 측정 상태(레이아웃)를 무효화합니다.
Public 메서드MeasureUIElementDesiredSize를 업데이트합니다. 일반적으로 레이아웃 자식에 대해 사용자 지정 레이아웃을 구현하는 개체는 자체 MeasureOverride 구현에서 이 메서드를 호출하여 재귀적 레이아웃 업데이트를 형성합니다.
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Protected 메서드OnCreateAutomationPeer파생 클래스에서 구현되는 경우 Windows Phone 자동화 인프라에 대한 클래스 고유 AutomationPeer 구현을 반환합니다.
Public 메서드ReadLocalValue로컬 값이 설정된 경우, 종속성 속성의 로컬 값을 반환합니다. (DependencyObject에서 상속됨)
Public 메서드ReleaseMouseCapture터치 캡처를 UIElement에서 제거합니다. 이 메서드를 호출한 후에는 일반적으로 어떤 개체도 터치 캡처를 보유하지 않습니다.
Public 메서드RemoveHandlerUIElement에서 지정한 라우트된 이벤트 처리기를 제거합니다.
Public 메서드SetValueDependencyObject에 종속성 속성의 로컬 값을 설정합니다. (DependencyObject에서 상속됨)
Public 메서드ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
Public 메서드TransformToVisual좌표를 UIElement에서 지정된 개체로 변환하는 데 사용할 수 있는 변환 개체를 반환합니다.
Public 메서드UpdateLayout모든 UIElement 자식 개체의 위치가 레이아웃에 맞게 적절하게 업데이트되도록 합니다.
맨 위

  이름설명
Public 이벤트DoubleTapUIElement 위에 있는 동안 DoubleTap 제스처가 커밋되면 발생합니다.
Public 이벤트GotFocusUIElement가 포커스를 받을 때 발생합니다.
Public 이벤트HoldUIElement 위에 있는 동안 Hold 제스처가 커밋되면 발생합니다.
Public 이벤트KeyDownUIElement에 포커스가 있을 때 키보드 키를 누르면 발생합니다.
Public 이벤트KeyUpUIElement에 포커스가 있을 때 키보드 키를 놓으면 발생합니다.
Public 이벤트LostFocusUIElement가 포커스를 잃을 때 발생합니다.
Public 이벤트LostMouseCaptureUIElement가 터치 캡처를 잃을 때 발생합니다.
Public 이벤트ManipulationCompletedUIElement에서 조작이 완료되고 활동이 없게 될 때 발생합니다.
Public 이벤트ManipulationDelta입력 장치에서 조작 중에 위치를 변경하면 발생합니다.
Public 이벤트ManipulationStarted입력 장치가 UIElement에서 조작을 시작할 때 발생합니다.
Public 이벤트MouseEnter화면 누르기가 UIElement의 경계 영역 내에서 발생할 때 발생합니다.
Public 이벤트MouseLeave터치 이벤트가 UIElement의 경계 영역 밖에서 발생할 때 발생합니다.
Public 이벤트MouseLeftButtonDownUIElement를 누르면 발생합니다.
Public 이벤트MouseLeftButtonUpUIElement에서 손가락을 올릴 때(또는 UIElement에서 터치 캡처를 보류하는 동안) 발생합니다.
Public 이벤트MouseMove화면의 손가락 좌표 위치가 UIElement를 터치하는 동안(또는 UIElement가 터치 캡처를 보류하는 동안) 발생합니다.
Public 이벤트MouseWheel인프라입니다. 마우스 포인터가 UIElement 위에 있거나 UIElement에 포커스가 있는 동안 사용자가 마우스 휠을 돌리면 이 이벤트가 발생합니다.
Public 이벤트TapUIElement 위에 있는 동안 Tap 제스처가 커밋되면 발생합니다.
Public 이벤트TextInputUI 요소가 장치 독립적인 방식으로 텍스트를 가져올 때 발생합니다.
Public 이벤트TextInputStartUI 요소가 장치 독립적인 방식으로 텍스트를 처음 가져올 때 발생합니다.
Public 이벤트TextInputUpdateIME(입력기)를 통해 텍스트가 계속 작성될 때 발생합니다.
맨 위

  이름설명
Public 필드정적 멤버AllowDropPropertyAllowDrop 종속성 속성을 식별합니다.
Public 필드정적 멤버CacheModePropertyCacheMode 종속성 속성을 식별합니다.
Public 필드정적 멤버ClipPropertyClip 종속성 속성을 식별합니다.
Public 필드정적 멤버DoubleTapEventDoubleTap 라우트된 이벤트를 식별합니다.
Public 필드정적 멤버HoldEventHold 라우트된 이벤트를 식별합니다.
Public 필드정적 멤버IsHitTestVisiblePropertyIsHitTestVisible 종속성 속성을 식별합니다.
Public 필드정적 멤버KeyDownEventKeyDown 라우트된 이벤트를 식별합니다.
Public 필드정적 멤버KeyUpEventKeyUp 라우트된 이벤트를 식별합니다.
Public 필드정적 멤버ManipulationCompletedEventManipulationCompleted 라우트된 이벤트를 식별합니다.
Public 필드정적 멤버ManipulationDeltaEventManipulationDelta 라우트된 이벤트를 식별합니다.
Public 필드정적 멤버ManipulationStartedEventManipulationStarted 라우트된 이벤트를 식별합니다.
Public 필드정적 멤버MouseLeftButtonDownEventMouseLeftButtonDown 라우트된 이벤트를 식별합니다.
Public 필드정적 멤버MouseLeftButtonUpEventMouseLeftButtonUp 라우트된 이벤트를 식별합니다.
Public 필드정적 멤버OpacityMaskPropertyIsHitTestVisible 종속성 속성을 식별합니다.
Public 필드정적 멤버OpacityPropertyIsHitTestVisible 종속성 속성을 식별합니다.
Public 필드정적 멤버ProjectionPropertyProjection 종속성 속성을 식별합니다.
Public 필드정적 멤버RenderTransformOriginPropertyRenderTransformOrigin 종속성 속성을 식별합니다.
Public 필드정적 멤버RenderTransformPropertyRenderTransform 종속성 속성을 식별합니다.
Public 필드정적 멤버TapEventTap 라우트된 이벤트를 식별합니다.
Public 필드정적 멤버TextInputEventTextInput 라우트된 이벤트를 식별합니다.
Public 필드정적 멤버TextInputStartEventTextInputStart 라우트된 이벤트를 식별합니다.
Public 필드정적 멤버TextInputUpdateEventTextInputUpdate 라우트된 이벤트를 식별합니다.
Public 필드정적 멤버UseLayoutRoundingPropertyUseLayoutRounding 종속성 속성을 식별합니다.
Public 필드정적 멤버VisibilityPropertyVisibility 종속성 속성을 식별합니다.
맨 위

UIElement는 레이아웃 특성을 지정하는 시작점으로 사용될 수 있으며 FrameworkElement는 추가적인 레이아웃 기능을 제공합니다.

wphone UI의 보이는 요소에 대한 입력 동작은 대부분 UIElement 클래스에 정의되어 있습니다. 이러한 입력 동작에는 키보드, 터치 스크린 입력 및 포커스 이벤트가 포함됩니다. 이러한 이벤트 중 일부는 라우트된 이벤트입니다. 라우트된 이벤트는 개체 트리의 부모 개체가 자식 개체의 입력 이벤트가 처리되지 않은 경우 이를 처리할 수 있도록 기본 제공 이벤트 처리 알림 시스템을 지원합니다. 이 입력 이벤트 동작은 입력 영역을 그룹화하거나 컨트롤을 합성하는 데 유용합니다.

UIElement는 포커스 보고를 위한 이벤트(GotFocus, LostFocus)를 정의합니다. 그러나 포커스를 프로그래밍 방식으로 설정하기 위한 API는 UIElement에서 정의하지 않습니다. 그러나 이 기능은 Control 클래스에서 정의하며 UI에서 대부분의 요소에 대해 제공됩니다.

UIElement는 public 생성자를 노출하지 않습니다. 일반적으로 UIElement 또는 FrameworkElement에서 직접 파생되지 않습니다. 파생된 사용자 지정 클래스에 일반적으로 사용되는 기본 클래스는 다음과 같습니다.

Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

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

표시:
© 2015 Microsoft