패키지flash.geom
클래스public class Rectangle
상속Rectangle Inheritance Object

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

Rectangle 객체는 왼쪽 위 꼭지점(x, y)이 가리키는 위치와 너비 및 높이로 정의되는 영역입니다.

Rectangle 클래스의 x, y, widthheight 속성은 서로 무관하므로 한 속성 값을 변경해도 다른 속성에는 아무런 영향을 주지 않습니다. 그러나 rightbottom 속성은 이 네 개의 속성과 절대적인 관련이 있습니다. 예를 들어, right 속성 값을 변경하면 width 속성 값이 바뀌고 bottom 속성을 변경하면 height 속성 값이 바뀝니다.

다음 메서드와 속성은 Rectangle 객체를 사용합니다.

new Rectangle() 생성자를 사용하여 Rectangle 객체를 만들 수 있습니다.

참고: Rectangle 클래스는 사각형 Shape 표시 객체를 정의하지 않습니다. 화면에서 사각형 Shape 객체를 그리려면 Graphics 클래스의 drawRect() 메서드를 사용하십시오.

예제를 통해 확인하십시오.

참고 사항

flash.display.DisplayObject.scrollRect
flash.display.BitmapData
flash.display.DisplayObject
flash.text.TextField.getCharBoundaries()
flash.geom.Transform.pixelBounds
flash.display.Sprite.startDrag()
flash.printing.PrintJob.addPage()
Rectangle 객체 사용
크기, 배율 및 방향 설정


Public 속성
 속성다음에 의해 정의됨
  bottom : Number
y 및 height 속성의 합입니다.
Rectangle
  bottomRight : Point
right 및 bottom 속성 값으로 결정되는 Rectangle 객체의 오른쪽 아래 모서리 위치입니다.
Rectangle
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  height : Number
사각형의 높이(픽셀 단위)입니다.
Rectangle
  left : Number
사각형 왼쪽 위 모서리의 x 좌표입니다.
Rectangle
 Inheritedprototype : Object
[static] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
  right : Number
x 및 width 속성의 합입니다.
Rectangle
  size : Point
Rectangle 객체의 크기로, width 및 height 속성 값을 가진 Point 객체로 표현됩니다.
Rectangle
  top : Number
사각형 왼쪽 위 모서리의 y 좌표입니다.
Rectangle
  topLeft : Point
꼭지점의 x 및 y 좌표로 결정되는 Rectangle 객체의 왼쪽 위 모서리 위치입니다.
Rectangle
  width : Number
사각형의 너비(픽셀 단위)입니다.
Rectangle
  x : Number
사각형 왼쪽 위 모서리의 x 좌표입니다.
Rectangle
  y : Number
사각형 왼쪽 위 모서리의 y 좌표입니다.
Rectangle
Public 메서드
 메서드다음에 의해 정의됨
  
Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0)
x 및 y 매개 변수로 왼쪽 위 모서리를 지정하고 너비 및 높이 매개 변수를 지정하여 새 Rectangle 객체를 만듭니다.
Rectangle
  
x, y, width 및 height 속성 값이 원본 Rectangle 객체와 같은 새 Rectangle 객체를 반환합니다.
Rectangle
  
지정된 점이 이 Rectangle 객체에 의해 정의된 사각형 영역 내에 포함되는지 결정합니다.
Rectangle
  
지정된 점이 이 Rectangle 객체에 의해 정의된 사각형 영역 내에 포함되는지 결정합니다.
Rectangle
  
rect 매개 변수에 의해 지정된 Rectangle 객체가 이 Rectangle 객체 내에 포함되는지 결정합니다.
Rectangle
  
equals(toCompare:Rectangle):Boolean
toCompare 매개 변수에 지정된 객체가 이 Rectangle 객체와 같은지 결정합니다.
Rectangle
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
  
Rectangle 객체의 크기를 지정된 크기(픽셀 단위)만큼 늘립니다.
Rectangle
  
Rectangle 객체의 크기를 늘립니다.
Rectangle
  
toIntersect 매개 변수에 지정된 Rectangle 객체가 이 Rectangle 객체와 교차하는 경우, 교차 영역을 Rectangle 객체로 반환합니다.
Rectangle
  
toIntersect 매개 변수에 지정된 객체가 이 Rectangle 객체와 교차하는지 결정합니다.
Rectangle
  
이 Rectangle 객체가 비었는지 여부를 결정합니다.
Rectangle
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
  
왼쪽 위 꼭지점에 의해 정해진 Rectangle 객체의 위치를 지정된 양만큼 조정합니다.
Rectangle
  
Point 객체를 매개 변수로 사용하여 Rectangle 객체의 위치를 조정합니다.
Rectangle
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
  
Rectangle 객체의 모든 속성을 0으로 설정합니다.
Rectangle
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
  
Rectangle 객체의 가로 및 세로 위치와 너비 및 높이를 나열하는 문자열을 구성하고 반환합니다.
Rectangle
  
두 사각형을 추가하고 두 사각형 사이의 가로 및 세로 공간을 채워넣어 새 Rectangle 객체를 만듭니다.
Rectangle
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
속성 정보
bottom속성
bottom:Number  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

yheight 속성의 합입니다.


구현
    public function get bottom():Number
    public function set bottom(value:Number):void

참고 사항

bottomRight속성 
bottomRight:Point  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

rightbottom 속성 값으로 결정되는 Rectangle 객체의 오른쪽 아래 모서리 위치입니다.


구현
    public function get bottomRight():Point
    public function set bottomRight(value:Point):void

참고 사항

height속성 
public var height:Number

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

사각형의 높이(픽셀 단위)입니다. Rectangle 객체의 height 값을 변경해도 x, ywidth 속성에는 아무런 영향을 주지 않습니다.

참고 사항

left속성 
left:Number  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

사각형 왼쪽 위 모서리의 x 좌표입니다. Rectangle 객체의 left 속성을 변경하면 yheight 속성에는 아무런 영향을 주지 않습니다. 하지만 width 속성에는 영향을 주는 반면, x 값은 변경해도 width 속성에 영향을 주지 않습니다.

left 속성 값은 x 속성 값과 같습니다.


구현
    public function get left():Number
    public function set left(value:Number):void

참고 사항

right속성 
right:Number  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

xwidth 속성의 합입니다.


구현
    public function get right():Number
    public function set right(value:Number):void

참고 사항

size속성 
size:Point  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

Rectangle 객체의 크기로, widthheight 속성 값을 가진 Point 객체로 표현됩니다.


구현
    public function get size():Point
    public function set size(value:Point):void

참고 사항

top속성 
top:Number  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

사각형 왼쪽 위 모서리의 y 좌표입니다. Rectangle 객체의 top 속성을 변경하면 xwidth 속성에는 아무런 영향을 주지 않습니다. 하지만 height 속성에는 영향을 주는 반면, y 값은 변경해도 height 속성에 영향을 주지 않습니다.

top 속성 값은 y 속성 값과 같습니다.


구현
    public function get top():Number
    public function set top(value:Number):void

참고 사항

topLeft속성 
topLeft:Point  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

꼭지점의 xy 좌표로 결정되는 Rectangle 객체의 왼쪽 위 모서리 위치입니다.


구현
    public function get topLeft():Point
    public function set topLeft(value:Point):void

참고 사항

width속성 
public var width:Number

Player 버전 : Flash Player 9

사각형의 너비(픽셀 단위)입니다. Rectangle 객체의 width 값을 변경해도 x, yheight 속성에는 아무런 영향을 주지 않습니다.

참고 사항

x속성 
public var x:Number

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

사각형 왼쪽 위 모서리의 x 좌표입니다. Rectangle 객체의 x 속성 값을 변경해도 y, widthheight 속성에는 아무런 영향을 주지 않습니다.

x 속성 값은 left 속성 값과 같습니다.

참고 사항

y속성 
public var y:Number

Player 버전 : Flash Player 9

사각형 왼쪽 위 모서리의 y 좌표입니다. Rectangle 객체의 y 속성 값을 변경해도 x, widthheight 속성에는 아무런 영향을 주지 않습니다.

y 속성 값은 top 속성 값과 같습니다.

참고 사항

생성자 정보
Rectangle()생성자
public function Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0)

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

xy 매개 변수로 왼쪽 위 모서리를 지정하고 widthheight 매개 변수를 지정하여 새 Rectangle 객체를 만듭니다. 이 함수를 매개 변수 없이 호출하면 x, y, widthheight 속성이 0으로 설정된 사각형이 만들어집니다.

매개 변수
x:Number (default = 0) — 사각형 왼쪽 위 모서리의 x 좌표입니다.
 
y:Number (default = 0) — 사각형 왼쪽 위 모서리의 y 좌표입니다.
 
width:Number (default = 0) — 사각형의 너비(픽셀 단위)입니다.
 
height:Number (default = 0) — 사각형의 높이(픽셀 단위)입니다.

참고 사항

메서드 정보
clone()메서드
public function clone():Rectangle

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

x, y, widthheight 속성 값이 원본 Rectangle 객체와 같은 새 Rectangle 객체를 반환합니다.

반환값
Rectanglex, y, widthheight 속성 값이 원본 Rectangle 객체와 같은 새 Rectangle 객체입니다.

참고 사항

