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

Rect 구조체

2013-12-13

사각형의 너비, 높이 및 원점을 설명합니다.

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

public struct Rect : IFormattable
<Rect ...>x,y,width,height</Rect>
<object property="x,y,width,height"/>

XAML 값

x

사각형 왼쪽의 x좌표 위치입니다.

y

사각형 위쪽의 y좌표 위치입니다.

width

사각형의 Width를 나타내는 값입니다.

height

사각형의 Height를 나타내는 값입니다.

  • 쉼표가 아닌 공백을 값 사이의 구분 기호로 사용할 수 있습니다. 두 구분 기호를 함께 사용할 수도 있습니다.

  • 네 값을 모두 지정해야 합니다. 0,0은 x,y에 대한 암시적 기본값이 아니며 문자열에서 네 개 미만의 값을 구문 분석할 수 있는 다른 규칙도 없습니다.

  • X andY는 음수일 수 있습니다. widthheight는 음수일 수 있으며 widthheight가 렌더링 시 적용되는 방향을 반전합니다. 설명을 참조하세요.

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

  이름설명
Public 메서드Rect(Point, Point)지정된 두 지점을 정확히 포함할 수 있는 크기의 Rect 구조체를 초기화합니다.
Public 메서드Rect(Point, Size)원점 및 크기를 기준으로 Rect 구조체를 초기화합니다.
Public 메서드Rect(Double, Double, Double, Double)지정된 X 좌표, Y 좌표, 너비 및 높이를 갖는 Rect 구조체를 초기화합니다.
맨 위

  이름설명
Public 속성Bottom사각형 아래쪽의 y축 값을 가져옵니다.
Public 속성정적 멤버Empty위치와 넓이가 없는 사각형을 나타내는 특수 값을 가져옵니다.
Public 속성Height사각형의 높이를 가져오거나 설정합니다.
Public 속성IsEmpty사각형이 Empty 사각형인지 여부를 나타내는 값을 가져옵니다.
Public 속성Left사각형 왼쪽의 x축 값을 가져옵니다.
Public 속성Right사각형 오른쪽의 x축 값을 가져옵니다.
Public 속성Top사각형 위쪽의 y축 좌표를 가져옵니다.
Public 속성Width사각형의 너비를 가져오거나 설정합니다.
Public 속성X사각형 왼쪽의 x축 값을 가져오거나 설정합니다.
Public 속성Y사각형 위쪽의 y축 값을 가져오거나 설정합니다.
맨 위

  이름설명
Public 메서드ContainsRect에서 설명하는 사각형에 지정된 점이 포함되어 있는지 여부를 나타냅니다.
Public 메서드Equals(Object)지정된 개체가 현재 Rect와 같은지 여부를 나타냅니다. (ValueType.Equals(Object)을(를) 재정의함)
Public 메서드Equals(Rect)지정된 Rect가 현재 Rect와 같은지 여부를 나타냅니다.
Protected 메서드Finalize가비지 수집기에서 Object를 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드GetHashCodeRect의 해시 코드를 만듭니다. (ValueType.GetHashCode()을(를) 재정의함)
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드Intersect현재 Rect가 나타내는 사각형과 지정된 Rect가 나타내는 사각형이 겹치는 부분을 찾아서 그 결과를 현재 Rect로 저장합니다.
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드ToString()Rect 구조체의 문자열 표현을 반환합니다. (ValueType.ToString()을(를) 재정의함)
Public 메서드ToString(IFormatProvider)지정된 형식 공급자를 사용하여 사각형의 문자열 표현을 반환합니다.
Public 메서드Union(Point)지정된 점을 정확히 포함할 수 있는 크기로 현재 Rect를 확장합니다.
Public 메서드Union(Rect)지정된 사각형을 정확히 포함할 수 있는 크기로 현재 Rect를 확장합니다.
맨 위

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

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

Size는 비슷한 방법으로 높이와 너비를 지정하는 유사한 구조체입니다. 그러나 Rect는 원점을 지정하는 반면 Size는 원점을 지정하지 않습니다. 일반적으로 Rect는 그래픽 표시와 관련된 API에 사용되고 Size는 UI 표시 및 레이아웃과 관련된 API에 사용됩니다.

RectRectangle을 혼동하지 마세요. Rect는 특정 속성에 대해 사각형 영역을 단일 값으로 지정하는 일반적인 데이터 구조입니다. 그러나 Rect는 그 자체로는 아무런 의미가 없으며 직접적인 UI 의미도 포함하지 않습니다. 즉, Rect의 의미는 전적으로 특정 속성에 대해 값으로 처리되는 방식에 따라 결정됩니다. 반면 RectangleShape이므로 UIElement입니다. Rectangle은 XAML 요소로 지정할 수 있으며, UI에 표시되는 사각형을 인스턴스화하고 입력 이벤트를 처리할 수 있습니다.

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

Rect의 속성 값 형식은 Double이지만 일반적으로 정수 값을 사용해야 합니다.

Rect의 속성은 Windows Phone용 XAM에서 특성 구문을 지원하지 않습니다. XAML에서는 항상 다음 사용 중 하나를 통해 Rect 형식 속성을 지정해야 합니다.

  • Rect 형식을 사용하는 속성을 유추하고 형식 변환기를 사용하여 특성 문자열을 Rect의 특정 값으로 처리하는 XAML 특성 사용입니다.

  • Rect 개체 요소를 포함한 속성 요소 사용입니다. 개체 요소의 경우 XAML 개체 요소 사용의 설명과 같이 초기화 텍스트를 사용하여 Rect 속성을 설정합니다.

리소스로 사용하기 위해 Rect를 지정할 경우 개체 요소 사용을 사용하고 초기화 텍스트를 사용하여 Rect 속성을 설정합니다.

참고참고:

widthheight가 특성 문자열의 일부로 XAML에 지정된 경우 음수일 수 있으며, 음수인 경우 너비 또는 높이가 적용되는 방향이 반전됩니다. 예를 들어 height가 -20이면 X,Y 점이 왼쪽 아래 모퉁이에 있는 Rect가 생성됩니다. 그러나 관리되는 API의 Rect 생성자는 widthheight에 음수 값을 허용하지 않습니다. 음수가 아닌 widthheight 값을 사용하여 Rect를 지정할 수 있도록 x,y, widthheight의 좌표 참조를 조정해야 합니다.

아래에 나오는 Rect 값에 대한 설명은 코드에서 생성된 Rect는 물론 XAML에서 만들어진 Rect에 대해서도 적용됩니다.

  • XY는 음수일 수 있으며, 음수인 경우 추가 변환을 수행하지 않으면 Rect 정의가 화면을 벗어납니다.

  • XY는 0일 수 있습니다. width 또는 height 값도 0일 수 있습니다. width 또는 height 값이 0인 RectRectangleGeometry에 적용하면 결과로 생성되는 RectangleGeometry는 렌더링되지 않습니다.

  • X, Y, widthheight에 정수가 아닌 값이 허용되기는 합니다.

Windows Phone OS

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

Windows Phone

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

표시: