JavaTM Platform
Standard Ed. 6

javax.swing
클래스 SizeRequirements

java.lang.Object 
  상위를 확장 javax.swing.SizeRequirements
모든 구현된 인터페이스:
Serializable


public class SizeRequirements
extends Object
implements Serializable

레이아웃 매니저의 편의를 위해서(때문에), 컴퍼넌트의 사이즈와 위치에 대한 정보를 계산합니다. 사이즈와 위치의 모든 계산 메소드는, SizeRequirements 의 배열을 인수로서 취득하는 클래스 메소드입니다. SizeRequirements 클래스는 2 종류의 레이아웃을 지원합니다.

tiled
컴퍼넌트는 좌표 0 (좌단 또는 상단)으로부터 시작되어 both and justification로 배치되든가, 혹은 할당할 수 있었던 스팬의 구석을 나타내는 좌표 (우단 또는 하단)로부터 시작되어 both and justification로 배치된다.
aligned
컴퍼넌트는 각각의 가지런히 하는 방법의 값 (X 또는 Y)에 근거해 정렬된다

각 SizeRequirements 객체는, 1 개의 컴퍼넌트 또는 복수의 컴퍼넌트의 폭 (와 X 가지런히 하고) 또는 높이 (와 Y 가지런히 하고)의 어딘가에 붙은 정보를 보관 유지합니다.

minimum
컴퍼넌트 또는 컴퍼넌트 그룹의 적당한 최소의 폭 및 높이 (픽셀 단위)
preferred
컴퍼넌트 또는 컴퍼넌트 그룹의 본래의 폭 및 높이 (픽셀 단위)
maximum
컴퍼넌트 또는 컴퍼넌트 그룹의 적당한 최대의 폭 및 높이 (픽셀 단위)
alignment
컴퍼넌트 또는 컴퍼넌트 그룹의 X 및 Y 가지런히 하고

경고: 이 클래스의 직렬화 된 객체는, 향후의 Swing 릴리스와 호환은 아니게 될 예정입니다. 현재의 직렬화의 지원는, 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. JDK Version 1.4 이후, 모든 JavaBeans 의 장기간의 운용 지원는,java.beans 패키지에 추가되고 있습니다. 자세한 것은,XMLEncoder 를 참조해 주세요.

관련 항목:
Component.getMinimumSize() , Component.getPreferredSize() , Component.getMaximumSize() , Component.getAlignmentX() , Component.getAlignmentY()

필드의 개요
 float alignment
          0. 0 으로 1.0 의 사이의 값 (상하한치를 포함한다)으로 지정되는 배치입니다.
 int maximum
          가능한 최대 사이즈입니다.
 int minimum
          필요하게 되는 최소 사이즈입니다.
 int preferred
          적절한 (본래의) 사이즈입니다.
 
생성자 의 개요
SizeRequirements ()
          최소 사이즈, 적절한 사이즈, 최대 사이즈를 제로에, 배치의 값을 0.5 (centering)로 설정해, SizeRequirements 객체를 작성합니다.
SizeRequirements (int min, int pref, int max, float a)
          지정된 최소 사이즈, 적절한 사이즈, 최대 사이즈, 및 배치로, SizeRequirements 객체를 작성합니다.
 
메소드의 개요
static int[] adjustSizes (int delta, SizeRequirements [] children)
          지정된 양으로, 지정된 배열의 사이즈를 조정합니다.
static void calculateAlignedPositions (int allocated, SizeRequirements  total, SizeRequirements [] children, int[] offsets, int[] spans)
          컴퍼넌트세트를 지정의 가지런히 하는 방법으로 레이아웃 하는 방법을 나타내는, 많은 오프셋(offset)/스팬의 페어를 작성합니다.
static void calculateAlignedPositions (int allocated, SizeRequirements  total, SizeRequirements [] children, int[] offsets, int[] spans, boolean normal)
          컴퍼넌트세트를 지정의 가지런히 하는 방법으로 레이아웃 하는 방법을 나타내는, 많은 오프셋(offset)/스팬의 페어를 작성합니다.