contains()메서드 
public function contains(x:Number, y:Number):Boolean

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

지정된 점이 이 Rectangle 객체에 의해 정의된 사각형 영역 내에 포함되는지 결정합니다.

매개 변수

x:Number — 점의 x 좌표(가로 위치)입니다.
 
y:Number — 점의 y 좌표(세로 위치)입니다.

반환값
Boolean — 지정된 점이 Rectangle 객체에 포함되어 있으면 값이 true이고, 그렇지 않으면 false입니다.

참고 사항

containsPoint()메서드 
public function containsPoint(point:Point):Boolean

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

지정된 점이 이 Rectangle 객체에 의해 정의된 사각형 영역 내에 포함되는지 결정합니다. 이 메서드는 Point 객체를 매개 변수로 사용하는 점을 제외하면 Rectangle.contains() 메서드와 유사합니다.

매개 변수

point:Pointxy 좌표로 나타내는 점입니다.

반환값
Boolean — 지정된 점이 Rectangle 객체에 포함되어 있으면 값이 true이고, 그렇지 않으면 false입니다.

참고 사항

containsRect()메서드 
public function containsRect(rect:Rectangle):Boolean

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

rect 매개 변수에 의해 지정된 Rectangle 객체가 이 Rectangle 객체 내에 포함되는지 결정합니다. 두 번째 Rectangle 객체가 첫 번째 Rectangle 객체의 경계 내에 완전히 포함되면 Rectangle 객체가 다른 Rectangle 객체를 포함한다고 합니다.

매개 변수

rect:Rectangle — 검사할 Rectangle 객체입니다.

반환값
Boolean — 지정한 Rectangle 객체가 이 Rectangle 객체 내에 포함되면 값이 true이고, 그렇지 않으면 false입니다.
equals()메서드 
public function equals(toCompare:Rectangle):Boolean

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

toCompare 매개 변수에 지정된 객체가 이 Rectangle 객체와 같은지 결정합니다. 이 메서드는 객체의 x, y, widthheight 속성을 이 Rectangle 객체의 같은 속성과 비교합니다.

매개 변수

toCompare:Rectangle — 이 Rectangle 객체와 비교할 사각형입니다.

반환값
Boolean — 객체의 x, y, widthheight 속성 값이 이 Rectangle 객체의 해당 속성 값과 완전히 같으면 값이 true이고, 그렇지 않으면 false입니다.

참고 사항

inflate()메서드 
public function inflate(dx:Number, dy:Number):void

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

Rectangle 객체의 크기를 지정된 크기(픽셀 단위)만큼 늘립니다. Rectangle 객체의 중심점은 변경되지 않으며 크기는 왼쪽과 오른쪽으로 dx 값만큼 증가하고 위쪽과 아래쪽으로 dy 값만큼 증가합니다.

매개 변수

dx:Number — Rectangle 객체의 왼쪽과 오른쪽에 추가할 값입니다. 다음 수식을 사용하여 사각형의 새 너비와 위치를 계산합니다.
 x -= dx;
 width += 2 * dx;
 
 
dy:Number — Rectangle 객체의 위쪽과 아래쪽에 추가할 값입니다. 다음 수식을 사용하여 사각형의 새 높이와 위치를 계산합니다.
 y -= dy;
 height += 2 * dy;
 

참고 사항

inflatePoint()메서드 
public function inflatePoint(point:Point):void

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

Rectangle 객체의 크기를 늘립니다. 이 메서드는 Point 객체를 매개 변수로 사용하는 점을 제외하면 Rectangle.inflate() 메서드와 유사합니다.

다음 두 코드 예제는 같은 결과를 보여 줍니다.

  rect1=new flash.geom.Rectangle(0,0,2,5);
  rect1.inflate(2,2)
  
  rect1=new flash.geom.Rectangle(0,0,2,5);
  pt1=new flash.geom.Point(2,2);
  rect1.inflatePoint(pt1)
  

매개 변수

point:Point — 이 Point 객체의 x 속성을 사용하여 Rectangle 객체의 가로 크기를 늘립니다. y 속성은 Rectangle 객체의 수직 크기를 늘리는 데 사용합니다.

참고 사항

intersection()메서드 
public function intersection(toIntersect:Rectangle):Rectangle

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

toIntersect 매개 변수에 지정된 Rectangle 객체가 이 Rectangle 객체와 교차하는 경우, 교차 영역을 Rectangle 객체로 반환합니다. 사각형이 서로 교차하지 않는 경우 이 메서드는 속성이 0인 빈 Rectangle 객체를 반환합니다.

매개 변수

toIntersect:Rectangle — 이 Rectangle 객체와 교차하는지 알아보기 위해 비교할 대상이 되는 Rectangle 객체입니다.

