javax.swing.table
클래스 DefaultTableColumnModel

java.lang.Object 
  javax.swing.table.DefaultTableColumnModel

모든 구현된 인터페이스:

PropertyChangeListener , Serializable , EventListener , ListSelectionListener , TableColumnModel

public class DefaultTableColumnModel
extends Object 
implements TableColumnModel , PropertyChangeListener , ListSelectionListener , Serializable 

JTable 의 표준의 열핸들러입니다.

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

관련 항목:

JTable

필드의 개요

protected ChangeEvent	changeEvent 변경 이벤트입니다 (1 개(살)만 필요).
protected int	columnMargin 각 열의 사이의 폭마진입니다.
protected boolean	columnSelectionAllowed 이 열모델로 허가되는 열의 선택입니다.
protected EventListenerList	listenerList TableColumnModelListener 의 리스트입니다.
protected ListSelectionModel	selectionModel 열선택의 이력을 기록하기 위한 모델입니다.
protected Vector <TableColumn >	tableColumns 이 모델의 TableColumn 객체의 배열입니다.
protected int	totalColumnWidth 모든 열의 폭을 조합한 합계의 로컬 캐쉬입니다.

생성자 의 개요

DefaultTableColumnModel ()
디폴트의 테이블열모델을 작성합니다.

메소드의 개요

void	addColumn (TableColumn aColumn) tableColumns 배열의 마지막에 aColumn 를 추가합니다.
void	addColumnModelListener (TableColumnModelListener x) 테이블열모델 이벤트용의 청취자를 추가합니다.
protected ListSelectionModel	createSelectionModel () 신규의 리스트 선택의 디폴트 모델을 작성합니다.
protected void	fireColumnAdded (TableColumnModelEvent e) 통지의 전달 대상을, 지정된 이벤트형으로 등록한 모든 청취자에게 통지합니다.
protected void	fireColumnMarginChanged () 통지의 전달 대상을, 지정된 이벤트형으로 등록한 모든 청취자에게 통지합니다.
protected void	fireColumnMoved (TableColumnModelEvent e) 통지의 전달 대상을, 지정된 이벤트형으로 등록한 모든 청취자에게 통지합니다.
protected void	fireColumnRemoved (TableColumnModelEvent e) 통지의 전달 대상을, 지정된 이벤트형으로 등록한 모든 청취자에게 통지합니다.
protected void	fireColumnSelectionChanged (ListSelectionEvent e) 통지의 전달 대상을, 지정된 이벤트형으로 등록한 모든 청취자에게 통지합니다.
TableColumn	getColumn (int columnIndex) columnIndex 에 있는 열의 TableColumn 객체를 돌려줍니다.
int	getColumnCount () 이 tableColumns 배열의 렬수를 돌려줍니다.
int	getColumnIndex (Object identifier) equals 를 사용해 비교했을 때에 식별자가 identifier 과 동일한 tableColumns 배열내의 최초의 열의 인덱스를 돌려줍니다.
int	getColumnIndexAtX (int x) x 위치에 있는 열의 인덱스를 돌려줍니다.
int	getColumnMargin () TableColumn 의 폭마진을 돌려줍니다.
TableColumnModelListener []	getColumnModelListeners () 이 모델에 등록된, 모든 열모델 청취자로부터 되는 배열을 돌려줍니다.
Enumeration <TableColumn >	getColumns () 모델의 모든 열의 Enumeration 를 돌려줍니다.
boolean	getColumnSelectionAllowed () 열의 선택이 허가되고 있는 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다.
<T extends EventListener > T[]	getListeners (Class <T> listenerType) 이 모델에 FooListener 로서 현재 등록되어 모든 객체의 배열을 돌려줍니다.
int	getSelectedColumnCount () 선택되고 있는 열의 수를 돌려줍니다.
int[]	getSelectedColumns () 선택된 열의 배열을 돌려줍니다.
ListSelectionModel	getSelectionModel () 열선택 상태를 유지하는데 사용하는 ListSelectionModel 를 돌려줍니다.
int	getTotalColumnWidth () 모든 열의 폭을 조합한 합계를 돌려줍니다.
void	moveColumn (int columnIndex, int newIndex) columnIndex 에 있는 열 및 헤더를 newIndex 로 이동합니다.
void	propertyChange (PropertyChangeEvent evt) 프로퍼티 변경 청취자 변경 메소드입니다.
protected void	recalcWidthCache () 모든 열의 폭을 조합한 합계를 재계산합니다.
void	removeColumn (TableColumn column) tableColumns 배열로부터 column 를 삭제합니다.
void	removeColumnModelListener (TableColumnModelListener x) 테이블열모델 이벤트용의 청취자를 삭제합니다.
void	setColumnMargin (int newMargin) 열마진을 newMargin 로 설정합니다.
void	setColumnSelectionAllowed (boolean flag) 열의 선택이 허가되고 있는지 어떤지를 설정합니다.
void	setSelectionModel (ListSelectionModel newModel) 이 TableColumnModel 의 선택 모델을 newModel 로 설정해, 새로운 선택 모델로부터의 청취자 통지를 수신하도록(듯이) 등록합니다.
void	valueChanged (ListSelectionEvent e) ListSelectionListener 는, 열의 선택이 변경되면(자),ListSelectionEvent 를 전송 합니다.

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

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

필드의 상세

tableColumns

protected Vector <TableColumn > tableColumns

이 모델의 TableColumn 객체의 배열입니다.

selectionModel

protected ListSelectionModel  selectionModel

열선택의 이력을 기록하기 위한 모델입니다.

columnMargin

protected int columnMargin

각 열의 사이의 폭마진입니다.

listenerList

protected EventListenerList  listenerList

TableColumnModelListener 의 리스트입니다.

changeEvent

protected transient ChangeEvent  changeEvent

변경 이벤트입니다 (1 개(살)만 필요).

columnSelectionAllowed

protected boolean columnSelectionAllowed

이 열모델로 허가되는 열의 선택입니다.

totalColumnWidth

protected int totalColumnWidth

모든 열의 폭을 조합한 합계의 로컬 캐쉬입니다.

생성자 의 상세

DefaultTableColumnModel

public DefaultTableColumnModel()

디폴트의 테이블열모델을 작성합니다.

메소드의 상세

addColumn

public void addColumn(TableColumn  aColumn)

tableColumns 배열의 마지막에 aColumn 를 추가합니다. 또, 이 메소드는 그 청취자에게 columnAdded 이벤트를 보냅니다.

정의:

인터페이스 TableColumnModel 내의 addColumn

파라미터:

aColumn - 추가되는 TableColumn

예외:

IllegalArgumentException - aColumn 가 null 의 경우

관련 항목:

removeColumn(javax.swing.table.TableColumn)

removeColumn

public void removeColumn(TableColumn  column)

tableColumns 배열로부터 column 를 삭제합니다. column 가 테이블의 열리스트에 없는 경우, 이 메소드는 처리를 하지 않습니다. tile 는, 헤더 및 테이블의 뷰를 사이즈 변경하기 위해서 불려 갑니다. 또, 이 메소드는 그 청취자에게 columnRemoved 이벤트를 보냅니다.

정의:

인터페이스 TableColumnModel 내의 removeColumn

파라미터:

column - 삭제되는 TableColumn

관련 항목:

addColumn(javax.swing.table.TableColumn)

moveColumn

public void moveColumn(int columnIndex,
                       int newIndex)

columnIndex 에 있는 열 및 헤더를 newIndex 로 이동합니다. 이동전은 columnIndex 에 있던 열은 newIndex 에 놓여집니다. 이 장소를 만들기 (위해)때문에, 지금까지 newIndex 에 있던 열은, 왼쪽 또는 오른쪽으로 이동합니다. columnIndex 와 newIndex 가 같은 경우, 열은 이동하지 않습니다. 또, 이 메소드는 그 청취자에게 columnMoved 이벤트를 보냅니다.

정의:

인터페이스 TableColumnModel 내의 moveColumn

파라미터:

columnIndex - 이동하는 열의 인덱스

newIndex - 열을 이동하는 신규 인덱스

예외:

IllegalArgumentException - column 또는 newIndex 가 유효한 범위에 없는 경우

setColumnMargin

public void setColumnMargin(int newMargin)

열마진을 newMargin 로 설정합니다. 또, 이 메소드는 그 청취자에게 columnMarginChanged 이벤트를 보냅니다.

정의:

인터페이스 TableColumnModel 내의 setColumnMargin

파라미터:

newMargin - 픽셀 단위의 신규의 마진폭

관련 항목:

getColumnMargin() , getTotalColumnWidth()

getColumnCount

public int getColumnCount()

이 tableColumns 배열의 렬수를 돌려줍니다.

정의:

인터페이스 TableColumnModel 내의 getColumnCount

반환값:

이 tableColumns 배열의 렬수

관련 항목:

getColumns()

getColumns

public Enumeration <TableColumn > getColumns()

모델의 모든 열의 Enumeration 를 돌려줍니다.

정의:

인터페이스 TableColumnModel 내의 getColumns

반환값:

모델의 열의 Enumeration

getColumnIndex

public int getColumnIndex(Object  identifier)

equals 를 사용해 비교했을 때에 식별자가 identifier 과 동일한 tableColumns 배열내의 최초의 열의 인덱스를 돌려줍니다.

정의:

인터페이스 TableColumnModel 내의 getColumnIndex

파라미터:

identifier - 식별자 객체

반환값:

식별자가 identifier 와 동일하다 tableColumns 배열내의 최초의 열의 인덱스

예외:

IllegalArgumentException - identifier 가 null 의 경우, 또는 이 identifier 를 가지고 있는 TableColumn 가 없는 경우

관련 항목:

getColumn(int)

getColumn

public TableColumn  getColumn(int columnIndex)

columnIndex 에 있는 열의 TableColumn 객체를 돌려줍니다.

정의:

인터페이스 TableColumnModel 내의 getColumn

파라미터:

columnIndex - 요구하는 열의 인덱스

반환값:

columnIndex 에 있는 열의 TableColumn 객체

getColumnMargin

public int getColumnMargin()

TableColumn 의 폭마진을 돌려줍니다. 디폴트의 columnMargin 는 1 입니다.

정의:

인터페이스 TableColumnModel 내의 getColumnMargin

반환값:

TableColumn 의 최대폭

관련 항목:

setColumnMargin(int)

getColumnIndexAtX

public int getColumnIndexAtX(int x)

x 위치에 있는 열의 인덱스를 돌려줍니다. 이 포인트가 열의 범위외에 있는 경우는 -1 을 돌려줍니다. Swing 의 분리 가능한 모델 아키텍쳐(architecture)를 사용하고 있는 경우, TableColumnModel 는 테이블열이 실제로 화면상에서 어떻게 표시되는지를 인식하지 않습니다. 열의 시각적 표현은, 이 모델 (일반적으로은 JTable)을 사용하는 뷰와 콘트롤러 객체에 의해 정해집니다. 뷰와 콘트롤러는, 반드시 왼쪽에서 오른쪽이라고 하는 순으로 열을 표시할 필요는 없습니다. 예를 들어, 로케일의 설정에 대응시키기 위해서(때문에) 금방 다른 곳으로 열을 표시하거나 사용자의 요구에 따라 일부의 열을 숨기거나라고 했던 것(적)이 가능합니다. 모델에서는, 화면상에서 열이 어떻게 배치될지를 모르기 때문에, 지정된 xPosition 는, 2D 그래픽스 공간의 좌표로 간주해지지 않습니다. 대신에, 모델의 최초의 열로부터 시작되는 폭으로 간주해집니다. 2D 공간에서 지정된 X 좌표의 열인덱스가 필요한 경우는,xPosition 는 아니고 JTable.columnAtPoint 를 사용합니다.

정의:

인터페이스 TableColumnModel 내의 getColumnIndexAtX

파라미터:

x - 대상의 수평 방향의 위치

