JavaTM Platform
Standard Ed. 6

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���� 1.4 �汾��ʼ������ java.beans ����������֧������ JavaBeansTM ���ڴ洢�Ĺ��ܡ���μ� XMLEncoder��

������
JTable

�ֶ�ժҪ
protected  ChangeEvent changeEvent
          �����¼���ֻ��Ҫһ����
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)
          �� aColumn ׷�ӵ� tableColumns ����Ľ�β��
 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)
          ���� tableColumns �����е�һ�е���������ʹ�� equals ���бȽ�ʱ�����еı�ʶ������ identifier��
 int getColumnIndexAtX(int x)
          ����λ�� x ���е�����������õ㴦û���У��򷵻� -1��
 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)
          Property Change Listener ���ķ�����
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)
          ��ѡ�����ʱת�� ListSelectionEvents �� ListSelectionListener��
 
���� 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
�����¼���ֻ��Ҫһ����


columnSelectionAllowed

protected boolean columnSelectionAllowed
����ģ������������ѡ��


totalColumnWidth

protected int totalColumnWidth
�������ܿ��ȵı��ػ���

���췽����ϸ��Ϣ

DefaultTableColumnModel

public DefaultTableColumnModel()
����Ĭ�ϵı���ģ�͡�

������ϸ��Ϣ

addColumn

public void addColumn(TableColumn aColumn)
�� aColumn ׷�ӵ� tableColumns ����Ľ�β���˷������� 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)
���� tableColumns �����е�һ�е���������ʹ�� equals ���бȽ�ʱ�����еı�ʶ������ identifier��

ָ���ߣ�
�ӿ� TableColumnModel �е� getColumnIndex
������
identifier - ��ʶ������
���أ�
tableColumns �����е�һ�е����������еı�ʶ������ identifier
�׳���
IllegalArgumentException - ��� identifier Ϊ null������û�� TableColumn ���д� identifier
������
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 �Ŀɷ���ģ�ͼܹ�����һ�£�TableColumnModel ��֪�����ĸ��������ʵ����ʾ����Ļ�ϵġ����еĿ��ӻ���ʾ��ʹ�ô�ģ�͵���ͼ/��������ͨ���� JTable�������𡣸���ͼ/��������������Ұ�˳����ʾ���С����磬Ϊ����Ӧ���Ի���������ѡ�񣬿��Դ��ҵ�����ʾ���У����߿��ܸ����û�����������ijЩ�С���Ϊģ�Ͳ�֪���������������Ļ�ϲ��ֵģ����Բ�Ӧ�������� xPosition ��Ϊ�� 2D ͼ�οռ��е����ꡣ�෴��Ӧ�ý�����Ϊ�Ǵ�ģ�������п�ʼ��һ�����ȡ������Ҫ 2D �ռ��и��� X ������������������ʹ�� 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�����׳�һ���쳣��

ָ���ߣ�
�ӿ� 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���򷵻�һ�������顣

ָ���ߣ�
�ӿ� TableColumnModel �е� getSelectedColumns
���أ�
����ѡ���е����飬���û��ѡ�����У��� selectionModel Ϊ null���򷵻�һ��������

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�������ǰû����ע�����ģ�����������򷵻�һ��������
�����°汾��ʼ��
1.4
������
addColumnModelListener(javax.swing.event.TableColumnModelListener), removeColumnModelListener(javax.swing.event.TableColumnModelListener)

fireColumnAdded

protected void fireColumnAdded(TableColumnModelEvent e)
֪ͨ���жԴ��¼����͵�֪ͨ����Ȥ����ע����������ʹ�ô���˴��������IJ����Ӻ�lazily�������¼�ʵ����

������
e - ���յ��¼�
������
EventListenerList

fireColumnRemoved

protected void fireColumnRemoved(TableColumnModelEvent e)
֪ͨ���жԴ��¼����͵�֪ͨ����Ȥ����ע����������ʹ�ô���˴��������IJ����Ӻ󴴽��¼�ʵ����

������
e - ���յ��¼�
������
EventListenerList

fireColumnMoved

protected void fireColumnMoved(TableColumnModelEvent e)
֪ͨ���жԴ��¼����͵�֪ͨ����Ȥ����ע����������ʹ�ô���˴��������IJ����Ӻ󴴽��¼�ʵ����

������
e - ���յ��¼�
������
EventListenerList

fireColumnSelectionChanged

protected void fireColumnSelectionChanged(ListSelectionEvent e)
֪ͨ���жԴ��¼����͵�֪ͨ����Ȥ����ע����������ʹ�ô���˴��������IJ����Ӻ󴴽��¼�ʵ����

������
e - ���յ��¼�
������
EventListenerList

fireColumnMarginChanged

protected void fireColumnMarginChanged()
֪ͨ���жԴ��¼����͵�֪ͨ����Ȥ����ע����������ʹ�ô���˴��������IJ����Ӻ󴴽��¼�ʵ����

������
EventListenerList

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)
���ص�ǰ���ڴ�ģ����ע��Ϊ FooListener �����ж�����ɵ����顣FooListener ���� addFooListener ����ע��ġ�

����ʹ�� class ����ֵ���� FooListener.class����ָ�� listenerType ���������磬����ʹ�����´����ѯ DefaultTableColumnModel m ����ģ����������

ColumnModelListener[] cmls = (ColumnModelListener[])(m.getListeners(ColumnModelListener.class));
�������������������������˷���������һ�������顣

������
listenerType - ��������������ͣ��˲���Ӧ��ָ��һ���� java.util.EventListener �̳еĽӿ�
���أ�
�ڴ�ģ����ע��Ϊ FooListener �����ж�����ɵ����飬���û���������������������򷵻�һ��������
�׳���
ClassCastException - ��� listenerType δָ��ʵ�� java.util.EventListener �����ӿڡ�
�����°汾��ʼ��
1.3
������
getColumnModelListeners()

propertyChange

public void propertyChange(PropertyChangeEvent evt)
Property Change Listener ���ķ��������ڸ����п�����ѡ�п��ĸ��ġ�

ָ���ߣ�
�ӿ� PropertyChangeListener �е� propertyChange
������
evt - PropertyChangeEvent

valueChanged

public void valueChanged(ListSelectionEvent e)
��ѡ�����ʱת�� ListSelectionEvents �� ListSelectionListener��

ָ���ߣ�
�ӿ� ListSelectionListener �е� valueChanged
������
e - �����¼�

createSelectionModel

protected ListSelectionModel createSelectionModel()
�����µ�Ĭ���б�ѡ��ģ�͡�


recalcWidthCache

protected void recalcWidthCache()
���¼��������е��ܿ��ȡ����� totalColumnWidth ���ԡ�


JavaTM Platform
Standard Ed. 6

�ύ��������
�йظ���� API �ο����ϺͿ�����Ա�ĵ�������� Java SE ������Ա�ĵ������ĵ���������ϸ�ġ����򿪷���Ա���������Լ�������������ﶨ�塢ʹ�ü��ɺ͹�������ʾ����

��Ȩ���� 2007 Sun Microsystems, Inc. ��������Ȩ���� ����������֤��������������ĵ����·ַ�������