javax.swing
클래스 DefaultListSelectionModel

java.lang.Object 
  javax.swing.DefaultListSelectionModel

모든 구현된 인터페이스:

Serializable, Cloneable, ListSelectionModel

public class DefaultListSelectionModel
extends Object 
implements ListSelectionModel,
 Cloneable,
 Serializable 

리스트 선택의 디폴트 데이터 모델입니다.

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

관련 항목:

ListSelectionModel

필드 개요

protected boolean	leadAnchorNotificationEnabled
protected EventListenerList	listenerList

인터페이스 javax.swing. ListSelectionModel 로부터 상속된 필드

MULTIPLE_INTERVAL_SELECTION, SINGLE_INTERVAL_SELECTION, SINGLE_SELECTION

생성자 개요

DefaultListSelectionModel ()

메서드 개요

void	addListSelectionListener (ListSelectionListener l) 선택 범위의 변경이 통지되는 리스너를 리스트에 추가합니다.
void	addSelectionInterval (int index0, int index1) 선택 범위를, 현재의 선택 범위와 index0 이상 index1 아래의 인덱스가 가리키는 범위와의 화집합으로 변경합니다.
void	clearSelection () 선택 범위를 빈세트로 변경합니다.
Object	clone () 이 선택 모델의 복제를, 같은 선택 상태로 리턴합니다.
protected void	fireValueChanged (boolean isAdjusting) 일련의 조정이 종료한 것을 리스너에게 통지합니다.
protected void	fireValueChanged (int firstIndex, int lastIndex) firstIndex, lastIndex 간에 선택의 값이 변경된 것을 ListSelectionListeners에 통지합니다.
protected void	fireValueChanged (int firstIndex, int lastIndex, boolean isAdjusting)
int	getAnchorSelectionIndex () setSelectionInterval(), addSelectionInterval(), 또는 removeSelectionInterval()의 직전의 호출로부터, 최초의 인덱스 인수를 리턴합니다.
int	getLeadSelectionIndex () setSelectionInterval(), addSelectionInterval(), 또는 removeSelectionInterval()의 직전의 호출로부터, 2번째의 인덱스 인수를 리턴합니다.
<T extends EventListener > T[]	getListeners (Class <T> listenerType) 이 모델에 FooListener로 서 현재 등록되어 모든 객체의 배열을 리턴합니다.
ListSelectionListener []	getListSelectionListeners () 이 DefaultListSelectionModel에 등록되어 모든 리스트 선택 리스너의 배열을 리턴합니다.
int	getMaxSelectionIndex () 마지막에 선택된 인덱스를 돌려주는지, 선택 범위가 비어있는 경우에 -1를 리턴합니다.
int	getMinSelectionIndex () 최초로 선택된 인덱스를 돌려주는지, 선택 범위가 비어있는 경우에 -1를 리턴합니다.
int	getSelectionMode () 선택 모드를 리턴합니다.
boolean	getValueIsAdjusting () 값이 일련의 변경을 받고 있는 경우에 true를 리턴합니다.
void	insertIndexInterval (int index, int length, boolean before) 인덱스의 전 또는 다음에 시작되는 length 인덱스를 삽입합니다.
boolean	isLeadAnchorNotificationEnabled () leadAnchorNotificationEnabled 플래그의 값을 리턴합니다.
boolean	isSelectedIndex (int index) 지정의 인덱스가 선택되고 있는 경우에 true를 리턴합니다.
boolean	isSelectionEmpty () 인덱스가 선택되어 있지 않은 경우에 true를 리턴합니다.
void	moveLeadSelectionIndex (int leadIndex) 선두의 선택 인덱스를 설정해, 모든 선택치를 미변경대로 합니다.
void	removeIndexInterval (int index0, int index1) index0와 index1 사이 (이러한 값을 포함한다)의 인덱스를 선택 모델로부터 삭제합니다.
void	removeListSelectionListener (ListSelectionListener l) 선택 범위의 변경이 통지되는 리스너를 리스트로부터 삭제합니다.
void	removeSelectionInterval (int index0, int index1) 선택 범위를, 현재의 선택 범위와 index0 이상 index1 아래의 인덱스가 가리키는 범위와의 차이 집합으로 변경합니다.
void	setAnchorSelectionIndex (int anchorIndex) 엥커 선택 인덱스를 설정해, 모든 선택치를 변경하지 않는 채로 합니다.
void	setLeadAnchorNotificationEnabled (boolean flag) leadAnchorNotificationEnabled 플래그의 값을 설정합니다.
void	setLeadSelectionIndex (int leadIndex) 선두의 선택 인덱스를 설정해, 엥커와 새로운 선두의 사이의 값이, 모두 선택 또는 모두 선택 해제의 어느 쪽인지인 것을 보증합니다.
void	setSelectionInterval (int index0, int index1) 선택 범위를 index0 이상 index1 이하로 변경합니다.
void	setSelectionMode (int selectionMode) 선택 모드를 설정합니다.
void	setValueIsAdjusting (boolean isAdjusting) 이 프로퍼티는 모델의 값에 적용되고 있는 변경이 단일의 이벤트라고 생각되는 경우에 true가 됩니다.
String	toString () 이 객체의 프로퍼티를 표시 및 식별하는 캐릭터 라인을 리턴합니다.

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

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

필드의 상세

listenerList

protected EventListenerList  listenerList

leadAnchorNotificationEnabled

protected boolean leadAnchorNotificationEnabled

생성자 상세

DefaultListSelectionModel

public DefaultListSelectionModel()

메서드의 상세

getMinSelectionIndex

public int getMinSelectionIndex()

인터페이스 ListSelectionModel 기술:

최초로 선택된 인덱스를 돌려주는지, 선택 범위가 비어있는 경우에 -1를 리턴합니다.

정의:

인터페이스 ListSelectionModel 내의 getMinSelectionIndex

getMaxSelectionIndex

public int getMaxSelectionIndex()

인터페이스 ListSelectionModel 기술:

마지막에 선택된 인덱스를 돌려주는지, 선택 범위가 비어있는 경우에 -1를 리턴합니다.

정의:

인터페이스 ListSelectionModel 내의 getMaxSelectionIndex

getValueIsAdjusting

public boolean getValueIsAdjusting()

인터페이스 ListSelectionModel 기술:

값이 일련의 변경을 받고 있는 경우에 true를 리턴합니다.

정의:

인터페이스 ListSelectionModel 내의 getValueIsAdjusting

반환값:

값이 현재 조정되고 있는 경우는 true

관련 항목:

ListSelectionModel.setValueIsAdjusting(boolean)

getSelectionMode

public int getSelectionMode()

선택 모드를 리턴합니다.

정의:

인터페이스 ListSelectionModel 내의 getSelectionMode

반환값:

다음의 값의 어떤 것인가

• SINGLE_SELECTION
• SINGLE_INTERVAL_SELECTION
• MULTIPLE_INTERVAL_SELECTION

관련 항목:

getSelectionMode()

setSelectionMode

public void setSelectionMode(int selectionMode)

선택 모드를 설정합니다. 디폴트는 MULTIPLE_INTERVAL_SELECTION 입니다.

정의:

인터페이스 ListSelectionModel 내의 setSelectionMode

파라미터:

selectionMode - 다음의 3개의 값의 어떤 것인가

• SINGLE_SELECTION
• SINGLE_INTERVAL_SELECTION
• MULTIPLE_INTERVAL_SELECTION

예외:

IllegalArgumentException - selectionMode가 상기의 정당한 값의 리스트에 없는 경우

관련 항목:

setSelectionMode(int)

isSelectedIndex

public boolean isSelectedIndex(int index)

인터페이스 ListSelectionModel 기술:

지정의 인덱스가 선택되고 있는 경우에 true를 리턴합니다.

정의:

인터페이스 ListSelectionModel 내의 isSelectedIndex

isSelectionEmpty

public boolean isSelectionEmpty()

인터페이스 ListSelectionModel 기술:

인덱스가 선택되어 있지 않은 경우에 true를 리턴합니다.

정의:

인터페이스 ListSelectionModel 내의 isSelectionEmpty

addListSelectionListener

public void addListSelectionListener(ListSelectionListener  l)

인터페이스 ListSelectionModel 기술:

선택 범위의 변경이 통지되는 리스너를 리스트에 추가합니다.

정의:

인터페이스 ListSelectionModel 내의 addListSelectionListener

파라미터:

l - ListSelectionListener

관련 항목:

ListSelectionModel.removeListSelectionListener(javax.swing.event.ListSelectionListener), ListSelectionModel.setSelectionInterval(int, int), ListSelectionModel.addSelectionInterval(int, int), ListSelectionModel.removeSelectionInterval(int, int), ListSelectionModel.clearSelection(), ListSelectionModel.insertIndexInterval(int, int, boolean), ListSelectionModel.removeIndexInterval(int, int)

removeListSelectionListener

public void removeListSelectionListener(ListSelectionListener  l)

인터페이스 ListSelectionModel 기술:

선택 범위의 변경이 통지되는 리스너를 리스트로부터 삭제합니다.

정의:

