javax.swing
클래스 SpringLayout

java.lang.Object 
  javax.swing.SpringLayout

모든 구현된 인터페이스:

LayoutManager, LayoutManager2

public class SpringLayout
extends Object 
implements LayoutManager2 

SpringLayout는 일련의 제약에 기반해 관련된 컨테이너의 자식을 배치합니다. SpringLayout 사용예에 대해서는 「The Java Tutorial」의 「How to Use SpringLayout」를 참조하십시오.

Spring 객체로 나타내지는 각 제약은 2개의 컴퍼넌트 엣지간의 수직 방향 또는 수평 방향의 거리를 제어합니다. 엣지는 컨테이너의자식 또는 컨테이너 자신에게 속할 수 있습니다 . 예를 들어 컴퍼넌트에 용서되는 폭은 컴퍼넌트의 west (왼쪽) 엣지와 east ( 오른쪽) 엣지간의 거리를 제어하는 제약을 사용해 표현할 수 있습니다. 컴퍼넌트에 용서되는 y 좌표는 컴퍼넌트의 north (상단) 엣지와 컨테이너의 north 엣지간의 거리의 제약에 의해 표현할 수 있습니다.

SpringLayout에 의해 제어되는 컨테이너의 모든자식는 컨테이너 자신과 같게, 관련된 제약을 1 세트만 가집니다. 제약은, SpringLayout.Constraints 객체에 의해 표현됩니다. SpringLayout이 디폴트로 작성하는 제약에서는 관련된 컴퍼넌트에 컴퍼넌트의 Component.getMinimumSize() 메서드, Component.getPreferredSize() 메서드 및 Component.getMaximumSize() 메서드가 돌려주는 최소 사이즈, 추천 사이즈 및 최대 사이즈가 설정됩니다. x와 y 위치는 초기 상태에서는 제약이 설정되어 있지 않기 때문에 Component 위치는 제약을 설정할 때까지 친 Container Insets에 대해서 0,0 이 됩니다.

컴퍼넌트의 제약을 변경하려면 복수의 방법이 있습니다. putConstraint 메서드의 어떤 것인지를 사용하면, 동일 컨테이너내의 2개의 컴퍼넌트의 엣지에 접속하는 스프링을 확립할 수 있습니다. 또한, getConstraints 메서드를 사용하면, 적절한 SpringLayout.Constraints 객체를 취득할 수 있어 그 후 1개 이상의 스프링을 변경할 수 있습니다. getConstraint 메서드를 사용하면, 컴퍼넌트의 특정의 엣지에 대한 스프링을 취득할 수 있어 그 후 스프링을 변경할 수 있습니다. Container.add(Component, Object)를 사용하면, 컴퍼넌트를 컨테이너에 추가할 경우에 제약 객체를 지정하는 것으로써, 독자적인 SpringLayout.Constraints 객체를 컴퍼넌트에 관련지을 수가 있습니다.

각 제약을 나타내는 Spring 객체에는 최소값 (minimum 치), 추천치 (preferred 치), 최대값 (maximum 치) 및 현재의 값이 설정됩니다. 스프링의 현재의 값은 최소값와 최대값 의 사이에 있는 값으로Spring.sum(javax.swing.Spring, javax.swing.Spring) 메서드의 설명으로 나타나는 식에 따릅니다. 최소값, 추천치 및 최대값이 동일한 경우, 현재의 값도 항상 동일해집니다. 이러한 유연성이 없는 스프링은 「기둥」 (strut)로 불립니다. 팩토리 메서드의 Spring.constant(int)를 사용하면, 기둥을 생성할 수 있습니다. Spring 클래스에는 다른 스프링에 의존된 스프링 등, 그 외의 종류의 스프링을 작성하는 팩토리 메서드도 준비되어 있습니다.

SpringLayout에 서는 각 엣지의 위치는 다른 1개 엣지만의 위치에 의존합니다. 제약을 다음에 추가해 엣지에 새로운 바인딩을 작성하면, 이전의 바인딩은 파기되어 엣지는 1개의 엣지에 존한 상태인 채 유지됩니다. 스프링은 컨테이너와 그 직접적인자식 의 엣지간에만 접속할 필요가 있습니다. SpringLayout 동작은 다른 컨테이너의 내부 또는 외부로부터 컴퍼넌트의 엣지에 접속하는 제약에 의해 표현되는 경우, 정의되지 않습니다.

