java.awt
클래스 Rectangle

java.lang.Object 
  java.awt.geom.RectangularShape 
      java.awt.geom.Rectangle2D 
          java.awt.Rectangle

모든 구현된 인터페이스:

Shape , Serializable , Cloneable

직계의 기존의 서브 클래스:

DefaultCaret

public class Rectangle
extends Rectangle2D 
implements Shape , Serializable 

Rectangle 는,Rectangle 객체의 좌표 공간에서의 좌상의 점 (x, y), 및 그 폭과 높이에 의해 둘러싸이는 좌표 공간내의 영역을 지정합니다.

Rectangle 객체의 width 및 height 는 public 필드입니다. Rectangle 를 작성하는 생성자 , 및 Rectangle 를 변경할 수 있는 메소드에는, width 나 height 의 값으로 해서 0 보다 작은 값을 설정할 수 있습니다.

폭 또는 높이가 정확하게 0 인 Rectangle 는, 이러한 축으로 따른 위치에서 치수 0 입니다만, 그 이외의 경우는 빈 상태(empty)이다고 보여집니다. isEmpty() 메소드는, 그러한 Rectangle 에 대해서 true 를 돌려줍니다. 빈 상태(empty)의 Rectangle 가 점 또는 구형을 포함하는지 교차하는지를 판정하는 메소드는, 몇개의 치수가 0 이면 항상 false 를 돌려줍니다. 그러한 Rectangle 를 점 또는 구형과 결합하는 메소드의 결과에는,add(Point) 메소드가 불려 갔을 경우와 같이, 그 축상의 Rectangle 의 위치가 포함됩니다.

폭 또는 높이가 부인 Rectangle 는, 치수가 부로 이러한 축으로 따른 위치도 치수도 없습니다. 이러한 Rectangle 는, 이러한 축으로 따라 존재하지 않는 것으로서 다루어집니다. 또, 이러한 Rectangle 는, 포함의 계산에서는 빈 상태(empty)이다고 보여 점 또는 구형을 포함하는지 교차하는지를 판정하는 메소드는 항상 false 를 돌려줍니다. 이러한 Rectangle 를 점 또는 구형과 결합하는 메소드에서는, 결과의 생성시에 Rectangle 전체가 무시됩니다. 2 개의 Rectangle 객체를 결합하는 경우에, 어느 쪽의 치수도 부이라고, 결과에는 부의 치수가 적어도 1 개(살) 포함됩니다.

Rectangle 의 위치에만 영향을 주는 메소드는, 그 치수가 어느 쪽인가의 축으로 따라 부 또는 0 일지 어떨지에 관계없이,Rectangle 의 위치에서 기능합니다.

디폴트의 인수를 취하지 않는 생성자 으로 구축된 Rectangle 는, 치수가 0x0 이며, 그 때문에 비웁니다. 이 Rectangle 의 위치는 (0,0) 이 되어, 이 정도치는 결합 조작 및 추가 조작으로 사용됩니다. 그 때문에, 점세트의 경계를 누적하려고 하는 코드에서는, 최초로 부의 폭과 높이를 사용해 Rectangle 를 구축하는지, 세트의 최초의 점을 사용해 Rectangle 를 구축할 필요가 있습니다. 다음에 예를 나타냅니다.

     Rectangle bounds = new Rectangle(0, 0, -1, -1);
     for (int i = 0; i < points.length; i++) {
         bounds.add(points[i]);
     }
 

점의 배열에 적어도 1 개의 점을 포함되는 것을 알고 있는 경우는, 다음과 같이 됩니다.

     Rectangle bounds = new Rectangle(points[0]);
     for (int i = 1; i < points.length; i++) {
         bounds.add(points[i]);
     }
 

이 클래스는 32 비트 정수를 사용해, 위치 및 치수를 포함합니다. 조작에 따라서는, 결과가 32 비트 정수의 범위를 넘는 일도 있습니다. 메소드는 결과를 계산할 때에, 중간 결과로 32 비트 오버플로우가 발생하지 않는 것 같은 방법을 사용해, 위치 및 치수를 보관 유지하는 32 비트 필드에 최종 결과를 포함하기 위한 최적 표현을 선택합니다. 결과의 위치는, 실제의 결과를 바로 옆의 32 비트치에 클리핑 해,x 및 y 필드에 포함됩니다. width 및 height 치수 필드에 포함되는 값에는, 실제의 결과를 최대한으로 포함하는 것 같은 32 비트치가 선택됩니다. 일반적으로, 치수는 32 비트 정수의 범위 (와)는 관계없는 것으로 클리핑 됩니다. 다만, 위치를 32 비트 필드의 페어에 포함할 수 있도록(듯이) 위치를 이동했을 경우는, 위치의 「최적 표현」에 맞추어 치수가 조정됩니다. 실제의 결과에 부의 치수가 포함되기 위해서(때문에) 한편 또는 양쪽 모두의 축으로 따라 존재하지 않는 것으로 되어 있는 경우, 포함되는 치수는 그러한 축으로 0 보다 작은 값이 됩니다. 실제의 결과의 위치가, 32 비트 정수의 범위내에서 표현 가능하지만, 한편 또는 양쪽 모두의 축으로 치수가 0 인 경우, 포함되는 치수는 그러한 축으로 0 이 됩니다.