인터페이스 ListSelectionModel 내의 removeListSelectionListener

파라미터:

l - ListSelectionListener

관련 항목:

ListSelectionModel.addListSelectionListener(javax.swing.event.ListSelectionListener)

getListSelectionListeners

public ListSelectionListener [] getListSelectionListeners()

이 DefaultListSelectionModel에 등록되어 모든 리스트 선택 리스너의 배열을 리턴합니다.

반환값:

이 모델의 모든 ListSelectionListener. 리스트 선택 리스너가 현재 등록되지 않은 경우는 비어있는 배열을 돌려주는

도입된 버전 :

1.4

관련 항목:

addListSelectionListener(javax.swing.event.ListSelectionListener), removeListSelectionListener(javax.swing.event.ListSelectionListener)

fireValueChanged

protected void fireValueChanged(boolean isAdjusting)

일련의 조정이 종료한 것을 리스너에게 통지합니다.

fireValueChanged

protected void fireValueChanged(int firstIndex,
                                int lastIndex)

firstIndex, lastIndex 간에 선택의 값이 변경된 것을 ListSelectionListeners에 통지합니다.

fireValueChanged

protected void fireValueChanged(int firstIndex,
                                int lastIndex,
                                boolean isAdjusting)

파라미터:

firstIndex - 범위의 선두의 인덱스

lastIndex - 범위의 마지막 인덱스

isAdjusting - 일련의 조정의 마지막 변경인 경우는 true

관련 항목:

EventListenerList

getListeners

public <T extends EventListener > T[] getListeners(Class <T> listenerType)

이 모델에 FooListener로 서 현재 등록되어 모든 객체의 배열을 리턴합니다. 이 FooListener는 addFooListener 메서드로 등록된 것입니다.

listenerType인수는 FooListener.class와 같은 클래스 리터럴로 지정할 수 있습니다. 예를 들어이 리스트 선택 리스너에 대한 DefaultListSelectionModel인스턴스 m 조회는 다음의 코드로 실시합니다.

ListSelectionListener[] lsls = (ListSelectionListener[])(m.getListeners(ListSelectionListener.class));

이러한 리스너가 없는 경우는 비어있는 배열을 리턴합니다.

파라미터:

listenerType - 요구되는 리스너의 형태. java.util.EventListener 하위 인터페이스를 지정

반환값:

이 모델에 FooListener로 서 등록되어 모든 객체의 배열. 리스너가 등록되지 않은 경우는 비어있는 배열을 돌려준다

예외:

ClassCastException - listenerType가 java.util.EventListener를 구현하는 클래스 또는 인터페이스를 지정하지 않는 경우

도입된 버전 :

1.3

관련 항목:

getListSelectionListeners()

setLeadAnchorNotificationEnabled

public void setLeadAnchorNotificationEnabled(boolean flag)

leadAnchorNotificationEnabled 플래그의 값을 설정합니다.

관련 항목:

isLeadAnchorNotificationEnabled()

isLeadAnchorNotificationEnabled

public boolean isLeadAnchorNotificationEnabled()

leadAnchorNotificationEnabled 플래그의 값을 리턴합니다. leadAnchorNotificationEnabled가 true인 경우, 선택 영역의 모든 변경에 가세해, 선두 인덱스와 엥커 인덱스에의 변경을 커버하는 경계를 사용해, 모델은 통지 이벤트를 생성합니다. 플래그를 false 로 설정하면, 마지막 변경 후에 선택 또는 선택 해제된 요소만을 포함하도록, 이벤트의 경계를 한정할 수 있습니다. 어느 방법에서도, 모델은 선두 변수와 엥커 변수를 내부적으로 계속 관리합니다. 디폴트는 true 입니다.

주: 선두 또는 엥커는 선택 영역으로 변경을 더하지 않아도 변경할 수 있습니다. 이러한 변경의 통지는 뷰내에서 새로운 선두나 엥커를 갱신할 필요가 있는 경우 등에 중요합니다. 따라서, 기본값을 변경할 때는 잘 주의해 주세요.

반환값:

leadAnchorNotificationEnabled 플래그의 값

관련 항목:

setLeadAnchorNotificationEnabled(boolean)

clearSelection

public void clearSelection()

인터페이스 ListSelectionModel 기술:

선택 범위를 빈세트로 변경합니다. 이것에 의해 현재의 선택 범위가 변경되는 경우에는 각 ListSelectionListener에 통지합니다.

정의:

인터페이스 ListSelectionModel 내의 clearSelection

관련 항목:

ListSelectionModel.addListSelectionListener(javax.swing.event.ListSelectionListener)

setSelectionInterval

