정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

Point 구조체

2013-12-13

2차원 공간에서 X 및 Y 좌표 쌍을 나타냅니다. 특정 속성 사용에 대한 논리적 점을 나타낼 수도 있습니다.

Namespace:  System.Windows
어셈블리:  System.Windows(System.Windows.dll)
XMLNS for XAML: xmlns에 매핑되지 않습니다.

public struct Point : IFormattable
<object property="X,Y"/>
-or
<object property="X Y"/>

XAML 값

X

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

Y

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

  • 공백이나 쉼표를 구분 기호로 사용할 수 있습니다. 아래 설명에서 "XAML의 점 값" 제목을 참조하세요.

  • 일부 XAML 사용법에서는 Point 형식을 사용하여 논리 픽셀 좌표 공간의 점 대신 논리적 점을 나타냅니다. 이 경우 XY 값은 0에서 1 사이의 부동 소수점 값이어야 합니다. 아래 설명 단원의 "논리적 점"을 참조하세요.

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

  이름설명
Public 메서드Point지정된 값이 포함된 Point 구조체를 초기화합니다.
맨 위

  이름설명
Public 속성XPoint 구조체의 X 좌표 값을 가져오거나 설정합니다.
Public 속성YPointY 좌표 값을 가져오거나 설정합니다.
맨 위

  이름설명
Public 메서드Equals(Object)지정된 개체가 Point인지 여부와 이 Point와 동일한 값이 포함되어 있는지 여부를 확인합니다. (ValueType.Equals(Object)을(를) 재정의함)
Public 메서드Equals(Point)Point 구조체가 같은지 비교합니다.
Protected 메서드Finalize가비지 수집기에서 Object를 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드GetHashCodePoint의 해시 코드를 반환합니다. (ValueType.GetHashCode()을(를) 재정의함)
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드ToString()PointString 표현을 만듭니다. (ValueType.ToString()을(를) 재정의함)
Public 메서드ToString(IFormatProvider)PointString 표현을 만듭니다.
맨 위

  이름설명
Public 연산자정적 멤버EqualityPoint 구조체가 같은지 비교합니다.
Public 연산자정적 멤버InequalityPoint 구조체가 다른지 비교합니다.
맨 위

  이름설명
명시적 인터페이스 구현Private 메서드IFormattable.ToString인프라입니다. 이 멤버에 대한 설명은 ToString를 참조하세요.
맨 위

Point 구조체는 일반적으로 위치를 지정하는 데 사용됩니다. 컨텍스트에 따라 위치는 전체 Windows Phone 콘텐츠 영역 프레임이나 특정 요소의 참조 프레임 내에 있을 수 있습니다.

Point는 이벤트 처리기에 사용되는 GetPosition 메서드에 대한 호출에서 반환되는 형식입니다. PointAnimationToFrom과 같은 일부 속성에도 Point가 사용됩니다. Point는 적중 텍스트 수행을 위한 한정자로도 사용될 수 있습니다.

PointXY에 정수가 아닌 값이 허용되기는 합니다. 정수가 아닌 값을 광범위하게 사용하는 특정 Point 사용법에 대한 자세한 내용은 아래의 "논리적 점" 단원을 참조하세요.

Point가 적용되는 특정 속성에 따라 XY가 음수일 수 있습니다. 이 경우 추가 변환이 수행되지 않으면 일반적으로 Point 정의가 Windows Phone 콘텐츠 영역 외부의 좌표를 지정하게 됩니다. 대부분의 속성(예: EllipseGeometry.RadiusX)은 XY가 음수인 Point를 거부합니다.

참고참고:

Point 값에 대해 프로그래밍 방식으로 설정할 수 있는 상한은 PositiveInfinity가 아니라 Windows Phone 네이티브 코드에 의해 적용되는 이보다 낮은 값(약 1,000,000)입니다.

XAML의 점 값

Point를 사용하는 XAML 특성의 경우 X,Y 값 쌍을 문자열로 지정할 수 있습니다. XY 간의 구분 기호로 쉼표와 0개 이상의 공백 또는 하나 이상의 공백을 사용할 수 있습니다. 일반적으로 점에는 구분 기호로 쉼표를 사용합니다. 형식 변환기가 형식이 지정된 문자열을 Point 구조체로 변환합니다.

X,Y 문자열에서 쉼표를 구분 기호로 사용하면 쉼표를 소수 구분 기호로 사용하는 문화권 설정에서 10진수 값이 문자열로 입력될 경우 서로 충돌할 수 있습니다. 절대 좌표 공간의 점을 나타내는 Point 사용법(논리적 점이 아닌 사용법)에서는 일반적으로 XY에 정수 값을 사용해야 합니다. XAML에서 Point 특성을 지정할 때 정수가 아닌 PointX 또는 Y 값에 대해 마침표(.)를 사용합니다. 이는 개발 중인 문화권이나 응용프로그램의 향후 대상 문화권에서 이러한 규칙이 적용되지 않는 경우에도 마찬가지입니다.

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

논리적 점

Windows Phone의 일부 Point 구조체 사용법은 좌표 참조 프레임과 직접적인 관련이 없으며 X, Y 값이 각각 0에서 1 사이(포함)여야 하는 논리적 점입니다. 이 때문에 X,Y 값은 정수 값으로 제한되지 않고 부동 소수점 값도 될 수 있습니다. 논리적 점 값은 X 및 Y 크기가 있는 특정 값을 지정할 때 사용하며, 표시 또는 동작에 대한 실제 좌표가 다른 속성으로 지정될 수 있는 경우에는 Point 값이 해당 표시 또는 동작에 매핑됩니다. 논리적 점 사용법의 예로는 애니메이션의 속도를 지정하는 데 사용할 수 있는 KeySpline 값과 기본 RelativeToBoundingBox 모드를 사용할 경우의 몇 가지 LinearGradientBrushRadialGradientBrush 값이 있습니다. 논리적 점 매핑인 Point 구조체의 속성은 0보다 작거나 1보다 큰 값을 무효화할 수 있지만 이는 해당 속성이 어떤 것인지에 따라 달라집니다.

Windows Phone OS

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

Windows Phone

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

표시: