javax.swing
클래스 SortingFocusTraversalPolicy

java.lang.Object 
  java.awt.FocusTraversalPolicy 
      javax.swing.InternalFrameFocusTraversalPolicy 
          javax.swing.SortingFocusTraversalPolicy

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

LayoutFocusTraversalPolicy

public class SortingFocusTraversalPolicy
extends InternalFrameFocusTraversalPolicy 

특정의 Comparator 에 근거해 포커스 traversal 사이클의 Component 를 소트 하는 것에 의해 traversal의 순서를 판정하는 FocusTraversalPolicy 입니다. Component 의 계층 가운데, 가시에서도 표시 가능하지도 않은 부분은 포함되지 않습니다.

SortingFocusTraversalPolicy 는, 디폴트의 경우, 암묵에 포커스를 다운 사이클로 이동합니다. 즉, 일반적으로의 포커스 traversal의 경우, 포커스 사이클의 루트의 후에 횡단(traverse) 되는 Component 는, 포커스 사이클의 루트가 포커스 하는 디폴트의 Component 입니다. setImplicitDownCycleTraversal 메소드로 이 동작을 무효로 할 수 있습니다.

디폴트에서는, 이 클래스의 메소드는, 가시성, 표시 가능성, 사용 가능성, 포커스 가능성의 모든 것을 채우는 경우만, Component 를 돌려줍니다. 서브 클래스에서 이 동작을 변경하려면 ,accept 메소드를 오버라이드(override) 합니다.

이 정책는,포커스 traversal 정책 프로바이더를 고려하고 있습니다. 최초/최후/차/전의 Component 를 검색할 때에, 포커스 traversal 정책 프로바이더가 검출되었을 경우는, 그 포커스 traversal 정책를 사용해 검색 조작을 합니다.

도입된 버젼:

1.4

관련 항목:

Comparator

생성자 의 개요

protected	SortingFocusTraversalPolicy () Comparator 를 사용하지 않고 SortingFocusTraversalPolicy 를 구축합니다.
	SortingFocusTraversalPolicy (Comparator <? super Component > comparator) 지정된 Comparator 로 SortingFocusTraversalPolicy 를 구축합니다.

메소드의 개요

protected boolean	accept (Component aComponent) Component 가 새로운 포커스 소유자로서 적절한가 어떤가를 판정합니다.
protected Comparator <? super Component >	getComparator () 포커스 traversal 사이클로 Components 를 소트 하기 위해서 사용하는 Comparator 를 돌려줍니다.
Component	getComponentAfter (Container aContainer, Component aComponent) Component 의 나중에 포커스를 받는 Component 를 돌려줍니다.
Component	getComponentBefore (Container aContainer, Component aComponent) aComponent 의 전에 포커스를 받는 Component 를 돌려줍니다.
Component	getDefaultComponent (Container aContainer) 포커스 하는 디폴트의 Component 를 돌려줍니다.
Component	getFirstComponent (Container aContainer) traversal 사이클의 최초의 Component 를 돌려줍니다.
boolean	getImplicitDownCycleTraversal () 이 SortingFocusTraversalPolicy 가 포커스를 암묵적으로 다운 사이클로 이동할지 어떨지를 돌려줍니다.
Component	getLastComponent (Container aContainer) traversal 사이클의 마지막 Component 를 돌려줍니다.
protected void	setComparator (Comparator <? super Component > comparator) 포커스 traversal 사이클로 Components 를 소트 하기 위해서 사용하는 Comparator 를 설정합니다.
void	setImplicitDownCycleTraversal (boolean implicitDownCycleTraversal) 이 SortingFocusTraversalPolicy 가 포커스를 암묵에 다운 사이클로 이동할지 어떨지를 설정합니다.

클래스 javax.swing. InternalFrameFocusTraversalPolicy 로부터 상속된 메소드

getInitialComponent

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

getInitialComponent

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

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

생성자 의 상세

SortingFocusTraversalPolicy

protected SortingFocusTraversalPolicy()

Comparator 를 사용하지 않고 SortingFocusTraversalPolicy 를 구축합니다. 서브 클래스는, 포커스 사이클의 루트 또는 KeyboardFocusManager 에 이 FocusTraversalPolicy 를 인스톨 하기 전에,setComparator 로 Comparator 를 설정할 필요가 있습니다.

SortingFocusTraversalPolicy