static void calculateTiledPositions (int allocated, SizeRequirements  total, SizeRequirements [] children, int[] offsets, int[] spans)
          컴퍼넌트세트를 구석에서 구석까지 레이아웃 하는 방법을 나타내는, 많은 오프셋(offset)/스팬의 페어를 작성합니다.
static void calculateTiledPositions (int allocated, SizeRequirements  total, SizeRequirements [] children, int[] offsets, int[] spans, boolean forward)
          컴퍼넌트세트를 구석에서 구석까지 레이아웃 하는 방법을 나타내는, 많은 오프셋(offset)/스팬의 페어를 작성합니다.
static SizeRequirements getAlignedSizeRequirements (SizeRequirements [] children)
          컴퍼넌트세트를 배치하는데 필요한 합계 스페이스를 판정합니다.
static SizeRequirements getTiledSizeRequirements (SizeRequirements [] children)
          컴퍼넌트세트를 구석에서 구석까지 배치하는데 필요한 합계 스페이스를 판정합니다.
 String toString ()
          최소 사이즈, 적절한 사이즈, 최대 사이즈의 요건을 기술하는 캐릭터 라인을, 배치와 함께 돌려줍니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait
 

필드의 상세

minimum

public int minimum
필요하게 되는 최소 사이즈입니다. 컴퍼넌트 comp 에서는, 이 사이즈는 comp.getMinimumSize(). width 또는 comp.getMinimumSize(). height 의 어딘가에 동일하지 않으면 안됩니다.


preferred

public int preferred
적절한 (본래의) 사이즈입니다. 컴퍼넌트 comp 에서는, 이 사이즈는 comp.getPreferredSize(). width 또는 comp.getPreferredSize(). height 의 어딘가에 동일하지 않으면 안됩니다.


maximum

public int maximum
가능한 최대 사이즈입니다. 컴퍼넌트 comp 에서는, 이 사이즈는 comp.getMaximumSize(). width 또는 comp.getMaximumSize(). height 의 어딘가에 동일하지 않으면 안됩니다.


alignment

public float alignment
0.0 으로 1.0 의 사이의 값 (상하한치를 포함한다)으로 지정되는 배치입니다. centering를 지정하려면 , 배치의 값은 0.5 가 아니면 안됩니다.

생성자 의 상세

SizeRequirements

public SizeRequirements()
최소 사이즈, 적절한 사이즈, 최대 사이즈를 제로에, 배치의 값을 0.5 (centering)로 설정해, SizeRequirements 객체를 작성합니다.


SizeRequirements

public SizeRequirements(int min,
                        int pref,
                        int max,
                        float a)
지정된 최소 사이즈, 적절한 사이즈, 최대 사이즈, 및 배치로, SizeRequirements 객체를 작성합니다.

파라미터:
min - 최소 사이즈 >= 0
pref - 적절한 사이즈 >= 0
max - 최대 사이즈 >= 0
a - 배치 >= 0 . 0f && <= 1.0f
메소드의 상세

toString

public String  toString()
최소 사이즈, 적절한 사이즈, 최대 사이즈의 요건을 기술하는 캐릭터 라인을, 배치와 함께 돌려줍니다.

오버라이드(override):
클래스 Object 내의 toString
반환값:
캐릭터 라인

getTiledSizeRequirements

public static SizeRequirements  getTiledSizeRequirements(SizeRequirements [] children)
컴퍼넌트세트를 구석에서 구석까지 배치하는데 필요한 합계 스페이스를 판정합니다. 그 각 컴퍼넌트의 필요 사항은, 건네받은 SizeRequirements 배열의 엔트리에 의해 표현됩니다. 반환된 SizeRequirements 객체는, 0.5 (centering)라고 하는 배치의 값을 가집니다. 스페이스 요건은, Integer.MAX_VALUE 보다 크지는 되지 않습니다.

파라미터:
children - 컴퍼넌트세트의 스페이스 요건. 벡터의 길이는 제로에서도 자주(잘), 그 경우는 디폴트의 SizeRequirements 객체의 인스턴스가 건네받는다
반환값:
합계 스페이스의 요건