반환값
Rectangle — 교차 영역과 같은 Rectangle 객체입니다. 사각형이 서로 교차하지 않는 경우 이 메서드는 x, y, widthheight 속성이 0으로 설정된 사각형인 빈 Rectangle 객체를 반환합니다.

참고 사항

intersects()메서드 
public function intersects(toIntersect:Rectangle):Boolean

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

toIntersect 매개 변수에 지정된 객체가 이 Rectangle 객체와 교차하는지 결정합니다. 이 메서드는 지정된 Rectangle 객체의 x, y, widthheight 속성을 검사하여 이 Rectangle 객체와 교차하는지 확인합니다.

매개 변수

toIntersect:Rectangle — 이 Rectangle 객체와 비교할 Rectangle 객체입니다.

반환값
Boolean — 지정된 객체가 이 Rectangle 객체와 교차하면 값이 true이고, 그렇지 않으면 false입니다.

참고 사항

isEmpty()메서드 
public function isEmpty():Boolean

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

이 Rectangle 객체가 비었는지 여부를 결정합니다.

반환값
Boolean — Rectangle 객체의 너비 또는 높이가 0보다 작거나 같으면 값이 true이고, 그렇지 않으면 false입니다.
offset()메서드 
public function offset(dx:Number, dy:Number):void

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

왼쪽 위 꼭지점에 의해 정해진 Rectangle 객체의 위치를 지정된 양만큼 조정합니다.

매개 변수

dx:Number — Rectangle 객체의 x 값을 이 크기만큼 이동합니다.
 
dy:Number — Rectangle 객체의 y 값을 이 크기만큼 이동합니다.

참고 사항

offsetPoint()메서드 
public function offsetPoint(point:Point):void

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

Point 객체를 매개 변수로 사용하여 Rectangle 객체의 위치를 조정합니다. 이 메서드는 Point 객체를 매개 변수로 사용하는 점을 제외하면 Rectangle.offset() 메서드와 유사합니다.

매개 변수

point:Point — 이 Rectangle 객체를 오프셋할 때 사용하는 Point 객체입니다.

참고 사항

setEmpty()메서드 
public function setEmpty():void

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

Rectangle 객체의 모든 속성을 0으로 설정합니다. Rectangle 객체의 너비나 높이가 0보다 작거나 같으면 Rectangle 객체가 빈 것입니다.

이 메서드는 x, y, widthheight 속성 값을 0으로 설정합니다.

참고 사항

toString()메서드 
public function toString():String

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

Rectangle 객체의 가로 및 세로 위치와 너비 및 높이를 나열하는 문자열을 구성하고 반환합니다.

반환값
String — Rectangle 객체의 x, y, widthheight 속성 값을 각각 나열하는 문자열입니다.

참고 사항

union()메서드 
public function union(toUnion:Rectangle):Rectangle

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

두 사각형을 추가하고 두 사각형 사이의 가로 및 세로 공간을 채워넣어 새 Rectangle 객체를 만듭니다.

매개 변수

toUnion:Rectangle — 이 Rectangle 객체에 추가할 Rectangle 객체입니다.

반환값
Rectangle — 두 사각형을 결합한 새 Rectangle 객체입니다.

참고 사항

예제 예제 사용 방법
RectangleExample.as

다음 예제에서는 RectangleExample 클래스를 사용하여 세 개의 새 Rectangle 객체를 다양한 x, y 좌표에 다양한 높이와 너비로 만들고, trace() 메서드를 사용하여 Rectangle 인스턴스가 성공적으로 만들어졌는지 확인합니다. 그런 다음 두 번째 사각형이 세 번째 사각형을 완전히 포함하는지 여부를 결정하는 부울 변수 isContainedcontainsRect() 메서드 호출 결과에 할당됩니다.
package {
    import flash.display.Sprite;
    import flash.geom.Rectangle;

    public class RectangleExample extends Sprite {

        public function RectangleExample() {
            var firstRect:Rectangle = new Rectangle();
            trace(firstRect);  // (x=0, y=0, w=0, h=0)
            var secondRect:Rectangle = new Rectangle(1, 3, 11, 13);
            trace(secondRect); // (x=1, y=3, w=11, h=13)
            var thirdRect:Rectangle = new Rectangle(5, 8, 17, 19);
            trace(thirdRect);  // (x=5, y=8, w=17, h=19)
            var isContained:Boolean = secondRect.containsRect(thirdRect);
            trace(isContained); // false
        }
    }
}




 

이 페이지에 의견 추가되면 전자 메일 알림 받기 | 의견 보고서

현재 페이지: http://livedocs.adobe.com/flash/9.0_kr/ActionScriptLangRefV3/flash/geom/Rectangle.html