반환값:

열의 인덱스. 열이 발견되지 않는 경우는 -1

관련 항목:

JTable.columnAtPoint(java.awt.Point)

getTotalColumnWidth

public int getTotalColumnWidth()

모든 열의 폭을 조합한 합계를 돌려줍니다.

정의:

인터페이스 TableColumnModel 내의 getTotalColumnWidth

반환값:

totalColumnWidth 프로퍼티

setSelectionModel

public void setSelectionModel(ListSelectionModel  newModel)

이 TableColumnModel 의 선택 모델을 newModel 로 설정해, 새로운 선택 모델로부터의 청취자 통지를 수신하도록(듯이) 등록합니다. newModel 가 null 의 경우, 예외가 throw 됩니다.

정의:

인터페이스 TableColumnModel 내의 setSelectionModel

파라미터:

newModel - 새로운 선택 모델

예외:

IllegalArgumentException - newModel 가 null 의 경우

관련 항목:

getSelectionModel()

getSelectionModel

public ListSelectionModel  getSelectionModel()

열선택 상태를 유지하는데 사용하는 ListSelectionModel 를 돌려줍니다.

정의:

인터페이스 TableColumnModel 내의 getSelectionModel

반환값:

열의 선택 상태를 제공하는 객체. 또는 행의 선택이 허가되어 있지 않은 경우는 null

관련 항목:

setSelectionModel(javax.swing.ListSelectionModel)

setColumnSelectionAllowed

public void setColumnSelectionAllowed(boolean flag)

열의 선택이 허가되고 있는지 어떤지를 설정합니다. 디폴트는 false 입니다.

정의:

인터페이스 TableColumnModel 내의 setColumnSelectionAllowed

파라미터:

flag - 열의 선택이 허가되고 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

TableColumnModel.getColumnSelectionAllowed()

getColumnSelectionAllowed

public boolean getColumnSelectionAllowed()

열의 선택이 허가되고 있는 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다. 디폴트는 false 입니다.

정의:

인터페이스 TableColumnModel 내의 getColumnSelectionAllowed

반환값:

columnSelectionAllowed 프로퍼티

관련 항목:

TableColumnModel.setColumnSelectionAllowed(boolean)

getSelectedColumns

public int[] getSelectedColumns()

선택된 열의 배열을 돌려줍니다. selectionModel 가 null 의 경우, 빈 상태(empty)의 배열이 돌려주어집니다.

정의:

인터페이스 TableColumnModel 내의 getSelectedColumns

반환값:

선택된 열의 배열. 아무것도 선택되어 있지 않은지,selectionModel 가 null 의 경우는 빈 상태(empty)의 배열

getSelectedColumnCount

public int getSelectedColumnCount()

선택되고 있는 열의 수를 돌려줍니다.

정의:

인터페이스 TableColumnModel 내의 getSelectedColumnCount

반환값:

선택되고 있는 열의 수

addColumnModelListener

public void addColumnModelListener(TableColumnModelListener  x)

테이블열모델 이벤트용의 청취자를 추가합니다.

정의:

인터페이스 TableColumnModel 내의 addColumnModelListener

파라미터:

x - TableColumnModelListener 객체

removeColumnModelListener

public void removeColumnModelListener(TableColumnModelListener  x)

테이블열모델 이벤트용의 청취자를 삭제합니다.

정의:

인터페이스 TableColumnModel 내의 removeColumnModelListener

파라미터:

x - TableColumnModelListener 객체

getColumnModelListeners

public TableColumnModelListener [] getColumnModelListeners()

이 모델에 등록된, 모든 열모델 청취자로부터 되는 배열을 돌려줍니다.

반환값:

이 디폴트 테이블열모델의 모든 ColumnModelListener. 열모델 청취자가 현재 등록되지 않은 경우는 빈 상태(empty)의 배열

도입된 버젼:

1.4

관련 항목:

addColumnModelListener(javax.swing.event.TableColumnModelListener) , removeColumnModelListener(javax.swing.event.TableColumnModelListener)

fireColumnAdded

