javax.swing
인터페이스 ListSelectionModel

기존의 구현 클래스의 일람:

DefaultListSelectionModel

public interface ListSelectionModel

고정의 인덱스를 가지는 값의 리스트를 표시하는 컴퍼넌트의, 현재의 선택 상태를 나타냅니다. 선택 상태는 구간세트로서 모델화 되어 각 구간은 선택된 리스트 요소의 연속 범위를 나타냅니다. 선택된 구간세트를 변경하는 메소드는 모두, 닫은 구간을 나타내는 index0 와 index1 를 1 조와 하는 인덱스를 취합니다. 즉, 구간에는 index0 와 index1 의 양쪽 모두가 포함됩니다.

관련 항목:

DefaultListSelectionModel

필드의 개요

static int	MULTIPLE_INTERVAL_SELECTION selectionMode 프로퍼티의 값입니다.
static int	SINGLE_INTERVAL_SELECTION selectionMode 프로퍼티의 값입니다.
static int	SINGLE_SELECTION selectionMode 프로퍼티의 값입니다.

메소드의 개요

void	addListSelectionListener (ListSelectionListener x) 선택 범위의 변경이 통지되는 청취자를 리스트에 추가합니다.
void	addSelectionInterval (int index0, int index1) 선택 범위를, 현재의 선택 범위와 index0 이상 index1 이하의 인덱스가 가리키는 범위와의 화집합으로 변경합니다.
void	clearSelection () 선택 범위를 빈 상태(empty)세트로 변경합니다.
int	getAnchorSelectionIndex () setSelectionInterval(), addSelectionInterval(), 또는 removeSelectionInterval()의 직전의 호출로부터, 최초의 인덱스 인수를 돌려줍니다.
int	getLeadSelectionIndex () setSelectionInterval(), addSelectionInterval(), 또는 removeSelectionInterval()의 직전의 호출로부터, 2 번째의 인덱스 인수를 돌려줍니다.
int	getMaxSelectionIndex () 마지막에 선택된 인덱스를 돌려주는지, 선택 범위가 빈 상태(empty)의 경우에 -1 를 돌려줍니다.
int	getMinSelectionIndex () 최초로 선택된 인덱스를 돌려주는지, 선택 범위가 빈 상태(empty)의 경우에 -1 를 돌려줍니다.
int	getSelectionMode () 현재의 선택 모드를 돌려줍니다.
boolean	getValueIsAdjusting () 선택으로 일련의 변경을 적용중인 경우에 true 를 돌려줍니다.
void	insertIndexInterval (int index, int length, boolean before) index 의 전/후부터 시작되는 length 인덱스를 삽입합니다.
boolean	isSelectedIndex (int index) 지정의 인덱스가 선택되고 있는 경우에 true 를 돌려줍니다.
boolean	isSelectionEmpty () 인덱스가 선택되어 있지 않은 경우에 true 를 돌려줍니다.
void	removeIndexInterval (int index0, int index1) 선택 모델로부터, index0 와 index1 를 양단으로서 포함한 구간의 인덱스를 삭제합니다.
void	removeListSelectionListener (ListSelectionListener x) 선택 범위의 변경이 통지되는 청취자를 리스트로부터 삭제합니다.
void	removeSelectionInterval (int index0, int index1) 선택 범위를, 현재의 선택 범위와 index0 이상 index1 이하의 인덱스가 가리키는 범위와의 차이 집합으로 변경합니다.
void	setAnchorSelectionIndex (int index) 선택 범위의 엥커 인덱스를 설정합니다.
void	setLeadSelectionIndex (int index) 선택 범위의 리드 인덱스를 설정합니다.
void	setSelectionInterval (int index0, int index1) 선택 범위를 index0 이상 index1 이하로 변경합니다.
void	setSelectionMode (int selectionMode) 선택 모드를 설정합니다.
void	setValueIsAdjusting (boolean valueIsAdjusting) 선택에 대한 복수의 변경을 1 개의 변경의 일부이다고 볼지 어떨지를 지정하는,valueIsAdjusting 프로퍼티을 설정합니다.

필드의 상세

SINGLE_SELECTION

static final int SINGLE_SELECTION

selectionMode 프로퍼티의 값입니다. 리스트 인덱스를 1 회에 1 개 선택합니다.

관련 항목:

setSelectionMode(int) , 정수 필드치

SINGLE_INTERVAL_SELECTION

static final int SINGLE_INTERVAL_SELECTION

selectionMode 프로퍼티의 값입니다. 인덱스의 연속 범위를 1 회에 1 개 선택합니다.

관련 항목:

setSelectionMode(int) , 정수 필드치

MULTIPLE_INTERVAL_SELECTION

static final int MULTIPLE_INTERVAL_SELECTION

selectionMode 프로퍼티의 값입니다. 인덱스의 연속 범위를 1 회에 1 개 이상 선택합니다.

관련 항목:

setSelectionMode(int) , 정수 필드치

메소드의 상세

setSelectionInterval

void setSelectionInterval(int index0,
                          int index1)

선택 범위를 index0 이상 index1 이하로 변경합니다. index0 는 index1 이하가 아니어도 괜찮습니다.

SINGLE_SELECTION 선택 모드에서는, 2 번째의 인덱스만이 사용됩니다.

이것에 의해 현재의 선택 범위가 변경되는 경우에는, 각 ListSelectionListener 으로 변경이 통지됩니다.

파라미터:

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

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

관련 항목:

addListSelectionListener(javax.swing.event.ListSelectionListener)

addSelectionInterval

void addSelectionInterval(int index0,
                          int index1)

선택 범위를, 현재의 선택 범위와 index0 이상 index1 이하의 인덱스가 가리키는 범위와의 화집합으로 변경합니다. index0 는 index1 이하가 아니어도 괜찮습니다.

SINGLE_SELECTION 선택 모드에서는, 이것은 setSelectionInterval 의 호출과 동등해, 2 번째의 인덱스만이 사용됩니다. SINGLE_INTERVAL_SELECTION 선택 모드에서는, 이 메소드는, 지정된 간격이 기존의 선택 범위에 인접하고 있거나 오버랩 하고 있거나 하지 않는 한 setSelectionInterval 와 같게 동작하기 위해(때문에), 선택 범위를 확장하는 목적으로 사용할 수 있습니다.

이것에 의해 현재의 선택 범위가 변경되는 경우에는, 각 ListSelectionListener 으로 변경이 통지됩니다.

파라미터:

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

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

관련 항목:

addListSelectionListener(javax.swing.event.ListSelectionListener) , setSelectionInterval(int, int)

removeSelectionInterval

void removeSelectionInterval(int index0,
                             int index1)

선택 범위를, 현재의 선택 범위와 index0 이상 index1 이하의 인덱스가 가리키는 범위와의 차이 집합으로 변경합니다. index0 는 index1 이하가 아니어도 괜찮습니다.

SINGLE_INTERVAL_SELECTION 선택 모드에서는, 삭제에 의해 2 개의 섹션이 생성되는 경우, 삭제 범위가 선택 범위의 말미 (값이 큰 편의 구석)까지 확장됩니다. 예를 들어 선택 범위가 0 ~ 10 인 경우, 사용자가 임의의 순서로 인덱스 5, 6 을 지정하면(자), 결과적으로 얻을 수 있는 선택 범위는 0 ~ 4 가 됩니다.

이것에 의해 현재의 선택 범위가 변경되는 경우에는, 각 ListSelectionListener 으로 변경이 통지됩니다.

파라미터:

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

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

관련 항목:

addListSelectionListener(javax.swing.event.ListSelectionListener)

getMinSelectionIndex

int getMinSelectionIndex()

최초로 선택된 인덱스를 돌려주는지, 선택 범위가 빈 상태(empty)의 경우에 -1 를 돌려줍니다.

getMaxSelectionIndex

int getMaxSelectionIndex()

마지막에 선택된 인덱스를 돌려주는지, 선택 범위가 빈 상태(empty)의 경우에 -1 를 돌려줍니다.

isSelectedIndex

boolean isSelectedIndex(int index)

지정의 인덱스가 선택되고 있는 경우에 true 를 돌려줍니다.

getAnchorSelectionIndex

int getAnchorSelectionIndex()

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

관련 항목:

getLeadSelectionIndex() , setSelectionInterval(int, int) , addSelectionInterval(int, int)

setAnchorSelectionIndex

void setAnchorSelectionIndex(int index)

선택 범위의 엥커 인덱스를 설정합니다.

관련 항목:

getAnchorSelectionIndex()

getLeadSelectionIndex

int getLeadSelectionIndex()

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

관련 항목:

getAnchorSelectionIndex() , setSelectionInterval(int, int) , addSelectionInterval(int, int)

setLeadSelectionIndex

void setLeadSelectionIndex(int index)

선택 범위의 리드 인덱스를 설정합니다.

관련 항목:

getLeadSelectionIndex()

clearSelection

void clearSelection()

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

관련 항목:

addListSelectionListener(javax.swing.event.ListSelectionListener)

isSelectionEmpty