도입된 버젼:

1.0

관련 항목:

직렬화 된 형식

상자의 클래스의 개요

클래스 java.awt.geom. Rectangle2D 로부터 상속된 상자의 클래스/인터페이스

Rectangle2D.Double , Rectangle2D.Float

필드의 개요

int	height Rectangle 의 높이입니다.
int	width Rectangle 의 폭입니다.
int	x Rectangle 의 좌상구석의 X 좌표입니다.
int	y Rectangle 의 좌상구석의 Y 좌표입니다.

클래스 java.awt.geom. Rectangle2D 로부터 상속된 필드

OUT_BOTTOM , OUT_LEFT , OUT_RIGHT , OUT_TOP

생성자 의 개요

Rectangle ()
좌상구석이 좌표 공간의 (0, 0)에 있어, 폭과 높이가 양쪽 모두 0 의 새로운 Rectangle 를 구축합니다.

Rectangle (Dimension d)
좌상구석이 (0, 0)로, 폭과 높이가 Dimension 인수로 지정되는 새로운 Rectangle 를 구축합니다.

Rectangle (int width, int height)
좌상구석이 좌표 공간의 (0, 0)에 있어, 폭과 높이가 width 인수 및 height 인수로 지정되는 새로운 Rectangle 를 구축합니다.

Rectangle (int x, int y, int width, int height)
좌상구석이 (x, y) 로서 지정되어 폭과 높이가 width 인수 및 height 인수로 지정되는 새로운 Rectangle 를 구축합니다.

Rectangle (Point p)
좌상구석이 지정된 Point 로, 폭과 높이가 양쪽 모두 0 인 새로운 Rectangle 를 구축합니다.

Rectangle (Point p, Dimension d)
좌상구석이 Point 인수로 지정되어 폭과 높이가 Dimension 인수로 지정되는 새로운 Rectangle 를 구축합니다.

Rectangle (Rectangle r)
지정된 Rectangle 의 값에 일치하도록(듯이) 초기화된 새로운 Rectangle 를 구축합니다.

메소드의 개요

void	add (int newx, int newy) 정수형의 인수 newx, newy 에 의해 지정되는 점을 이 Rectangle 의 경계에 추가합니다.
void	add (Point pt) 지정된 Point 를 이 Rectangle 의 경계에 추가합니다.
void	add (Rectangle r) Rectangle 를 이 Rectangle 에 추가합니다.
boolean	contains (int x, int y) 이 Rectangle 가, 지정된 위치 (x, y) 에 있는 점을 포함할지 어떨지를 판정합니다.
boolean	contains (int X, int Y, int W, int H) 지정된 위치 (X, Y) 에 있어, 지정된 사이즈 (W, H) 인 Rectangle 를, 이 Rectangle 가 완전하게 포함할지 어떨지를 판정합니다.
boolean	contains (Point p) 이 Rectangle 가 지정된 Point 를 포함할지 어떨지를 판정합니다.
boolean	contains (Rectangle r) 이 Rectangle 가, 지정된 Rectangle 를 완전하게 포함할지 어떨지를 판정합니다.
Rectangle2D	createIntersection (Rectangle2D r) 이 Rectangle2D 와 지정된 Rectangle2D 의 공통 부분을 나타내는 새로운 Rectangle2D 객체를 돌려줍니다.
Rectangle2D	createUnion (Rectangle2D r) 이 Rectangle2D 와 지정된 Rectangle2D 의 화집합을 나타내는 새로운 Rectangle2D 객체를 돌려줍니다.
boolean	equals (Object obj) 2 개의 구형이 같은가 어떤가를 판정합니다.
Rectangle	getBounds () 이 Rectangle 의 경계의 Rectangle 영역을 가져옵니다.
Rectangle2D	getBounds2D () 고정밀도로 getBounds 메소드보다 정밀한,Shape 의 바운딩 박스를 돌려줍니다.
double	getHeight () 경계의 Rectangle 영역의 높이를 double 정밀도로 돌려줍니다.
Point	getLocation () 이 Rectangle 의 위치를 돌려줍니다.
Dimension	getSize () 반환된 Dimension 로 나타내진, 이 Rectangle 의 사이즈를 돌려줍니다.
double	getWidth () 경계의 Rectangle 영역의 폭을 double 정밀도로 돌려줍니다.
double	getX () 경계의 Rectangle 영역의 X 좌표를 double 정밀도로 돌려줍니다.
double	getY () 경계의 Rectangle 영역의 Y 좌표를 double 정밀도로 돌려줍니다.
void	grow (int h, int v) Rectangle 를 수평 방향과 수직 방향의 양쪽 모두로 사이즈 변경합니다.
boolean	inside (int X, int Y) 추천 되고 있지 않습니다. JDK version 1.1 이후는, contains(int, int) 로 옮겨졌습니다.
Rectangle	intersection (Rectangle r) 이 Rectangle 와 지정된 Rectangle 와의 공통 부분을 산출합니다.
boolean	intersects (Rectangle r) 이 Rectangle 와 지정된 Rectangle 가 교차할지 어떨지를 판정합니다.
boolean	isEmpty () RectangularShape 가 빈 상태(empty)인가 어떤가를 판정합니다.
void	move (int x, int y) 추천 되고 있지 않습니다. JDK version 1.1 이후는, setLocation(int, int) 로 옮겨졌습니다.
int	outcode (double x, double y) 이 Rectangle2D 를 기준에, 지정된 좌표가 있는 장소를 판정합니다.
void	reshape (int x, int y, int width, int height) 추천 되고 있지 않습니다. JDK version 1.1 이후는, setBounds(int, int, int, int) 로 옮겨졌습니다.
void	resize (int width, int height) 추천 되고 있지 않습니다. JDK version 1.1 이후는, setSize(int, int) 로 옮겨졌습니다.
void	setBounds (int x, int y, int width, int height) 이 Rectangle 의 경계의 Rectangle 영역을,x,y,width, 및 height 로 지정된 값으로 설정합니다.
void	setBounds (Rectangle r) 이 Rectangle 의 경계의 Rectangle 영역을, 지정된 Rectangle 에 일치하도록(듯이) 설정합니다.
void	setLocation (int x, int y) 이 Rectangle 가 지정된 위치로 이동합니다.
void	setLocation (Point p) 이 Rectangle 가 지정된 위치로 이동합니다.
void	setRect (double x, double y, double width, double height) 이 Rectangle 의 경계를, 지정된 x,y,width, 및 height 를 둘러싸는 정수 경계로 설정합니다.
void	setSize (Dimension d) 이 Rectangle 의 사이즈를, 지정된 Dimension 에 일치하도록(듯이) 설정합니다.
void	setSize (int width, int height) 이 Rectangle 의 크기가 지정된 폭과 높이로 설정합니다.
String	toString () 이 Rectangle 및 그 값을 나타내는 String 표현을 돌려줍니다.
void	translate (int dx, int dy) X 좌표축에 따라 우측향, Y 좌표축에 따라 아래방향에, 지정된 거리만 이 Rectangle 를 평행이동 합니다.
Rectangle	union (Rectangle r) 이 Rectangle 와 지정된 Rectangle 와의 결합 부분을 산출합니다.

클래스 java.awt.geom. Rectangle2D 로부터 상속된 메소드

add , add , add , contains , contains , getPathIterator , getPathIterator , hashCode , intersect , intersects , intersectsLine , intersectsLine , outcode , setFrame , setRect , union

클래스 java.awt.geom. RectangularShape 로부터 상속된 메소드

clone , contains , contains , getCenterX , getCenterY , getFrame , getMaxX , getMaxY , getMinX , getMinY , intersects , setFrame , setFrame , setFrameFromCenter , setFrameFromCenter , setFrameFromDiagonal , setFrameFromDiagonal

클래스 java.lang. Object 로부터 상속된 메소드

finalize , getClass , notify , notifyAll , wait , wait , wait

인터페이스 java.awt. Shape 로부터 상속된 메소드

contains , contains , contains , contains , getPathIterator , getPathIterator , intersects , intersects

필드의 상세

x

public int x

Rectangle 의 좌상구석의 X 좌표입니다.

도입된 버젼:

1.0

관련 항목:

setLocation(int, int) , getLocation()

y

public int y

Rectangle 의 좌상구석의 Y 좌표입니다.

도입된 버젼:

1.0

관련 항목:

setLocation(int, int) , getLocation()

width

public int width

Rectangle 의 폭입니다.

도입된 버젼:

1.0

관련 항목:

setSize(int, int) , getSize()

height

public int height

Rectangle 의 높이입니다.

도입된 버젼:

1.0

관련 항목:

setSize(int, int) , getSize()

생성자 의 상세

Rectangle

public Rectangle()

좌상구석이 좌표 공간의 (0, 0)에 있어, 폭과 높이가 양쪽 모두 0 의 새로운 Rectangle 를 구축합니다.

Rectangle

public Rectangle(Rectangle  r)

지정된 Rectangle 의 값에 일치하도록(듯이) 초기화된 새로운 Rectangle 를 구축합니다.

파라미터:

r - 새롭게 구축되는 Rectangle 의 초기치의 카피원이 되는 Rectangle

도입된 버젼:

1.1

Rectangle

public Rectangle(int x,
                 int y,
                 int width,
                 int height)

좌상구석이 (x, y) 로서 지정되어 폭과 높이가 width 인수 및 height 인수로 지정되는 새로운 Rectangle 를 구축합니다.

파라미터:

x - 지정된 X 좌표

y - 지정된 Y 좌표

width - Rectangle 의 폭

height - Rectangle 의 높이

도입된 버젼:

1.0

Rectangle

public Rectangle(int width,
                 int height)

좌상구석이 좌표 공간의 (0, 0)에 있어, 폭과 높이가 width 인수 및 height 인수로 지정되는 새로운 Rectangle 를 구축합니다.

파라미터:

width - Rectangle 의 폭

height - Rectangle 의 높이

Rectangle

public Rectangle(Point  p,
                 Dimension  d)

좌상구석이 Point 인수로 지정되어 폭과 높이가 Dimension 인수로 지정되는 새로운 Rectangle 를 구축합니다.

파라미터:

p - 이 Rectangle 의 좌상구석의 Point

d - Rectangle 의 폭과 높이를 나타낸다 Dimension

Rectangle

public Rectangle(Point  p)

좌상구석이 지정된 Point 로, 폭과 높이가 양쪽 모두 0 인 새로운 Rectangle 를 구축합니다.

파라미터:

p - 이 Rectangle 의 좌상구석의 Point

Rectangle

public Rectangle(Dimension  d)

좌상구석이 (0, 0)로, 폭과 높이가 Dimension 인수로 지정되는 새로운 Rectangle 를 구축합니다.

파라미터:

d - 폭과 높이를 지정하는 Dimension

메소드의 상세

getX

public double getX()

경계의 Rectangle 영역의 X 좌표를 double 정밀도로 돌려줍니다.

정의:

클래스 RectangularShape 내의 getX

반환값:

경계의 Rectangle 영역의 X 좌표

getY

public double getY()

경계의 Rectangle 영역의 Y 좌표를 double 정밀도로 돌려줍니다.

정의:

클래스 RectangularShape 내의 getY

반환값:

경계의 Rectangle 영역의 Y 좌표

getWidth

public double getWidth()

경계의 Rectangle 영역의 폭을 double 정밀도로 돌려줍니다.

정의:

클래스 RectangularShape 내의 getWidth

반환값:

경계의 Rectangle 영역의 폭

getHeight

public double getHeight()

경계의 Rectangle 영역의 높이를 double 정밀도로 돌려줍니다.

정의:

클래스 RectangularShape 내의 getHeight

반환값:

경계의 Rectangle 영역의 높이

getBounds

public Rectangle  getBounds()

이 Rectangle 의 경계의 Rectangle 영역을 가져옵니다.

이 메소드는 완전성을 위해서(때문에) 준비되어 있어서 ,Component 의 getBounds 메소드에 대응합니다.

정의:

인터페이스 Shape 내의 getBounds

오버라이드(override):

클래스 RectangularShape 내의 getBounds

반환값:

새로운 Rectangle. 이 Rectangle 의 경계의 Rectangle 영역에 동일한

도입된 버젼:

1.1

관련 항목:

Component.getBounds() , setBounds(Rectangle) , setBounds(int, int, int, int)

getBounds2D

public Rectangle2D  getBounds2D()

고정밀도로 getBounds 메소드보다 정밀한,Shape 의 바운딩 박스를 돌려줍니다. 반환된 Rectangle2D 가 Shape 를 둘러싸는 최소의 바운딩 박스이다고는 할 수 없습니다. 나타난 Rectangle2D 내에 Shape 가 완전하게 수습된다고 할 뿐입니다. 반환값을, 배정밀도치를 사용해 치수를 포함하는 Rectangle2D 의 인스턴스로 할 수도 있기 (위해)때문에, 이 메소드에 의해 반환되는 바운딩 박스는, 일반적으로,getBounds 메소드에 의해 반환되는 바운딩 박스보다 딱 한 것이 되어, 오버플로우를 위해서(때문에) 실패할 것은 없습니다.

정의:

인터페이스 Shape 내의 getBounds2D

오버라이드(override):

클래스 Rectangle2D 내의 getBounds2D

반환값:

Shape 의 고정밀도 바운딩 박스를 나타낸다 Rectangle2D 의 인스턴스

도입된 버젼:

1.2

관련 항목:

Shape.getBounds()

setBounds

public void setBounds(Rectangle  r)

이 Rectangle 의 경계의 Rectangle 영역을, 지정된 Rectangle 에 일치하도록(듯이) 설정합니다.

이 메소드는 완전성을 위해서(때문에) 준비되어 있어서 ,Component 의 setBounds 메소드에 대응합니다.

파라미터:

r - 지정된 Rectangle

도입된 버젼:

1.1

관련 항목:

getBounds() , Component.setBounds(java.awt.Rectangle)

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)

이 Rectangle 의 경계의 Rectangle 영역을,x,y,width, 및 height 로 지정된 값으로 설정합니다.

이 메소드는 완전성을 위해서(때문에) 준비되어 있어서 ,Component 의 setBounds 메소드에 대응합니다.

파라미터:

x - 이 Rectangle 의 좌상구석의 새로운 X 좌표

y - 이 Rectangle 의 좌상구석의 새로운 Y 좌표

width - 이 Rectangle 의 새로운 폭

height - 이 Rectangle 의 새로운 높이

도입된 버젼:

1.1

관련 항목:

getBounds() , Component.setBounds(int, int, int, int)

setRect

public void setRect(double x,
                    double y,
                    double width,
                    double height)

이 Rectangle 의 경계를, 지정된 x,y,width, 및 height 를 둘러싸는 정수 경계로 설정합니다. 이러한 파라미터에 의해 정수의 최대 범위를 넘는 Rectangle 가 지정되는 경우, 최대 정수 경계와 교차하는, 지정된 Rectangle 의 최적 표현을 얻을 수 있습니다.

정의:

클래스 Rectangle2D 내의 setRect

파라미터:

x - 지정된 구형의 좌상구석의 X 좌표

y - 지정된 구형의 좌상구석의 Y 좌표

width - 지정된 구형의 폭

height - 지정된 구형의 새로운 높이

reshape

@Deprecated 
public void reshape(int x,
                               int y,
                               int width,
                               int height)

추천 되고 있지 않습니다. JDK version 1.1 이후는, setBounds(int, int, int, int) 로 옮겨졌습니다.

이 Rectangle 의 경계의 Rectangle 영역을,x,y,width, 및 height 로 지정된 값으로 설정합니다.

파라미터:

x - 이 Rectangle 의 좌상구석의 새로운 X 좌표

y - 이 Rectangle 의 좌상구석의 새로운 Y 좌표

width - 이 Rectangle 의 새로운 폭

height - 이 Rectangle 의 새로운 높이

getLocation

public Point  getLocation()

이 Rectangle 의 위치를 돌려줍니다.

이 메소드는 완전성을 위해서(때문에) 준비되어 있어서 ,Component 의 getLocation 메소드에 대응합니다.

반환값:

이 Rectangle 의 좌상구석의 Point

도입된 버젼:

1.1

관련 항목:

Component.getLocation() , setLocation(Point) , setLocation(int, int)

setLocation

public void setLocation(Point  p)

이 Rectangle 가 지정된 위치로 이동합니다.

이 메소드는 완전성을 위해서(때문에) 준비되어 있어서 ,Component 의 setLocation 메소드에 대응합니다.

파라미터:

p - 이 Rectangle 의 새로운 위치를 지정한다 Point

도입된 버젼:

1.1

관련 항목:

Component.setLocation(java.awt.Point) , getLocation()

setLocation

public void setLocation(int x,
                        int y)

이 Rectangle 가 지정된 위치로 이동합니다.

이 메소드는 완전성을 위해서(때문에) 준비되어 있어서 ,Component 의 setLocation 메소드에 대응합니다.

파라미터:

x - 새로운 위치의 X 좌표

y - 새로운 위치의 Y 좌표

도입된 버젼:

1.1

관련 항목:

getLocation() , Component.setLocation(int, int)

move

@Deprecated 
public void move(int x,
                            int y)

추천 되고 있지 않습니다. JDK version 1.1 이후는, setLocation(int, int) 로 옮겨졌습니다.

이 Rectangle 가 지정된 위치로 이동합니다.

파라미터:

x - 새로운 위치의 X 좌표

y - 새로운 위치의 Y 좌표

translate

public void translate(int dx,
                      int dy)