SpringLayout와 그 외의 레이아웃 매니저

주: 많은 레이아웃 매니저와는 달라, SpringLayout는 관리하는 컴퍼넌트의 위치를 자동적으로 설정하지 않습니다. SpringLayout를 사용하는 GUI를 핸드 코딩 하는 경우는 west/east 및 north/south 위치에 제약을 설정하는 것에의해 컴퍼넌트의 위치를 초기화해 주세요.

사용하는 제약에 따라서는 컨테이너의 사이즈를 명시적으로 설정하는 것이 필요한 경우도 있습니다.

SpringLayout는 단순합니다만, 대부분의 레이아웃 매니저의 동작을 에뮤레이트 할 수 있습니다. FlowLayout 행 브레이크와 같은 기능에 대해서는 Spring 클래스에 전용의 서브 클래스를 작성할 필요가 있습니다.

SpringLayout를 사용하면, Box를 상자로 한 편성에서는 해결할 수 없는 것 같은 레이아웃에 관한 어려운 문제도 많이 해결할 수 있습니다. SpringLayout는 LayoutManager2 규약을 정확하게 준수하고 있기 때문에 다른 레이아웃 매니저를 상자로 할 수 있습니다. 이것은 다른 레이아웃 매니저에 포함되는 제약을 작성하는 방법보다 바람직한 방법입니다.

SpringLayout에 한 레이아웃 오퍼레이션의 점근적 complex system는 제약 또는 컴퍼넌트, 혹은 그 양쪽 모두의 수에 비례합니다.

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

도입된 버전 :

1.4

관련 항목:

Spring, SpringLayout.Constraints

중첩(Nested) 클래스 개요

static class

SpringLayout.Constraints Constraints객체는 SpringLayout이 제어하는 컨테이너내의 컴퍼넌트의 사이즈 변경 방법 및 위치 변경 방법을 결정하는 제약을 보관 유지합니다.

필드 개요

static String	EAST 컴퍼넌트의 경계의 구형의 우단을 지정합니다.
static String	NORTH 컴퍼넌트의 경계의 구형의 상단을 지정합니다.
static String	SOUTH 컴퍼넌트의 경계의 구형의 하단을 지정합니다.
static String	WEST 컴퍼넌트의 경계의 구형의 좌단을 지정합니다.

생성자 개요

SpringLayout ()
새로운 SpringLayout를 구축합니다.

메서드 개요

void	addLayoutComponent (Component component, Object constraints) constraints가 SpringLayout.Constraints 인스턴스인 경우는 지정된 컴퍼넌트에 제약을 관련짓습니다.
void	addLayoutComponent (String name, Component c) 이 레이아웃 매니저는 컴퍼넌트마다의 캐릭터 라인을 사용하지 않기 때문에 아무것도 하지 않습니다.
Spring	getConstraint (String edgeName, Component c) 컴퍼넌트의 지정된 엣지와 부모의 상단 엣지 또는 왼쪽 엣지와의 사이의 거리를 제어하는 스프링을 리턴합니다.
SpringLayout.Constraints	getConstraints (Component c) 지정된 컴퍼넌트의 제약을 리턴합니다.
float	getLayoutAlignmentX (Container p) 0. 5f (centering)를 리턴합니다.
float	getLayoutAlignmentY (Container p) 0. 5f (centering)를 리턴합니다.
void	invalidateLayout (Container p) 레이아웃을 무효로 합니다.
void	layoutContainer (Container parent) 지정된 컨테이너를 배치합니다.
Dimension	maximumLayoutSize (Container parent) 지정된 컨테이너의 최대 사이즈의 크기를 계산합니다.
Dimension	minimumLayoutSize (Container parent) 지정된 컨테이너의 최소 사이즈의 크기를 계산합니다.
Dimension	preferredLayoutSize (Container parent) 지정된 컨테이너의 추천 사이즈의 크기를 계산합니다.
void	putConstraint (String e1, Component c1, int pad, String e2, Component c2) 컴퍼넌트 c1 엣지 e1를 컴퍼넌트 c2 엣지 e2에 엣지간의 거리를 고정해 접속합니다.
void	putConstraint (String e1, Component c1, Spring s, String e2, Component c2) 컴퍼넌트 c1 엣지 e1와 컴퍼넌트 c2 엣지 e2를 접속합니다.
void	removeLayoutComponent (Component c) 지정된 컴퍼넌트에 관련부 제약을 삭제합니다.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