getAlignedSizeRequirements

public static SizeRequirements  getAlignedSizeRequirements(SizeRequirements [] children)
컴퍼넌트세트를 배치하는데 필요한 합계 스페이스를 판정합니다. 그 각 컴퍼넌트의 필요 사항은, 건네받은 SizeRequirements 배열의 엔트리에 의해 표현됩니다. 필요한 합계 스페이스는, Integer.MAX_VALUE 보다 크지는 되지 않습니다.

파라미터:
children - 자의 요건세트. 길이가 0 의 경우, SizeRequirements 의 디폴트 인스턴스가 반환된다
반환값:
합계 스페이스의 요건

calculateTiledPositions

public static void calculateTiledPositions(int allocated,
                                           SizeRequirements  total,
                                           SizeRequirements [] children,
                                           int[] offsets,
                                           int[] spans)
컴퍼넌트세트를 구석에서 구석까지 레이아웃 하는 방법을 나타내는, 많은 오프셋(offset)/스팬의 페어를 작성합니다. 이 메소드는, 할당 스페이스량의 합계, 배치하는 각 컴퍼넌트의 사이즈 요건 (SizeRequirements 의 배열로 지정된다), 컴퍼넌트 세트의 합계 사이즈의 요건을 사용자가 지정하는 것을 요구합니다. 합계 사이즈의 요건을 가져오려면 , getTiledSizeRequirements 메소드를 호출합니다. 컴퍼넌트는, 0 으로부터 오프셋(offset)분을 늘리면서 순서 방향으로 타일링 됩니다.

파라미터:
allocated - 할당하는 합계 스팬 >= 0
total - 자의 요구의 합계 이 인수 (은)는 옵션이며, null 의 경우가 있는
children - 각 컴퍼넌트의 사이즈 요건
offsets - 스팬을 할당할 수 있었던 각 자의 0 으로부터의 오프셋(offset) (스팬의 배치를 지정한다)
spans - 각 자가 할당할 수 있었던 스팬으로, 합계 타겟 스팬을 구성한다

calculateTiledPositions

public static void calculateTiledPositions(int allocated,
                                           SizeRequirements  total,
                                           SizeRequirements [] children,
                                           int[] offsets,
                                           int[] spans,
                                           boolean forward)
컴퍼넌트세트를 구석에서 구석까지 레이아웃 하는 방법을 나타내는, 많은 오프셋(offset)/스팬의 페어를 작성합니다. 이 메소드는, 할당 스페이스량의 합계, 배치하는 각 컴퍼넌트의 사이즈 요건 (SizeRequirements 의 배열로 지정된다), 컴퍼넌트 세트의 합계 사이즈의 요건을 사용자가 지정하는 것을 요구합니다. 합계 사이즈의 요건을 가져오려면 , getTiledSizeRequirements 메소드를 호출합니다. 이 메소드에서는, 컴퍼넌트를 순서 방향으로 (0 으로부터 오프셋(offset)분 늘리면서) 타일링 하는지, 역방향으로 (할당 스페이스의 구석으로부터 오프셋(offset)분 줄이면서) 타일링 할까를 플래그로 지정합니다. 순서 방향은, 컴퍼넌트를 왼쪽에서 오른쪽 또는 위에서 아래로 타일링 하는 것을 나타내, 역방향은, 컴퍼넌트를 오른쪽에서 왼쪽 또는 아래에서 위로 타일링 하는 것을 나타냅니다.

파라미터:
allocated - 할당하는 합계 스팬 >= 0
total - 자의 요구의 합계 이 인수 (은)는 옵션이며, null 의 경우가 있는
children - 각 컴퍼넌트의 사이즈 요건
offsets - 스팬을 할당할 수 있었던 각 자의 0 으로부터의 오프셋(offset) (스팬의 배치를 지정한다)
spans - 각 자가 할당할 수 있었던 스팬으로, 합계 타겟 스팬을 구성하는
forward - true 의 경우, 0 으로부터 오프셋(offset)분 늘리면서 타일링 해, false 의 경우, 할당 스페이스의 구석으로부터 오프셋(offset)분 줄이면서 타일링 하는
도입된 버젼:
1.4

