내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

Point Structure

2차원 평면의 한 점을 정의하는 X 좌표와 Y 좌표의 정렬된 쌍을 나타냅니다.

구문


var point = {
    x : /* 사용자 값 */,
    y : /* 사용자 값 */
}


<object property="X,Y"/>
-or
<object property="X Y"/>

XAML Values

X

Point 값의 X 좌표 구성 요소입니다.

Y

Point 값의 Y 좌표 구성 요소입니다.

특성

[Version(0x06020000)]

멤버

Point구조체에는 다음과 같은 형식의 멤버가 있습니다.

생성자

Point구조체에는 다음과 같은 생성자가 있습니다.

생성자Description
Point [C#, VB]Initializes a Point structure that contains the specified values.
Point [C++, JavaScript]Initializes a Point structure that contains the specified values.

 

필드

Point구조체에는 다음과 같은 필드가 있습니다.

필드데이터 형식Description
X | x [C++, JavaScript]

Number [JavaScript] | System.Single [.NET] | float32 [C++]

점의 가로 위치입니다.

Y | y [C++, JavaScript]

Number [JavaScript] | System.Single [.NET] | float32 [C++]

점의 세로 위치입니다.

 

메서드

The Point 구조체 - 이러한 메서드가 있습니다. C#, Visual Basic 및 C++에서는 다음 위치의 메서드도 상속합니다. Object 클래스.

메서드Description
Equals(Object) [C#, VB]Determines whether the specified object is equal to a Point.
Equals(Point) [C#, VB]Compares two Point structures for equality.
GetHashCode [C#, VB]Gets a hash code for this object.
ToString [C#, VB]Converts a Point to a String representation.
ToString(IFormatProvider) [C#, VB]Creates a String representation of this Point.

 

연산자

Point구조체에는 다음과 같은 연산자가 있습니다.

연산자Description
Equality Compares two Point structures for equality.
Inequality Compares two Point structures for inequality.

 

속성

Point구조체 - 이러한 속성이 있습니다.

속성사용 권한Description

X

읽기/쓰기Gets or sets the X-coordinate value of this Point.

Y

읽기/쓰기Gets or sets the Y-coordinate value of this Point.

 

설명

Point 값이 앱의 주 창 평면의 좌표 공간을 나타내는 경우도 있지만 Point 값을 사용하는 속성에 따라 달라질 수 있는 Point 값을 다르게 해석할 수도 있습니다.

JavaScript:  JavaScript에서 Pointxy 데이터 속성을 가지는 개체입니다. xy 외에 Point 멤버 목록에 나열된 남은 API는 JavaScript 프로그래밍에 적용되지 않습니다.

XAML 구문 참고 사항

Point 값은 Windows 런타임 UI 요소에 대한 XAML 어휘 전반에 걸쳐 그래픽 속성 및 비슷한 UI 속성에 광범위하게 사용됩니다.

공백이나 쉼표를 XY 사이의 구분 기호로 사용할 수 있습니다. 일반적으로 좌표 점에는 구분 기호로 쉼표를 사용합니다.

Point 구조체는 ResourceDictionary에서 리소스로 선언할 수 없습니다.

일부 XAML 사용법에서는 Point 형식을 사용하여 논리적 점을 나타내기도 합니다. 설명 부분의 "논리적 점" 단원을 참조하십시오.

Point의 프로젝션 및 멤버

Microsoft .NET 언어(C# 또는 Microsoft Visual Basic) 또는 Visual C++ 구성 요소 확장(C++/CX)을 사용하는 경우 Point의 비데이터 멤버를 사용할 수 있으며 해당 데이터 멤버는 필드가 아니라 읽기-쓰기 속성으로 노출됩니다.

WRL(Windows Template Runtime Library)을 사용하여 C++로 프로그래밍하는 경우 데이터 멤버 필드만 Point의 멤버로 존재하며 멤버 테이블에 나열된 유틸리티 메서드 또는 속성을 사용할 수 없습니다. WRL 코드는 PointHelper 정적 클래스에서 사용할 수 있는 유사한 유틸리티 메서드에 액세스할 수 있습니다.

Point 값과 이러한 값이 속성에 의해 해석되는 방법

Point 형식은 경우에 따라 좌표 공간에서 위치를 지정하는 용도로도 사용됩니다. 컨텍스트에 따라 위치는 콘텐츠 영역의 참조 프레임이나 특정 레이아웃 요소의 참조 프레임 내에 있을 수 있습니다.

XYPoint에 대해 정수가 아닌 값이 허용되는 경우도 있습니다.

PointXY가 음수인 경우도 있습니다. 일반적으로 Point에서 추가 변환이 없는 경우 의도적으로 참조 프레임 밖에 있는 좌표를 지정하게 됩니다. 하지만 일부 XAML 속성은 음수 X 또는 Y를 사용하는 Point를 잘못된 값으로 거부합니다. 값 제약 조건은 일반적으로 속성에 대한 참조 페이지에 명시되어 있습니다.

논리적 점

C++, C# 또는 Visual Basic API를 사용하는 Windows 스토어 앱의 일부 Point 형식 사용법은 참조의 좌표 프레임과 직접적인 관련이 없을 수도 있습니다. 대신 XY의 값이 각각 0에서 1 사이여야 하는 논리적 점입니다. 이 때문에 XY 값은 정수 값으로 제한되지 않고 부동 소수점 값도 될 수 있습니다. 논리적 점 값은 표시 또는 동작의 런타임 좌표를 다른 속성 또는 설정으로 지정하거나 수정할 수 있도록 해석됩니다. 또는 이러한 점은 좌표 공간과 전혀 관련 없는 정보를 표현하기도 합니다. 논리 점 개념의 예를 들면 Animation.KeySpline(애니메이션 조절) 값, UIElementRenderTransformOrigin, LinearGradientBrushGradientStop.Offset 값이 있습니다.

논리적 점 사용인 Point 값 속성은 0보다 작거나 1보다 큰 값을 무효화할 수 있지만 이 동작은 특정 속성에 따라 다릅니다. 값 제약 조건은 일반적으로 값이 아닌 개별 속성의 참조 페이지에 기록되어 있습니다.

포인트 값 및 XAML 그래픽 API

XAML UI 정의에 사용되는 그래픽 요소는 Point-값 속성을 사용하여 해당 특성을 선언하는 경우가 많습니다. 예를 들어 EllipseGeometryPoint 값을 사용하여 Center 속성을 설정합니다.

그래픽 요소는 두 가지 모델 중 하나를 사용합니다. 일부 그래픽 요소는 FrameworkElement에서 파생됩니다. 이러한 요소에는 UI에 배치할 때 및 요소 속성을 할당할 때 정의된 렌더링 동작이 있습니다. 이 유형의 예는 Windows.UI.Xaml.Shapes 네임 스페이스의 Rectangle 및 기타 모든 형식입니다. 다른 그래픽 요소는 FrameworkElement로부터 파생되지 않으며 고유한 렌더링 동작을 갖지 않습니다. 대신 이러한 요소는 렌더링 동작을 포함하는 다른 일부 요소에 대한 속성 값을 제공하도록 구성됩니다. 예를 들어 LineSegment와 같은 Path.Data를 작성하는 데 사용한 그래픽 요소에는 대체로 Point-값 속성이 있습니다.

일부 그래픽 요소는 단일 속성에 표시된 여러 개의 포인트 값을 사용합니다. 이러한 속성은 PointCollection 형식을 사용합니다. 이러한 속성은 특성 문자열을 구문 분석하여 다중 포인트에 대한 XY 값을 가져오는 XAML 구문도 지원합니다. PointCollection을 사용하는 그래픽 요소 속성의 예로 Polygon.Points가 있습니다.

적중 테스트를 위한 XAML 입력 이벤트의 Point 값

특정 이벤트에 대한 이벤트 데이터에 의해 Point 값이 반환됩니다. 예를 들어 GetCurrentPoint는 앱 UI에서 Pointer 이벤트가 발생한 좌표 값을 제공합니다. 일반적으로 이러한 Point 값은 좌표 참조의 특정 프레임을 참조하고 참조의 해당 프레임임을 알고 있어야 합니다. 입력 이벤트에서는 전체 화면이 아닌 참조 프레임이 주 앱 창입니다. 이렇게 하면 앱이 기본 뷰에 있는 경우 프레임을 일관성 있게 참조할 수 있습니다. GetCurrentPointGetPosition 등 일부 API는 요소 관련 참조 프레임으로 변환하는 방법을 제공합니다. 이 방법은 개별 컨트롤에서 입력 작업 시 유용합니다. 자세한 내용은 빠른 시작: 포인터를 참조하십시오.

또한 XAML UI에는 적중 테스트라는 개념도 있습니다. XAML UI에서는 사용자가 UI의 특정 좌표 위치에서 포인터 작업을 수행하는 경우 유틸리티 메서드를 사용하여 입력 이벤트의 발생 방법을 테스트할 수 있습니다. 예를 들어 FindElementsInHostCoordinates의 서명 두 개는 FindSubElementsForTouchTargeting과 마찬가지로 Point 입력 매개 변수를 사용합니다. 자세한 내용은 마우스 입력에 응답을 참조하십시오.

애니메이션 요소 값

Windows 런타임은 Point를 값으로 사용하고 종속성 속성으로 구현되는 모든 속성의 값에 애니메이션 효과를 주는 수단을 제공합니다. Point의 x 및 y 값을 개별적으로 애니메이션할 수 없고, 구조체에서 종속성 속성이 지원할 수 없기 때문에 Point는 고유한 애니메이션 지원을 가집니다. from-to 애니메이션을 위해 PointAnimation 형식을 사용하거나 키 프레임 애니메이션 동작을 위해 PointAnimationUsingKeyFrames 파생 형식을 사용합니다. Point 값에 애니메이션 효과를 적용하는 방법 및 애니메이션의 작동 방법에 대한 자세한 내용은 스토리보드 애니메이션을 참조하십시오.

요구 사항

지원되는 최소 클라이언트

Windows 8

지원되는 최소 서버

Windows Server 2012

지원되는 최소 전화

Windows Phone 8

Namespace

Windows.Foundation
Windows::Foundation [C++]

Metadata

Windows.winmd
Platform.winmd

어셈블리

System.Runtime.WindowsRuntime.dll

참고 항목

PointAnimation
PointCollection
빠른 시작: 포인터
빠른 시작: 도형 그리기

 

 

표시:
© 2014 Microsoft