public SortingFocusTraversalPolicy(Comparator <?  super Component > comparator)

지정된 Comparator 로 SortingFocusTraversalPolicy 를 구축합니다.

메소드의 상세

getComponentAfter

public Component  getComponentAfter(Container  aContainer,
                                   Component  aComponent)

Component 의 나중에 포커스를 받는 Component 를 돌려줍니다. aContainer 에는, aComponent 의 포커스 사이클의 루트 또는 포커스 traversal 정책 프로바이더를 지정할 필요가 있습니다.

SortingFocusTraversalPolicy 는, 디폴트의 경우, 암묵에 포커스를 다운 사이클로 이동합니다. 즉, 일반적으로의 포커스 traversal의 경우, 포커스 사이클의 루트의 후에 횡단(traverse) 되는 Component 는, 포커스 사이클의 루트가 포커스 하는 디폴트의 Component 입니다. setImplicitDownCycleTraversal 메소드로 이 동작을 무효로 할 수 있습니다.

aContainer 가포커스 traversal 정책 프로바이더인 경우, 포커스는 항상 다운 사이클로 전송 됩니다.

정의:

클래스 FocusTraversalPolicy 내의 getComponentAfter

파라미터:

aContainer - aComponent 의 포커스 사이클의 루트, 또는 포커스 traversal 정책 프로바이더

aComponent - aContainer 의 (경우에 따라서는 간접적인) 아이, 또는 aContainer 자신

반환값:

aComponent 의 후에 포커스를 받는 Component. 적절한 Component 가 발견되지 않는 경우는 null

예외:

IllegalArgumentException - aContainer 가 aComponent 의 포커스 사이클의 루트 또는 포커스 traversal 정책 프로바이더가 아닌 경우, 혹은 aComponent 가 null 의 경우

getComponentBefore

public Component  getComponentBefore(Container  aContainer,
                                    Component  aComponent)

aComponent 의 전에 포커스를 받는 Component 를 돌려줍니다. aContainer 에는, aComponent 의 포커스 사이클의 루트 또는 포커스 traversal 정책 프로바이더를 지정할 필요가 있습니다.

SortingFocusTraversalPolicy 는, 디폴트의 경우, 암묵에 포커스를 다운 사이클로 이동합니다. 즉, 일반적으로의 포커스 traversal의 경우, 포커스 사이클의 루트의 후에 횡단(traverse) 되는 Component 는, 포커스 사이클의 루트가 포커스 하는 디폴트의 Component 입니다. setImplicitDownCycleTraversal 메소드로 이 동작을 무효로 할 수 있습니다.

aContainer 가포커스 traversal 정책 프로바이더인 경우, 포커스는 항상 다운 사이클로 전송 됩니다.

정의:

클래스 FocusTraversalPolicy 내의 getComponentBefore

파라미터:

aContainer - aComponent 의 포커스 사이클의 루트, 또는 포커스 traversal 정책 프로바이더

aComponent - aContainer 의 (경우에 따라서는 간접적인) 아이, 또는 aContainer 자신

반환값:

aComponent 의 전에 포커스를 받는 Component. 적절한 Component 가 발견되지 않는 경우는 null

예외:

IllegalArgumentException - aContainer 가 aComponent 의 포커스 사이클의 루트 또는 포커스 traversal 정책 프로바이더가 아닌 경우, 혹은 aComponent 가 null 의 경우

getFirstComponent

public Component  getFirstComponent(Container  aContainer)

traversal 사이클의 최초의 Component 를 돌려줍니다. 이 메소드는, 순서 방향의 traversal가 랩 할 경우에, 다음에 포커스 하는 Component 를 판정하기 위해서 사용합니다.

정의:

클래스 FocusTraversalPolicy 내의 getFirstComponent

파라미터:

aContainer - 최초의 Component 가 반환되는 aComponent 의 포커스 사이클의 루트 또는 포커스 traversal 정책 프로바이더

반환값:

aContainer 의 traversal 사이클의 최초의 Component. 적절한 Component 가 발견되지 않는 경우는 null

예외:

IllegalArgumentException - aContainer 가 null 의 경우

getLastComponent

public Component  getLastComponent(Container  aContainer)

traversal 사이클의 마지막 Component 를 돌려줍니다. 이 메소드는, 역방향의 traversal가 랩 할 경우에, 다음에 포커스 하는 Component 를 판정하기 위해서 사용합니다.