calculateAlignedPositions

public static void calculateAlignedPositions(int allocated,
                                             SizeRequirements  total,
                                             SizeRequirements [] children,
                                             int[] offsets,
                                             int[] spans)
컴퍼넌트세트를 지정의 가지런히 하는 방법으로 레이아웃 하는 방법을 나타내는, 많은 오프셋(offset)/스팬의 페어를 작성합니다. 결과적으로 얻을 수 있는 스팬 할당은, 지정의 합계 할당에 각각이 들어갈까 가능한 한 들어가는 상태로 오버랩 합니다. 이 메소드는, 할당 스페이스량의 합계, 배치하는 각 컴퍼넌트의 사이즈 요건 (SizeRequirements 의 배열로 지정된다), 컴퍼넌트 세트의 합계 사이즈의 요건 (실제로 사용되는 배치 필드만)을 사용자가 지정하는 것을 요구합니다. 합계 사이즈의 요건을 가져오려면 , getAlignedSizeRequirements 메소드를 호출합니다. 일반적으로의 배치는, 배치의 값을 0.0f (컴퍼넌트의 좌상단을 나타낸다)로 설정해 실행됩니다.

파라미터:
allocated - 할당하는 합계 스팬 >= 0
total - 자의 요구의 합계
children - 각 컴퍼넌트의 사이즈 요건
offsets - 스팬을 할당할 수 있었던 각 자의 0 으로부터의 오프셋(offset) (스팬의 배치를 지정한다)
spans - 각 자가 할당할 수 있었던 스팬으로, 합계 타겟 스팬을 구성한다

calculateAlignedPositions

public static void calculateAlignedPositions(int allocated,
                                             SizeRequirements  total,
                                             SizeRequirements [] children,
                                             int[] offsets,
                                             int[] spans,
                                             boolean normal)
컴퍼넌트세트를 지정의 가지런히 하는 방법으로 레이아웃 하는 방법을 나타내는, 많은 오프셋(offset)/스팬의 페어를 작성합니다. 결과적으로 얻을 수 있는 스팬 할당은, 지정의 합계 할당에 각각이 들어갈까 가능한 한 들어가는 상태로 오버랩 합니다. 이 메소드는, 할당 스페이스량의 합계, 배치하는 각 컴퍼넌트의 사이즈 요건 (SizeRequirements 의 배열로 지정된다), 컴퍼넌트 세트의 합계 사이즈의 요건 (실제로 사용되는 배치 필드만)을 사용자가 지정하는 것을 요구합니다. 합계 사이즈의 요건을 가져오려면 , getAlignedSizeRequirements 메소드를 호출합니다. 이 메소드에서는, 일반적으로의 배치와 역의 배치의 어느 쪽을 실시할까를 플래그로 지정합니다. 일반적으로의 배치의 값 0.0f 는 배치하는 컴퍼넌트의 좌상단을 나타내, 역의 배치의 0.0f 는 우하단을 나타냅니다.

파라미터:
allocated - 할당하는 합계 스팬 >= 0
total - 자의 요구의 합계
children - 각 컴퍼넌트의 사이즈 요건
offsets - 스팬을 할당할 수 있었던 각 자의 0 으로부터의 오프셋(offset) (스팬의 배치를 지정한다)
spans - 각 자가 할당할 수 있었던 스팬으로, 합계 타겟 스팬을 구성하는
normal - true 의 경우, 배치의 값 0.0f 는 좌상단을 나타내, false 의 경우는 우하단을 나타내는
도입된 버젼:
1.4

adjustSizes

public static int[] adjustSizes(int delta,
                                SizeRequirements [] children)
지정된 양으로, 지정된 배열의 사이즈를 조정합니다.

파라미터:
delta - 사이즈의 차이를 나타내는 int 치
children - SizeRequirements 객체의 배열
반환값:
각 항목의 최종 사이즈가 포함되고 있는 int 의 배열

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.