X 좌표축에 따라 우측향, Y 좌표축에 따라 아래방향에, 지정된 거리만 이 Rectangle 를 평행이동 합니다.

파라미터:

dx - X 축으로 따라 이 Rectangle 가 이동한다 거리

dy - Y 축으로 따라 이 Rectangle 가 이동한다 거리

관련 항목:

setLocation(int, int) , setLocation(java.awt.Point)

getSize

public Dimension  getSize()

반환된 Dimension 로 나타내진, 이 Rectangle 의 사이즈를 돌려줍니다.

이 메소드는 완전성을 위해서(때문에) 준비되어 있어서 ,Component 의 getSize 메소드에 대응합니다.

반환값:

이 Rectangle 의 사이즈를 나타낸다 Dimension

도입된 버젼:

1.1

관련 항목:

Component.getSize() , setSize(Dimension) , setSize(int, int)

setSize

public void setSize(Dimension  d)

이 Rectangle 의 사이즈를, 지정된 Dimension 에 일치하도록(듯이) 설정합니다.

이 메소드는 완전성을 위해서(때문에) 준비되어 있어서 ,Component 의 setSize 메소드에 대응합니다.

파라미터:

d - Dimension 객체의 새로운 사이즈

도입된 버젼:

1.1

관련 항목:

Component.setSize(java.awt.Dimension) , getSize()

setSize

public void setSize(int width,
                    int height)

이 Rectangle 의 크기가 지정된 폭과 높이로 설정합니다.

이 메소드는 완전성을 위해서(때문에) 준비되어 있어서 ,Component 의 setSize 메소드에 대응합니다.

파라미터:

width - 이 Rectangle 의 새로운 폭

height - 이 Rectangle 의 새로운 높이

도입된 버젼:

1.1

관련 항목:

Component.setSize(int, int) , getSize()

resize

@Deprecated 
public void resize(int width,
                              int height)

추천 되고 있지 않습니다. JDK version 1.1 이후는, setSize(int, int) 로 옮겨졌습니다.

이 Rectangle 의 크기가 지정된 폭과 높이로 설정합니다.

파라미터:

width - 이 Rectangle 의 새로운 폭

height - 이 Rectangle 의 새로운 높이

contains

public boolean contains(Point  p)

이 Rectangle 가 지정된 Point 를 포함할지 어떨지를 판정합니다.

파라미터:

p - 판정하는 대상이 되는 Point

반환값:

지정된 Point 가 이 Rectangle 의 내부에 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.1

contains

public boolean contains(int x,
                        int y)

이 Rectangle 가, 지정된 위치 (x, y) 에 있는 점을 포함할지 어떨지를 판정합니다.

파라미터:

x - 지정된 X 좌표

y - 지정된 Y 좌표

반환값:

점 (x, y) 이 이 Rectangle 의 내부에 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.1

contains

public boolean contains(Rectangle  r)

이 Rectangle 가, 지정된 Rectangle 를 완전하게 포함할지 어떨지를 판정합니다.

파라미터:

r - 지정된 Rectangle

반환값:

Rectangle 가 이 Rectangle 에 완전하게 포함되는 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.2

contains

public boolean contains(int X,
                        int Y,
                        int W,
                        int H)

지정된 위치 (X, Y) 에 있어, 지정된 사이즈 (W, H) 인 Rectangle 를, 이 Rectangle 가 완전하게 포함할지 어떨지를 판정합니다.

파라미터:

X - 지정된 X 좌표

Y - 지정된 Y 좌표

W - Rectangle 의 폭

H - Rectangle 의 높이

반환값:

(X, Y, W, H) 으로 지정되는 Rectangle 가 완전하게 이 Rectangle 내에 들어가는 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.1

inside

@Deprecated 
public boolean inside(int X,
                                 int Y)

추천 되고 있지 않습니다. JDK version 1.1 이후는, contains(int, int) 로 옮겨졌습니다.

이 Rectangle 가, 지정된 위치 (X, Y) 에 있는 점을 포함할지 어떨지를 판정합니다.

파라미터:

X - 지정된 X 좌표

Y - 지정된 Y 좌표

반환값:

점 (X, Y) 이 이 Rectangle 의 내부에 있는 경우는 true, 그렇지 않은 경우는 false

intersects

public boolean intersects(Rectangle  r)

이 Rectangle 와 지정된 Rectangle 가 교차할지 어떨지를 판정합니다. 공통 부분이 빈 상태(empty)이 아닌 경우, 2 개의 구형은 교차합니다.

파라미터:

r - 지정된 Rectangle

반환값:

지정된 Rectangle 곳의 Rectangle 가 교차하는 경우는 true, 그렇지 않은 경우는 false

intersection

