| 패키지 | flash.geom |
| 클래스 | public class Rectangle |
| 상속 | Rectangle  Object |
| 하위 클래스 | RoundedRectangle |
| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Rectangle 클래스의 x, y, width 및 height 속성은 서로 무관하므로 한 속성 값을 변경해도 다른 속성에는 아무런 영향을 주지 않습니다. 그러나 right 및 bottom 속성은 이 네 개의 속성과 절대적인 관련이 있습니다. 예를 들어 right 속성 값을 변경하면 width 속성 값이 바뀌고 bottom 속성을 변경하면 height 속성 값이 바뀝니다.
다음 메서드와 속성은 Rectangle 객체를 사용합니다.
-
applyFilter(),colorTransform(),copyChannel(),copyPixels(),draw(),fillRect(),generateFilterRect(),getColorBoundsRect(),getPixels(),merge(),paletteMap(),pixelDisolve(),setPixels()및threshold()메서드와 BitmapData 클래스의rect속성 -
getBounds()및getRect()메서드와 DisplayObject 클래스의scrollRect및scale9Grid속성 - TextField 클래스의
getCharBoundaries()메서드 - Transform 클래스의
pixelBounds속성 - Sprite 클래스의
startDrag()메서드에 대한bounds매개 변수 - PrintJob 클래스의
addPage()메서드에 대한printArea매개 변수
new Rectangle() 생성자를 사용하여 Rectangle 객체를 만들 수 있습니다.
참고: Rectangle 클래스는 사각형 Shape 표시 객체를 정의하지 않습니다. 화면에서 사각형 Shape 객체를 그리려면 Graphics 클래스의 drawRect() 메서드를 사용하십시오.
관련 API 요소
flash.display.BitmapData
flash.display.DisplayObject
flash.display.NativeWindow
flash.text.TextField.getCharBoundaries()
flash.geom.Transform.pixelBounds
flash.display.Sprite.startDrag()
flash.printing.PrintJob.addPage()
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
| bottom : Number
y 및 height 속성의 합입니다. | Rectangle | ||
| bottomRight : Point
right 및 bottom 속성 값으로 결정되는 Rectangle 객체의 오른쪽 아래 모서리 위치입니다. | Rectangle | ||
 | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| height : Number
사각형의 높이(픽셀 단위)입니다. | Rectangle | ||
| left : Number
사각형 왼쪽 위 모서리의 x 좌표입니다. | Rectangle | ||
| 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 | ||
| 메서드 | 정의 주체 | ||
|---|---|---|---|
x 및 y 매개 변수로 왼쪽 위 모서리를 지정하고 폭 및 높이 매개 변수를 지정하여 새 Rectangle 객체를 만듭니다. | Rectangle | ||
x, y, width 및 height 속성 값이 원본 Rectangle 객체와 같은 새 Rectangle 객체를 반환합니다. | Rectangle | ||
지정된 점이 이 Rectangle 객체에 의해 정의된 사각형 영역 내에 포함되는지 결정합니다. | Rectangle | ||
지정된 점이 이 Rectangle 객체에 의해 정의된 사각형 영역 내에 포함되는지 결정합니다. | Rectangle | ||
rect 매개 변수에 의해 지정된 Rectangle 객체가 이 Rectangle 객체 내에 포함되는지 결정합니다. | Rectangle | ||
소스 Rectangle 객체의 모든 사각형 데이터를 호출 Rectangle 객체에 복사합니다. | Rectangle | ||
toCompare 매개 변수에 지정된 객체가 이 Rectangle 객체와 같은지 결정합니다. | Rectangle | ||
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
Rectangle 객체의 크기를 지정된 크기(픽셀 단위)만큼 늘립니다. | Rectangle | ||
Rectangle 객체의 크기를 늘립니다. | Rectangle | ||
toIntersect 매개 변수에 지정된 Rectangle 객체가 이 Rectangle 객체와 교차하는 경우, 교차 영역을 Rectangle 객체로 반환합니다. | Rectangle | ||
toIntersect 매개 변수에 지정된 객체가 이 Rectangle 객체와 교차하는지 결정합니다. | Rectangle | ||
이 Rectangle 객체가 비었는지 여부를 결정합니다. | Rectangle | ||
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
왼쪽 위 꼭지점에 의해 정해진 Rectangle 객체의 위치를 지정된 양만큼 조정합니다. | Rectangle | ||
Point 객체를 매개 변수로 사용하여 Rectangle 객체의 위치를 조정합니다. | Rectangle | ||
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
Rectangle 객체의 모든 속성을 0으로 설정합니다. | Rectangle | ||
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
Rectangle의 멤버를 지정된 값으로 설정합니다.
| Rectangle | ||
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
Rectangle 객체의 가로 및 세로 위치와 폭 및 높이를 나열하는 문자열을 구성하고 반환합니다. | Rectangle | ||
두 사각형을 추가하고 두 사각형 사이의 가로 및 세로 공간을 채워넣어 새 Rectangle 객체를 만듭니다. | Rectangle | ||
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
bottom | 속성 |
bottomRight | 속성 |
height | 속성 |
left | 속성 |
left:Number| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
사각형 왼쪽 위 모서리의 x 좌표입니다. Rectangle 객체의 left 속성을 변경하면 y 및 height 속성에는 아무런 영향을 주지 않습니다. 하지만 width 속성에는 영향을 주는 반면, x 값은 변경해도 width 속성에 영향을 주지 않습니다.
left 속성 값은 x 속성 값과 같습니다.
구현
public function get left():Number public function set left(value:Number):void관련 API 요소
right | 속성 |
size | 속성 |
top | 속성 |
top:Number| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
사각형 왼쪽 위 모서리의 y 좌표입니다. Rectangle 객체의 top 속성을 변경하면 x 및 width 속성에는 아무런 영향을 주지 않습니다. 하지만 height 속성에는 영향을 주는 반면, y 값은 변경해도 height 속성에 영향을 주지 않습니다.
top 속성 값은 y 속성 값과 같습니다.
구현
public function get top():Number public function set top(value:Number):void관련 API 요소
topLeft | 속성 |
width | 속성 |
x | 속성 |
y | 속성 |
Rectangle | () | 생성자 |
public function Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0)| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
x 및 y 매개 변수로 왼쪽 위 모서리를 지정하고 width 및 height 매개 변수를 지정하여 새 Rectangle 객체를 만듭니다. 이 함수를 매개 변수 없이 호출하면 x, y, width 및 height 속성이 0으로 설정된 사각형이 만들어집니다.
x:Number (default = 0) | |
y:Number (default = 0) | |
width:Number (default = 0) | |
height:Number (default = 0) |
관련 API 요소
clone | () | 메서드 |
contains | () | 메서드 |
public function contains(x:Number, y:Number):Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
지정된 점이 이 Rectangle 객체에 의해 정의된 사각형 영역 내에 포함되는지 결정합니다.
매개 변수
x:Number — 점의 x 좌표(가로 위치)입니다.
| |
y:Number — 점의 y 좌표(세로 위치)입니다.
|
Boolean — 지정된 점이 Rectangle 객체에 포함되어 있으면 값이 true이고, 그렇지 않으면 false입니다.
|
관련 API 요소
containsPoint | () | 메서드 |
public function containsPoint(point:Point):Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
지정된 점이 이 Rectangle 객체에 의해 정의된 사각형 영역 내에 포함되는지 결정합니다. 이 메서드는 Point 객체를 매개 변수로 사용하는 점을 제외하면 Rectangle.contains() 메서드와 유사합니다.
매개 변수
point:Point — x 및 y 좌표로 나타내는 점입니다.
|
Boolean — 지정된 점이 Rectangle 객체에 포함되어 있으면 값이 true이고, 그렇지 않으면 false입니다.
|
관련 API 요소
containsRect | () | 메서드 |
public function containsRect(rect:Rectangle):Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
rect 매개 변수에 의해 지정된 Rectangle 객체가 이 Rectangle 객체 내에 포함되는지 결정합니다. 두 번째 Rectangle 객체가 첫 번째 Rectangle 객체의 경계 내에 완전히 포함되면 Rectangle 객체가 다른 Rectangle 객체를 포함한다고 합니다.
매개 변수
rect:Rectangle — 검사할 Rectangle 객체입니다.
|
Boolean — 지정한 Rectangle 객체가 이 Rectangle 객체 내에 포함되면 값이 true이고, 그렇지 않으면 false입니다.
|
copyFrom | () | 메서드 |
equals | () | 메서드 |
public function equals(toCompare:Rectangle):Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
toCompare 매개 변수에 지정된 객체가 이 Rectangle 객체와 같은지 결정합니다. 이 메서드는 객체의 x, y, width 및 height 속성을 이 Rectangle 객체의 같은 속성과 비교합니다.
매개 변수
toCompare:Rectangle — 이 Rectangle 객체와 비교할 사각형입니다.
|
Boolean — 객체의 x, y, width 및 height 속성 값이 이 Rectangle 객체의 해당 속성 값과 완전히 같으면 값이 true이고, 그렇지 않으면 false입니다.
|
관련 API 요소
inflate | () | 메서드 |
public function inflate(dx:Number, dy:Number):void| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Player 9, Flash Lite 4 |
Rectangle 객체의 크기를 지정된 크기(픽셀 단위)만큼 늘립니다. Rectangle 객체의 중심점은 변경되지 않으며 크기는 왼쪽과 오른쪽으로 dx 값만큼 증가하고 위쪽과 아래쪽으로 dy 값만큼 증가합니다.
매개 변수
dx:Number — Rectangle 객체의 왼쪽과 오른쪽에 추가할 값입니다. 다음 수식을 사용하여 사각형의 새 폭과 위치를 계산합니다.
x -= dx;
width += 2 * dx;
| |
dy:Number — Rectangle 객체의 위쪽과 아래쪽에 추가할 값입니다. 다음 수식을 사용하여 사각형의 새 높이와 위치를 계산합니다.
y -= dy;
height += 2 * dy;
|
관련 API 요소
inflatePoint | () | 메서드 |
public function inflatePoint(point:Point):void| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Rectangle 객체의 크기를 늘립니다. 이 메서드는 Point 객체를 매개 변수로 사용하는 점을 제외하면 Rectangle.inflate() 메서드와 유사합니다.
다음 두 코드 예제는 같은 결과를 보여 줍니다.
var rect1:Rectangle = new Rectangle(0,0,2,5);
rect1.inflate(2,2)
var rect1:Rectangle = new Rectangle(0,0,2,5);
var pt1:Point = new Point(2,2);
rect1.inflatePoint(pt1)
매개 변수
point:Point — 이 Point 객체의 x 속성을 사용하여 Rectangle 객체의 가로 크기를 늘립니다. y 속성은 Rectangle 객체의 수직 크기를 늘리는 데 사용합니다.
|
관련 API 요소
intersection | () | 메서드 |
public function intersection(toIntersect:Rectangle):Rectangle| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
toIntersect 매개 변수에 지정된 Rectangle 객체가 이 Rectangle 객체와 교차하는 경우, 교차 영역을 Rectangle 객체로 반환합니다. 사각형이 서로 교차하지 않는 경우 이 메서드는 속성이 0인 빈 Rectangle 객체를 반환합니다.
매개 변수
toIntersect:Rectangle — 이 Rectangle 객체와 교차하는지 알아보기 위해 비교할 대상이 되는 Rectangle 객체입니다.
|
Rectangle — 교차 영역과 같은 Rectangle 객체입니다. 사각형이 서로 교차하지 않는 경우 이 메서드는 x, y, width 및 height 속성이 0으로 설정된 사각형인 빈 Rectangle 객체를 반환합니다.
|
intersects | () | 메서드 |
public function intersects(toIntersect:Rectangle):Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
toIntersect 매개 변수에 지정된 객체가 이 Rectangle 객체와 교차하는지 결정합니다. 이 메서드는 지정된 Rectangle 객체의 x, y, width 및 height 속성을 검사하여 이 Rectangle 객체와 교차하는지 확인합니다.
매개 변수
toIntersect:Rectangle — 이 Rectangle 객체와 비교할 Rectangle 객체입니다.
|
Boolean — 지정된 객체가 이 Rectangle 객체와 교차하면 값이 true이고, 그렇지 않으면 false입니다.
|
관련 API 요소
isEmpty | () | 메서드 |
offset | () | 메서드 |
offsetPoint | () | 메서드 |
setEmpty | () | 메서드 |
setTo | () | 메서드 |
toString | () | 메서드 |
union | () | 메서드 |
public function union(toUnion:Rectangle):Rectangle| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
두 사각형을 추가하고 두 사각형 사이의 가로 및 세로 공간을 채워넣어 새 Rectangle 객체를 만듭니다.
참고: union() 메서드는 높이 또는 폭 값이 0인 사각형(예: var rect2:Rectangle = new Rectangle(300,300,50,0);)을 무시합니다.
매개 변수
toUnion:Rectangle — 이 Rectangle 객체에 추가할 Rectangle 객체입니다.
|
Rectangle — 두 사각형을 결합한 새 Rectangle 객체입니다.
|
trace() 메서드를 사용하여 Rectangle 인스턴스가 성공적으로 만들어졌는지 확인합니다. 그런 다음 두 번째 사각형이 세 번째 사각형을 완전히 포함하는지 여부를 결정하는 부울 변수 isContained가 containsRect() 메서드 호출 결과에 할당됩니다.
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
}
}
}
Tue Jun 12 2018, 03:17 PM Z