정의:

클래스 FocusTraversalPolicy 내의 getLastComponent

파라미터:

aContainer - 마지막 Component 가 반환되는 aComponent 의 포커스 사이클의 루트 또는 포커스 traversal 정책 프로바이더

반환값:

aContainer 의 traversal 사이클의 마지막 Component. 적절한 Component 가 발견되지 않는 경우는 null

예외:

IllegalArgumentException - aContainer 가 null 의 경우

getDefaultComponent

public Component  getDefaultComponent(Container  aContainer)

포커스 하는 디폴트의 Component 를 돌려줍니다. aContainer 에 루트가 있는 새로운 포커스 traversal 사이클에 횡단(traverse) 할 때, 이 Component 는 최초로 포커스를 받습니다. 이 메소드의 디폴트의 구현은,getFirstComponent 와 같은 Component 를 돌려줍니다.

정의:

클래스 FocusTraversalPolicy 내의 getDefaultComponent

파라미터:

aContainer - 디폴트의 Component 가 반환되는 aComponent 의 포커스 사이클의 루트 또는 포커스 traversal 정책 프로바이더

반환값:

aContainer 의 traversal 사이클의 디폴트의 Component. 적절한 Component 가 발견되지 않는 경우는 null

예외:

IllegalArgumentException - aContainer 가 null 의 경우

관련 항목:

getFirstComponent(java.awt.Container)

setImplicitDownCycleTraversal

public void setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)

이 SortingFocusTraversalPolicy 가 포커스를 암묵에 다운 사이클로 이동할지 어떨지를 설정합니다. true 의 경우, 일반적으로의 포커스 traversal에서는, 포커스 사이클의 루트의 후에 횡단(traverse) 되는 Component 는, 포커스 사이클의 루트로부터 포커스를 받는 디폴트의 Component 입니다. false 의 경우, 지정된 포커스 사이클을 루트로 하는 포커스 traversal 사이클내의, 다음의 Component 가 대신에 횡단(traverse) 됩니다. 이 프로퍼티의 디폴트 값는 true 입니다.

파라미터:

implicitDownCycleTraversal - 이 SortingFocusTraversalPolicy 가 암묵적으로 포커스를 다운 사이클로 이동할지 어떨지

관련 항목:

getImplicitDownCycleTraversal() , getFirstComponent(java.awt.Container)

getImplicitDownCycleTraversal

public boolean getImplicitDownCycleTraversal()

이 SortingFocusTraversalPolicy 가 포커스를 암묵적으로 다운 사이클로 이동할지 어떨지를 돌려줍니다. true 의 경우, 일반적으로의 포커스 traversal에서는, 포커스 사이클의 루트의 후에 횡단(traverse) 되는 Component 는, 포커스 사이클의 루트로부터 포커스를 받는 디폴트의 Component 입니다. false 의 경우, 지정된 포커스 사이클을 루트로 하는 포커스 traversal 사이클내의, 다음의 Component 가 대신에 횡단(traverse) 됩니다.

반환값:

이 SortingFocusTraversalPolicy 가 암묵적으로 포커스를 다운 사이클로 이동할지 어떨지

관련 항목:

setImplicitDownCycleTraversal(boolean) , getFirstComponent(java.awt.Container)

setComparator

protected void setComparator(Comparator <?  super Component > comparator)

포커스 traversal 사이클로 Components 를 소트 하기 위해서 사용하는 Comparator 를 설정합니다.

파라미터:

comparator - 소트에 사용하는 Comparator

getComparator

protected Comparator <?  super Component > getComparator()

포커스 traversal 사이클로 Components 를 소트 하기 위해서 사용하는 Comparator 를 돌려줍니다.

반환값:

소트에 사용하는 Comparator

accept

protected boolean accept(Component  aComponent)

Component 가 새로운 포커스 소유자로서 적절한가 어떤가를 판정합니다. 디폴트에서는, 가시성, 표시 가능성, 사용 가능성, 포커스 가능성의 모든 것을 채우는 경우만, Component 를 받아들입니다.

파라미터:

aComponent - 포커스 소유자로서 적절한가 어떤가를 판정한다 Component

반환값:

aComponent 가 가시로, 표시 가능, 유효, 한편 포커스 가능한 경우는 true, 그렇지 않은 경우는,false