protected void fireColumnAdded(TableColumnModelEvent  e)

통지의 전달 대상을, 지정된 이벤트형으로 등록한 모든 청취자에게 통지합니다. 이벤트 인스턴스는, fire 메소드에게 건네지는 파라미터를 사용해 간단하게 생성됩니다.

파라미터:

e - 받은 이벤트

관련 항목:

EventListenerList

fireColumnRemoved

protected void fireColumnRemoved(TableColumnModelEvent  e)

통지의 전달 대상을, 지정된 이벤트형으로 등록한 모든 청취자에게 통지합니다. 이벤트 인스턴스는, fire 메소드에게 건네지는 파라미터를 사용해 간단하게 생성됩니다.

파라미터:

e - 받은 이벤트

관련 항목:

EventListenerList

fireColumnMoved

protected void fireColumnMoved(TableColumnModelEvent  e)

통지의 전달 대상을, 지정된 이벤트형으로 등록한 모든 청취자에게 통지합니다. 이벤트 인스턴스는, fire 메소드에게 건네지는 파라미터를 사용해 간단하게 생성됩니다.

파라미터:

e - 받은 이벤트

관련 항목:

EventListenerList

fireColumnSelectionChanged

protected void fireColumnSelectionChanged(ListSelectionEvent  e)

통지의 전달 대상을, 지정된 이벤트형으로 등록한 모든 청취자에게 통지합니다. 이벤트 인스턴스는, fire 메소드에게 건네지는 파라미터를 사용해 간단하게 생성됩니다.

파라미터:

e - 받은 이벤트

관련 항목:

EventListenerList

fireColumnMarginChanged

protected void fireColumnMarginChanged()

통지의 전달 대상을, 지정된 이벤트형으로 등록한 모든 청취자에게 통지합니다. 이벤트 인스턴스는, fire 메소드에게 건네지는 파라미터를 사용해 간단하게 생성됩니다.

관련 항목:

EventListenerList

getListeners

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

이 모델에 FooListener 로서 현재 등록되어 모든 객체의 배열을 돌려줍니다. FooListener 는,addFooListener 메소드를 사용해 등록합니다.

FooListener.class 라고 하는 클래스 리터럴을 사용해,listenerType 인수를 지정할 수 있습니다. 예를 들어 이하의 코드를 사용해,DefaultTableColumnModel m 를, 그 열모델 청취자에게 조회할 수 있습니다.

ColumnModelListener[] cmls = (ColumnModelListener[])(m.getListeners(ColumnModelListener.class));

이러한 청취자가 없는 경우는 빈 상태(empty)의 배열을 돌려줍니다.

파라미터:

listenerType - 요구되는 청취자의 형태. 이 파라미터는 java.util.EventListener 의 하위 인터페이스를 지정한다

반환값:

이 모델에 FooListener 로서 등록되어 모든 객체의 배열. 그러한 청취자가 추가되어 있지 않은 경우는 빈 상태(empty)의 배열

예외:

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

도입된 버젼:

1.3

관련 항목:

getColumnModelListeners()

propertyChange

public void propertyChange(PropertyChangeEvent  evt)

프로퍼티 변경 청취자 변경 메소드입니다. 지정된 렬폭 또는 최적인 렬폭에의 변경을 추적하는 경우에 사용합니다.

정의:

인터페이스 PropertyChangeListener 내의 propertyChange

파라미터:

evt - PropertyChangeEvent

valueChanged

public void valueChanged(ListSelectionEvent  e)

ListSelectionListener 는, 열의 선택이 변경되면(자),ListSelectionEvent 를 전송 합니다.

정의:

인터페이스 ListSelectionListener 내의 valueChanged

파라미터:

e - 변경 이벤트

createSelectionModel

protected ListSelectionModel  createSelectionModel()

신규의 리스트 선택의 디폴트 모델을 작성합니다.

recalcWidthCache

protected void recalcWidthCache()

모든 열의 폭을 조합한 합계를 재계산합니다. totalColumnWidth 프로퍼티을 갱신합니다.