public void setSelectionInterval(int index0,
                                 int index1)

인터페이스 ListSelectionModel 기술:

선택 범위를 index0 이상 index1 이하로 변경합니다. 이것에 의해 현재의 선택 범위가 변경되는 경우에는 각 ListSelectionListener에 통지합니다. 다만, index0는 index1 이하가 아니어도 괜찮습니다.

정의:

인터페이스 ListSelectionModel 내의 setSelectionInterval

파라미터:

index0 - 구간의 한편의 구석의 값

index1 - 구간의 한편의 구석의 값

관련 항목:

ListSelectionModel.addListSelectionListener(javax.swing.event.ListSelectionListener)

addSelectionInterval

public void addSelectionInterval(int index0,
                                 int index1)

인터페이스 ListSelectionModel 기술:

선택 범위를, 현재의 선택 범위와 index0 이상 index1 아래의 인덱스가 가리키는 범위와의 화집합으로 변경합니다. 이것에 의해 현재의 선택 범위가 변경되는 경우에는 각 ListSelectionListener에 통지합니다. 다만, index0는 index1 이하가 아니어도 괜찮습니다.

정의:

인터페이스 ListSelectionModel 내의 addSelectionInterval

파라미터:

index0 - 구간의 한편의 구석의 값

index1 - 구간의 한편의 구석의 값

관련 항목:

ListSelectionModel.addListSelectionListener(javax.swing.event.ListSelectionListener)

removeSelectionInterval

public void removeSelectionInterval(int index0,
                                    int index1)

인터페이스 ListSelectionModel 기술:

선택 범위를, 현재의 선택 범위와 index0 이상 index1 아래의 인덱스가 가리키는 범위와의 차이 집합으로 변경합니다. 이것에 의해 현재의 선택 범위가 변경되는 경우에는 각 ListSelectionListener에 통지합니다. 다만, index0는 index1 이하가 아니어도 괜찮습니다.

정의:

인터페이스 ListSelectionModel 내의 removeSelectionInterval

파라미터:

index0 - 구간의 한편의 구석의 값

index1 - 구간의 한편의 구석의 값

관련 항목:

ListSelectionModel.addListSelectionListener(javax.swing.event.ListSelectionListener)

insertIndexInterval

public void insertIndexInterval(int index,
                                int length,
                                boolean before)

인덱스의 전 또는 다음에 시작되는 length 인덱스를 삽입합니다. 인덱스의 값자체가 선택되어 선택 모드가 SINGLE_SELECTION가 아닌 경우는 새롭게 삽입된 항목을 모두 선택이 끝난 상태로서 설정해, 그렇지 않은 경우는 미선택대로 합니다. 이 메서드는 보통, 선택 모델을 데이터 모델내의 대응하는 변경에 동기 시키기 위해서 호출합니다.

정의:

인터페이스 ListSelectionModel 내의 insertIndexInterval

removeIndexInterval

public void removeIndexInterval(int index0,
                                int index1)

index0와 index1 사이 (이러한 값을 포함한다)의 인덱스를 선택 모델로부터 삭제합니다. 이것은 보통, 선택 모델을 데이터 모델내의 대응하는 변경에 동기 시키기 위해서 호출합니다. index0는 다른 경우와 같게, index1 이하일 필요는 없습니다.

정의:

인터페이스 ListSelectionModel 내의 removeIndexInterval

setValueIsAdjusting

public void setValueIsAdjusting(boolean isAdjusting)

인터페이스 ListSelectionModel 기술:

이 프로퍼티는 모델의 값에 적용되고 있는 변경이 단일의 이벤트라고 생각되는 경우에 true가 됩니다. 예를 들어 모델이 사용자 의 드래그에 응해 갱신되고 있는 경우, valueIsAdjusting 프로퍼티의 값은 드래그가 개시되었을 때에 true, 드래그가 종료했을 때에 false 로 설정됩니다. 항상 중간의 값을 모두 처리하는 것이 아니라, 변경이 파이나라이즈 되었을 경우에만, 이 프로퍼티에 의해 리스너의 갱신이 가능하게 됩니다.

정의:

인터페이스 ListSelectionModel 내의 setValueIsAdjusting

파라미터:

isAdjusting - 프로퍼티의 새로운 값

관련 항목:

ListSelectionModel.getValueIsAdjusting()

toString

public String  toString()

이 객체의 프로퍼티를 표시 및 식별하는 캐릭터 라인을 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 객체의 String 표현

clone

public Object  clone()
             throws CloneNotSupportedException 

이 선택 모델의 복제를, 같은 선택 상태로 리턴합니다. listenerList는 복제되지 않습니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 인스턴스의 복제