NORTH

public static final String  NORTH

컴퍼넌트의 경계의 구형의 상단을 지정합니다.

관련 항목:

정수 필드값

SOUTH

public static final String  SOUTH

컴퍼넌트의 경계의 구형의 하단을 지정합니다.

관련 항목:

정수 필드값

EAST

public static final String  EAST

컴퍼넌트의 경계의 구형의 우단을 지정합니다.

관련 항목:

정수 필드값

WEST

public static final String  WEST

컴퍼넌트의 경계의 구형의 좌단을 지정합니다.

관련 항목:

정수 필드값

생성자 상세

SpringLayout

public SpringLayout()

새로운 SpringLayout를 구축합니다.

메서드의 상세

addLayoutComponent

public void addLayoutComponent(String  name,
                               Component  c)

이 레이아웃 매니저는 컴퍼넌트마다의 캐릭터 라인을 사용하지 않기 때문에 아무것도 하지 않습니다.

정의:

인터페이스 LayoutManager 내의 addLayoutComponent

파라미터:

name - 컴퍼넌트에 관련된 캐릭터 라인

c - 추가되는 컴퍼넌트

removeLayoutComponent

public void removeLayoutComponent(Component  c)

지정된 컴퍼넌트에 관련부 제약을 삭제합니다.

정의:

인터페이스 LayoutManager 내의 removeLayoutComponent

파라미터:

c - 컨테이너로부터 삭제되는 컴퍼넌트

minimumLayoutSize

public Dimension  minimumLayoutSize(Container  parent)

인터페이스 LayoutManager 기술:

지정된 컨테이너의 최소 사이즈의 크기를 계산합니다. 포함되는 컴퍼넌트는 지정됩니다.

정의:

인터페이스 LayoutManager 내의 minimumLayoutSize

파라미터:

parent - 배치되는 컴퍼넌트

관련 항목:

LayoutManager.preferredLayoutSize(java.awt.Container)

preferredLayoutSize

public Dimension  preferredLayoutSize(Container  parent)

인터페이스 LayoutManager 기술:

지정된 컨테이너의 추천 사이즈의 크기를 계산합니다. 포함되는 컴퍼넌트는 지정됩니다.

정의:

인터페이스 LayoutManager 내의 preferredLayoutSize

파라미터:

parent - 배치되는 컨테이너

관련 항목:

LayoutManager.minimumLayoutSize(java.awt.Container)

maximumLayoutSize

public Dimension  maximumLayoutSize(Container  parent)

인터페이스 LayoutManager2 기술:

지정된 컨테이너의 최대 사이즈의 크기를 계산합니다. 포함되는 컴퍼넌트는 지정됩니다.

정의:

인터페이스 LayoutManager2 내의 maximumLayoutSize

관련 항목:

Component.getMaximumSize(), LayoutManager

addLayoutComponent

public void addLayoutComponent(Component  component,
                               Object  constraints)

constraints가 SpringLayout.Constraints 인스턴스인 경우는 지정된 컴퍼넌트에 제약을 관련짓습니다.

정의:

인터페이스 LayoutManager2 내의 addLayoutComponent

파라미터:

component - 추가하는 컴퍼넌트

constraints - 컴퍼넌트의 제약

관련 항목:

SpringLayout.Constraints

getLayoutAlignmentX

public float getLayoutAlignmentX(Container  p)

0.5f (centering)를 리턴합니다.

정의:

인터페이스 LayoutManager2 내의 getLayoutAlignmentX

getLayoutAlignmentY

public float getLayoutAlignmentY(Container  p)

0.5f (centering)를 리턴합니다.

정의:

인터페이스 LayoutManager2 내의 getLayoutAlignmentY

invalidateLayout

public void invalidateLayout(Container  p)

인터페이스 LayoutManager2 기술:

레이아웃을 무효로 합니다. 이 때, 레이아웃 매니저가 정보를 캐쉬하고 있으면 그것을 파기합니다.

정의:

인터페이스 LayoutManager2 내의 invalidateLayout

putConstraint