public Rectangle  intersection(Rectangle  r)

이 Rectangle 와 지정된 Rectangle 와의 공통 부분을 산출합니다. 2 개의 구형의 공통 부분을 나타내는 새로운 Rectangle 를 돌려줍니다. 2 개의 구형이 교차하지 않는 경우, 빈 상태(empty)의 구형이 돌려주어집니다.

파라미터:

r - 지정된 Rectangle

반환값:

지정된 Rectangle 와 이 Rectangle 의 양쪽 모두에 들어간다 최대의 Rectangle, 이러한 구형이 교차하지 않는 경우는 빈 상태(empty)의 구형

union

public Rectangle  union(Rectangle  r)

이 Rectangle 와 지정된 Rectangle 와의 결합 부분을 산출합니다. 2 개의 구형의 결합 부분을 나타내는 새로운 Rectangle 를 돌려줍니다.

몇개의 Rectangle 로 치수가 0 미만의 경우,존재하지 않는 구형의 규칙이 적용됩니다. 한편만이 0 미만의 경우는, 다른 Rectangle 의 카피가 돌려주어집니다. 양쪽 모두 0 미만의 경우는, 0 미만의 치수가 적어도 1 개(살) 포함됩니다.

얻을 수 있는 Rectangle 의 치수가 int 로 표현할 수 없을 정도 큰 경우는, 그 치수에 맞춘 Integer.MAX_VALUE 의 치수가 됩니다.

파라미터:

r - 지정된 Rectangle

반환값:

지정된 Rectangle 와 이 Rectangle 의 양쪽 모두가 들어간다 최소의 Rectangle

add

public void add(int newx,
                int newy)

정수형의 인수 newx, newy 에 의해 지정되는 점을 이 Rectangle 의 경계에 추가합니다.

이 Rectangle 로 치수가 0 미만의 경우,존재하지 않는 구형의 규칙이 적용됩니다. 이 결과, 이 Rectangle 의 새로운 경계의 위치는, 지정된 좌표와 같게 되어, 폭과 높이는 0 이 됩니다.

점을 추가한 뒤, 추가된 점을 인수로 하는 contains 의 호출은, 반드시 true 를 돌려주지 않습니다. contains 메소드는,Rectangle 의 우단 또는 하단에 위치하는 점의 경우는 true 를 돌려주지 않습니다. 그 때문에, 추가된 점이 확대 후의 Rectangle 의 우단 또는 하단에 위치하는 점인 경우에는,contains 는 false 를 돌려줍니다. 지정된 점이 새로운 Rectangle 내부에 포함될 필요가 있는 경우는, 대신에 다음과 같이 해 1 × 1 구형을 추가해 주세요.

     r.add(newx, newy, 1, 1);
 

파라미터:

newx - 새로운 점의 X 좌표

newy - 새로운 점의 Y 좌표

add

public void add(Point  pt)

지정된 Point 를 이 Rectangle 의 경계에 추가합니다.

이 Rectangle 로 치수가 0 미만의 경우,존재하지 않는 구형의 규칙이 적용됩니다. 이 결과, 이 Rectangle 의 새로운 경계의 위치는, 지정된 Point 의 좌표와 같게 되어, 폭과 높이는 0 이 됩니다.

Point 를 추가한 후에, 추가된 Point 를 인수로서 지정해 contains 를 호출했을 경우, 반드시 true 가 반환된다고는 할 수 없습니다. contains 메소드는,Rectangle 의 우단 또는 하단에 위치하는 점의 경우는 true 를 돌려주지 않습니다. 그 때문에, 추가된 Point 가 확대 후의 Rectangle 의 우단 또는 하단에 위치하는 점인 경우에는,contains 는 Point 에 대해서 false 를 돌려줍니다. 지정된 점이 새로운 Rectangle 내부에 포함될 필요가 있는 경우는, 대신에 다음과 같이 해 1 × 1 구형을 추가해 주세요.

     r.add(pt.x, pt.y, 1, 1);
 

파라미터:

pt - 이 Rectangle 에 추가되는 새롭다 Point

add

public void add(Rectangle  r)

Rectangle 를 이 Rectangle 에 추가합니다. 이 결과, 2 개의 구형의 결합 부분이 되는 Rectangle 가 작성됩니다.

몇개의 Rectangle 로 치수가 0 미만의 경우, 다른 Rectangle 의 치수가 돌려주어집니다. 양쪽 모두의 Rectangle 로 0 미만의 치수가 적어도 1 개(살) 포함되는 경우는, 결과에 0 미만의 치수가 적어도 1 개(살) 포함됩니다.