예외:

CloneNotSupportedException - 선택 모델이, (a) Cloneable 인터페이스를 구현하지 않고, 또 (b) clone 메서드를 정의하지 않는 경우

관련 항목:

Cloneable

getAnchorSelectionIndex

public int getAnchorSelectionIndex()

인터페이스 ListSelectionModel 기술:

setSelectionInterval(), addSelectionInterval(), 또는 removeSelectionInterval()의 직전의 호출로부터, 최초의 인덱스 인수를 리턴합니다. 직전의 index0가 「엥커」, 직전의 index1가 「리드」라고 보여집니다. 인터페이스에 따라서는 이러한 인덱스가 특별히 표시됩니다. 예를 들어 Windows95 에서는 리드 인덱스가 노란 점선의 윤곽으로 표시됩니다.

정의:

인터페이스 ListSelectionModel 내의 getAnchorSelectionIndex

관련 항목:

ListSelectionModel.getLeadSelectionIndex(), ListSelectionModel.setSelectionInterval(int, int), ListSelectionModel.addSelectionInterval(int, int)

getLeadSelectionIndex

public int getLeadSelectionIndex()

인터페이스 ListSelectionModel 기술:

setSelectionInterval(), addSelectionInterval(), 또는 removeSelectionInterval()의 직전의 호출로부터, 2번째의 인덱스 인수를 리턴합니다.

정의:

인터페이스 ListSelectionModel 내의 getLeadSelectionIndex

관련 항목:

ListSelectionModel.getAnchorSelectionIndex(), ListSelectionModel.setSelectionInterval(int, int), ListSelectionModel.addSelectionInterval(int, int)

setAnchorSelectionIndex

public void setAnchorSelectionIndex(int anchorIndex)

엥커 선택 인덱스를 설정해, 모든 선택치를 변경하지 않는 채로 합니다. leadAnchorNotificationEnabled가 true인 경우, 신구의 엥커 셀을 대상으로 하는 통지를 송신합니다.

정의:

인터페이스 ListSelectionModel 내의 setAnchorSelectionIndex

관련 항목:

getAnchorSelectionIndex(), setLeadSelectionIndex(int)

moveLeadSelectionIndex

public void moveLeadSelectionIndex(int leadIndex)

선두의 선택 인덱스를 설정해, 모든 선택치를 미변경대로 합니다. leadAnchorNotificationEnabled가 true인 경우, 신구의 선두 셀을 대상으로 하는 통지를 송신합니다.

파라미터:

leadIndex - 새로운 선두의 선택 인덱스

도입된 버전 :

1.5

관련 항목:

setAnchorSelectionIndex(int), setLeadSelectionIndex(int), getLeadSelectionIndex()

setLeadSelectionIndex

public void setLeadSelectionIndex(int leadIndex)

선두의 선택 인덱스를 설정해, 엥커와 새로운 선두의 사이의 값이, 모두 선택 또는 모두 선택 해제의 어느 쪽인지인 것을 보증합니다. 엥커 인덱스의 값을 선택하면,[anchor, oldLeadIndex] 범위내의 모든 값을 우선 클리어 하고 나서,[anchor, newLeadIndex] 범위내의 모든 값을 선택합니다. oldLeadIndex는 낡은 leadIndex를 나타내, newLeadIndex는 새로운 leadIndex를 나타냅니다.

엥커 인덱스의 값이 선택되어 있지 않은 경우, 같은 것을 반대로 실시합니다. 즉 낡은 범위의 값을 선택하고 나서 새로운 범위의 값을 선택 해제합니다.

이 변경의 이벤트를 1개 생성해, 모든 리스너에게 통지합니다. 이 이벤트내에서 최소한의 경계를 생성하기 위해, 1회 의 패스로 조작을 실시합니다. 이 방법에서는 브로드캐스트 된 ListSelectionEvent 내의 선두와 말미의 인덱스는 이 메서드에 의해 실제로 값이 변경된 셀을 참조합니다. 이 조작을 2회의 스텝에서 처리하면, 선택 상태의 효과는 같아도, 2개의 이벤트가 생성되어 버립니다. 게다가 다음에 설정되기 때문에인 만큼 클리어 되는 셀이 발생해 버려, 변경 대상의 값에 관련해 조작되는 영역이 넓어집니다.

이 메서드를 UI 클래스의 mouseDragged 메서드로 사용하면, 선택을 확장할 수 있습니다.

정의:

인터페이스 ListSelectionModel 내의 setLeadSelectionIndex

관련 항목:

getLeadSelectionIndex(), setAnchorSelectionIndex(int)