public void putConstraint(String  e1,
                          Component  c1,
                          int pad,
                          String  e2,
                          Component  c2)

컴퍼넌트 c1 엣지 e1를 컴퍼넌트 c2 엣지 e2에 엣지간의 거리를 고정해 접속합니다. 이 제약에의해 후속의 모든 레이아웃 오퍼레이션으로 다음의 대입이 발생합니다.

value(e1, c1) = value(e2, c2) + pad

■번역문 없음■

파라미터:

e1 - 의존된 엣지

c1 - 의존된 컴퍼넌트

pad - 의존된 측으로 여겨지는 측의 사이의 고정 거리

e2 - 존되는 엣지

c2 - 존되는 컴퍼넌트

관련 항목:

putConstraint(String, Component, Spring, String, Component)

putConstraint

public void putConstraint(String  e1,
                          Component  c1,
                          Spring  s,
                          String  e2,
                          Component  c2)

컴퍼넌트 c1 엣지 e1와 컴퍼넌트 c2 엣지 e2를 접속합니다. 엣지 (e2, c2)값이 변경되면, (e2, c2) 라고 s (스프링) sum에 의해 엣지 (e1, c1)가 계산됩니다. 각 엣지는 SpringLayout.NORTH, SpringLayout.SOUTH, SpringLayout.EAST, SpringLayout.WEST 어떤 것인가의 값을 가질 필요가 있습니다.

파라미터:

e1 - 의존된 엣지

c1 - 의존된 컴퍼넌트

s - 의존된 측과 존되는 측을 접속하는 스프링

e2 - 존되는 엣지

c2 - 존되는 컴퍼넌트

관련 항목:

putConstraint(String, Component, int, String, Component), NORTH, SOUTH, EAST, WEST

getConstraints

public SpringLayout.Constraints  getConstraints(Component  c)

지정된 컴퍼넌트의 제약을 리턴합니다. GridBagLayout getConstraints 메서드와는 달라, 이 메서드는 제약을 복제하지 않습니다. 컴퍼넌트에 관련된 제약이 없는 경우는 부모의 인 세트에 대해서 0,0 위치에 있는 디폴트의 제약 객체를 리턴합니다. 폭과 높이는 컴퍼넌트의 최소 사이즈, 최대 사이즈 및 추천 사이즈에 제약됩니다. 메서드가 불려 간 시점에서 사이즈의 특성은 동결됩니다만, 변경된 컴퍼넌트의 특성을 추적하는 특성을 가지는 제약 객체를 리턴합니다.

파라미터:

c - 리턴된 제약을 가지는 컴퍼넌트

반환값:

지정된 컴퍼넌트의 제약

getConstraint

public Spring  getConstraint(String  edgeName,
                            Component  c)

컴퍼넌트의 지정된 엣지와 부모의 상단 엣지 또는 왼쪽 엣지와의 사이의 거리를 제어하는 스프링을 리턴합니다. 이 메서드는 엣지에 대한 현재의 바인딩을 돌려주는 것이 아니라, 엣지를 다음에 재차 바인드 하는 경우에도 엣지의 특성을 추적하는 프록시를 리턴합니다. 프록시는 구축 환경에서의 사용을 목적으로 하고 있습니다. 구축 환경에서는 사용자가 임의의 순서로 레이아웃의 제약을 정의할 수 있도록 하는 것이 편리합니다. 다만, 프록시는 레이아웃의 제약간의 순환적인 존성을 작성하는 수단을 제공합니다. 그러한 사이클은 레이아웃 오퍼레이션을 언제라도 종료할 수 있도록, SpringLayout에 의해 내부적으로 검출됩니다.

파라미터:

edgeName - SpringLayout.NORTH, SpringLayout.SOUTH, SpringLayout.EAST, SpringLayout.WEST 어떤 것이나

c - 엣지 스프링이 요구되는 컴퍼넌트

반환값:

지정된 엣지와 그 부모의 상단 엣지 또는 왼쪽 엣지간의 거리를 제어하는 스프링에 대한 프록시

관련 항목:

NORTH, SOUTH, EAST, WEST

layoutContainer

public void layoutContainer(Container  parent)

인터페이스 LayoutManager 기술:

지정된 컨테이너를 배치합니다.

정의:

인터페이스 LayoutManager 내의 layoutContainer

파라미터:

parent - 배치되는 컨테이너