몇개의 Rectangle 로 한편 또는 양쪽 모두의 치수가 0 인 경우, 이러한 축으로 따른 치수 0 의 결과는, 대응하는 원점 좌표를 그 축으로 따른 결과의 구형에 추가하는 것으로 얻을 수 있는 결과와 동일해집니다. 이것은 add(Point) 메소드에 의한 조작을 닮아 있습니다만, 결과의 구형을 넘는 치수는 사용되지 않습니다.

얻을 수 있는 Rectangle 의 치수가 int 로 표현할 수 없을 정도 큰 경우는, 그 치수에 맞춘 Integer.MAX_VALUE 의 치수가 됩니다.

파라미터:

r - 지정된 Rectangle

grow

public void grow(int h,
                 int v)

Rectangle 를 수평 방향과 수직 방향의 양쪽 모두로 사이즈 변경합니다.

이 메소드는, 좌우에 각각 h 단위씩, 상하에 각각 v 단위씩 커지도록(듯이),Rectangle 를 변경합니다.

새로운 Rectangle 는, 좌상구석이 (x - h, y - v), 폭이 (width + 2h), 높이가 (height + 2v) 가 됩니다.

h 와 v 에 0 보다 작은 값이 지정되었을 경우,Rectangle 의 사이즈는 작아집니다. grow 메소드는, 정수형의 오버플로우 및 언더 플로우(underflow)를 확인합니다만,width 및 height 로 얻을 수 있는 값이 0 보다 작은 값으로부터 부가 아닌 값으로 증가하는지, 부가 아닌 값으로부터 0 보다 작은 값으로 감소할까에 대해서는 확인하지 않습니다.

파라미터:

h - 수평 방향으로 확대하는 양

v - 수직 방향으로 확대하는 양

isEmpty

public boolean isEmpty()

RectangularShape 가 빈 상태(empty)인가 어떤가를 판정합니다. 빈 상태(empty)의 경우는,RectangularShape 에 영역은 없습니다.

정의:

클래스 RectangularShape 내의 isEmpty

반환값:

RectangularShape 가 빈 상태(empty)인 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.2

outcode

public int outcode(double x,
                   double y)

이 Rectangle2D 를 기준에, 지정된 좌표가 있는 장소를 판정합니다. 이 메소드는, 이 Rectangle2D 의 각변에 대해, 지정된 좌표가 이 Rectangle2D 외의 옆과 같은 사이드에게 있을지 어떨지를 나타내는 적절한 마스크치의 2 항논리합을 계산합니다.

정의:

클래스 Rectangle2D 내의 outcode

파라미터:

x - 지정된 X 좌표

y - 지정된 Y 좌표

반환값:

모든 적절한 OUT 코드의 논리합

도입된 버젼:

1.2

관련 항목:

Rectangle2D.OUT_LEFT , Rectangle2D.OUT_TOP , Rectangle2D.OUT_RIGHT , Rectangle2D.OUT_BOTTOM

createIntersection

public Rectangle2D  createIntersection(Rectangle2D  r)

이 Rectangle2D 와 지정된 Rectangle2D 의 공통 부분을 나타내는 새로운 Rectangle2D 객체를 돌려줍니다.

정의:

클래스 Rectangle2D 내의 createIntersection

파라미터:

r - 이 Rectangle 와 서로 겹친다 Rectangle2D

반환값:

지정된 Rectangle2D 와 이 Rectangle2D 의 양쪽 모두에 포함된다 최대의 Rectangle2D

도입된 버젼:

1.2

createUnion

public Rectangle2D  createUnion(Rectangle2D  r)

이 Rectangle2D 와 지정된 Rectangle2D 의 화집합을 나타내는 새로운 Rectangle2D 객체를 돌려줍니다.

정의:

클래스 Rectangle2D 내의 createUnion

파라미터:

r - 이 Rectangle 와 결합된다 Rectangle2D

반환값:

지정된 Rectangle2D 와 이 Rectangle2D 의 양쪽 모두를 포함한다 최소의 Rectangle2D

도입된 버젼:

1.2

equals

public boolean equals(Object  obj)

2 개의 구형이 같은가 어떤가를 판정합니다.

인수가 null 가 아니고, 이 Rectangle 와 같은 좌상구석, 높이, 및 폭을 가지는 Rectangle 객체인 경우에만, 결과는 true 가 됩니다.

오버라이드(override):

클래스 Rectangle2D 내의 equals

파라미터:

obj - 이 Rectangle 와 비교한다 Object

반환값:

객체가 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode() , Hashtable

toString

public String  toString()

이 Rectangle 및 그 값을 나타내는 String 표현을 돌려줍니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 Rectangle 객체의 좌표 및 사이즈의 값을 나타내는 String