boolean isSelectionEmpty()

인덱스가 선택되어 있지 않은 경우에 true 를 돌려줍니다.

insertIndexInterval

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

index 의 전/후부터 시작되는 length 인덱스를 삽입합니다. 일반적으로, 이 메소드는, 데이터 모델내의 대응하는 변경에 선택 모델을 동기 시키기 위해서(때문에) 불려 갑니다.

removeIndexInterval

void removeIndexInterval(int index0,
                         int index1)

선택 모델로부터, index0 와 index1 를 양단으로서 포함한 구간의 인덱스를 삭제합니다. 일반적으로, 이 메소드는, 데이터 모델내의 대응하는 변경에 선택 모델을 동기 시키기 위해서(때문에) 불려 갑니다.

setValueIsAdjusting

void setValueIsAdjusting(boolean valueIsAdjusting)

선택에 대한 복수의 변경을 1 개의 변경의 일부이다고 볼지 어떨지를 지정하는,valueIsAdjusting 프로퍼티을 설정합니다. 이 프로퍼티의 값을 사용해, 생성된 ListSelectionEvent 의 valueIsAdjusting 프로퍼티을 초기화할 수 있습니다.

예를 들어, 사용자의 드래그에 응해 선택이 갱신되는 경우, 이 프로퍼티의 값은, 드래그의 개시시에는 true, 종료시에는 false 로 설정할 수 있습니다. 드래그중, 청취자는,valueIsAdjusting 프로퍼티의 값이 true 로 설정된 이벤트를 수신합니다. 드래그의 종료시, 변경이 finalize 되면(자), 청취자가 수신하는 이벤트의 프로퍼티의 값은 false 가 됩니다. 청취자는, 변경이 finalize 되었을 때에만 갱신을 실행하고 싶은 경우, 이 패턴을 사용할 수 있습니다.

이 프로퍼티의 값을 true 로 설정하면(자), 1 회의 변경의 일부라고 보여지는 일련의 변경이 스타트 합니다. 프로퍼티의 값을 false 에 되돌리면(자), 선택 전체의 변경 (선택이 있었을 경우)을 기술하는,valueIsAdjusting 프로퍼티의 값이 false 로 설정된 이벤트가 송신됩니다.

파라미터:

valueIsAdjusting - 프로퍼티의 변경 후의 값

관련 항목:

getValueIsAdjusting() , ListSelectionEvent.getValueIsAdjusting()

getValueIsAdjusting

boolean getValueIsAdjusting()

선택으로 일련의 변경을 적용중인 경우에 true 를 돌려줍니다.

반환값:

선택으로 일련의 변경을 적용중인 경우는 true

관련 항목:

setValueIsAdjusting(boolean)

setSelectionMode

void setSelectionMode(int selectionMode)

선택 모드를 설정합니다. 사용 가능한 선택 모드는, 다음의 리스트대로입니다.

• ListSelectionModel.SINGLE_SELECTION - 1 회에 1 개의 리스트 인덱스만을 선택할 수 있습니다. 이 모드에서는,setSelectionInterval 메소드와 addSelectionInterval 메소드는 동등하고, 어느쪽이나 현재의 선택을, 2 번째의 인수로 나타내지는 인덱스 ( 「리드 인덱스」)로 옮겨놓습니다.
• ListSelectionModel.SINGLE_INTERVAL_SELECTION - 1 회에 1 개의 연속 구간만을 선택할 수 있습니다. 이 모드에서는,addSelectionInterval 은, 지정된 간격이 기존의 선택 범위에 인접하고 있거나 오버랩 하고 있거나 하지 않는 한 setSelectionInterval 와 같게 동작하기 위해(때문에) (현재의 선택을 옮겨놓는다), 선택 범위를 확장하는 목적으로 사용할 수 있습니다.
• ListSelectionModel.MULTIPLE_INTERVAL_SELECTION - 이 모드에서는, 선택 대상으로 제한은 없습니다.

예외:

IllegalArgumentException - 허가된 선택 모드가 아닌 경우

관련 항목:

getSelectionMode()

getSelectionMode

int getSelectionMode()

현재의 선택 모드를 돌려줍니다.

반환값:

현재의 선택 모드

관련 항목:

setSelectionMode(int)

addListSelectionListener

void addListSelectionListener(ListSelectionListener  x)

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

파라미터:

x - ListSelectionListener

관련 항목:

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

removeListSelectionListener

void removeListSelectionListener(ListSelectionListener  x)

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

파라미터:

x - ListSelectionListener

관련 항목:

addListSelectionListener(javax.swing.event.ListSelectionListener)