javax.swing.plaf.basic
클래스 BasicListUI

java.lang.Object 
  javax.swing.plaf.ComponentUI 
      javax.swing.plaf.ListUI 
          javax.swing.plaf.basic.BasicListUI

public class BasicListUI
extends ListUI 

ListUI Windows Look & Feel 에 한 구현입니다.

중첩(Nested) 클래스 개요

class	BasicListUI.FocusHandler 이 내부 클래스는 "public"와 마크 됩니다만, 이것은 컴파일러의 버그가 원인입니다.
class	BasicListUI.ListDataHandler installUI 실행시 및 JList.model 프로퍼티가 변경되었을 때에 JList 모델에 추가되는 ListDataListener 입니다.
class	BasicListUI.ListSelectionHandler installUI 실행시 및 JList.selectionModel 프로퍼티가 변경되었을 때에 JLists 선택 모델에 추가되는 ListSelectionListener 입니다.
class	BasicListUI.MouseInputHandler JList를 위한 포커스 처리와 마우스 입력입니다.
class	BasicListUI.PropertyChangeHandler PropertyChangeListener는 installUI 실행시에 JList에 추가됩니다.

필드 개요

protected int	cellHeight
protected int[]	cellHeights
protected static int	cellRendererChanged
protected int	cellWidth
protected static int	fixedCellHeightChanged
protected static int	fixedCellWidthChanged
protected FocusListener	focusListener
protected static int	fontChanged
protected JList	list
protected ListDataListener	listDataListener
protected ListSelectionListener	listSelectionListener
protected static int	modelChanged
protected MouseInputListener	mouseInputListener
protected PropertyChangeListener	propertyChangeListener
protected static int	prototypeCellValueChanged
protected CellRendererPane	rendererPane
protected static int	selectionModelChanged
protected int	updateLayoutStateNeeded

생성자 개요

BasicListUI ()

메서드 개요

protected int	convertRowToY (int row) 지정된 행의 원점의 JList 상대 Y 좌표를 리턴합니다.
protected int	convertYToRow (int y0) JList 상대 좌표를, 현재의 레이아웃을 기본으로 해, 좌표를 포함한 행으로 변환합니다.
protected FocusListener	createFocusListener ()
protected ListDataListener	createListDataListener () 모델에 의해 필요에 따라서 JList에 추가되는 ListDataListener 인스턴스를 생성합니다.
protected ListSelectionListener	createListSelectionListener () selectionModel에 의해 필요에 따라서 JList에 추가되는 ListSelectionHandler 인스턴스를 생성합니다.
protected MouseInputListener	createMouseInputListener () MouseInputListener를 구현하는 위양을 작성합니다.
protected PropertyChangeListener	createPropertyChangeListener () installUI()에 의해 JList에 추가되는 PropertyChangeHandler 인스턴스를 생성합니다.
static ComponentUI	createUI (JComponent list) BasicListUI 새로운 인스턴스를 리턴합니다.
Rectangle	getCellBounds (JList list, int index1, int index2) 지정된 항목의 JList 좌표에 있어서의 경계를 리턴합니다.
Dimension	getPreferredSize (JComponent c) 리스트의 preferredSize는 배치 방향에 의해 정해집니다.
protected int	getRowHeight (int row) 현재의 레이아웃으로 지정된 행의 높이를 리턴합니다.
Point	indexToLocation (JList list, int index) 지정된 항목의 JList 좌표에 있어서의 원점을 리턴합니다.
protected void	installDefaults () JList 프로퍼티 (폰트, foreground 및 백그라운드등)를 초기화해, CellRendererPane를 추가합니다.
protected void	installKeyboardActions () BasicListUI를 관련된 JList 상의 키보드 바인딩을 리턴합니다.
protected void	installListeners () JList, 그 모델 및 selectionModel 리스너를 작성 및 인스톨 합니다.
void	installUI (JComponent c) installDefaults(), installListeners() 및 installKeyboardActions()를 순서에 호출해, this.list를 초기화합니다.
int	locationToIndex (JList list, Point location) JList 좌표상의 점을 그 위치에 있는 셀의 인덱스로 변환합니다.
protected void	maybeUpdateLayoutState () updateLayoutStateNeeded가 제로가 아니면, updateLayoutState()을 호출해 updateLayoutStateNeeded를 리셋 합니다.
void	paint (Graphics g, JComponent c) Graphics 객체의 clipRect와 교차하는 행을 페인트 합니다.
protected void	paintCell (Graphics g, int row, Rectangle rowBounds, ListCellRenderer cellRenderer, ListModel dataModel, ListSelectionModel selModel, int leadIndex) List 셀을 1개 페인트 합니다.
protected void	selectNextIndex () 1개 전의 행을 선택해, 그것을 강제적으로 가시로 합니다.
protected void	selectPreviousIndex () 1개 전의 행을 선택해, 그것을 강제적으로 가시로 합니다.
protected void	uninstallDefaults () null에 명시적으로 오버라이드(override)되어 있지 않은 JList 프로퍼티를 설정합니다.
protected void	uninstallKeyboardActions () installKeyboardActions로 부터 인스톨 된 키보드 액션의 등록을 해제합니다.
protected void	uninstallListeners () JList, 그 모델 및 selectionModel 리스너를 삭제합니다.
void	uninstallUI (JComponent c) uninstallListeners(), uninstallKeyboardActions() 및 uninstallDefaults()를 순서에 호출해, this.list 초기화를 해제합니다.
protected void	updateLayoutState () cellHeight (또는 cellHeights) 및 cellWidth 값을 현재의 폰트와 fixedCellWidth, fixedCellHeight 및 prototypeCellValue 현재의 값을 기본으로의해 다시 계산합니다.

클래스 javax.swing.plaf. ComponentUI 로부터 상속된 메서드

contains, getAccessibleChild, getAccessibleChildrenCount, getMaximumSize, getMinimumSize, update

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

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

필드의 상세

list

protected JList  list

rendererPane

protected CellRendererPane  rendererPane

focusListener

protected FocusListener  focusListener

mouseInputListener

protected MouseInputListener  mouseInputListener

listSelectionListener

protected ListSelectionListener  listSelectionListener

listDataListener

protected ListDataListener  listDataListener

propertyChangeListener

protected PropertyChangeListener  propertyChangeListener

cellHeights

protected int[] cellHeights

cellHeight

protected int cellHeight

cellWidth

protected int cellWidth

updateLayoutStateNeeded

protected int updateLayoutStateNeeded

modelChanged

protected static final int modelChanged

관련 항목:

정수 필드값

selectionModelChanged

protected static final int selectionModelChanged

관련 항목:

정수 필드값

fontChanged

protected static final int fontChanged

관련 항목:

정수 필드값

fixedCellWidthChanged

protected static final int fixedCellWidthChanged

관련 항목:

정수 필드값

fixedCellHeightChanged

protected static final int fixedCellHeightChanged

관련 항목:

정수 필드값

prototypeCellValueChanged

protected static final int prototypeCellValueChanged

관련 항목:

정수 필드값

cellRendererChanged

protected static final int cellRendererChanged

관련 항목:

정수 필드값

생성자 상세

BasicListUI

public BasicListUI()

메서드의 상세

paintCell

protected void paintCell(Graphics  g,
                         int row,
                         Rectangle  rowBounds,
                         ListCellRenderer  cellRenderer,
                         ListModel  dataModel,
                         ListSelectionModel  selModel,
                         int leadIndex)

List 셀을 1개 페인트 합니다. 적절한 상태를 계산해, 셀 렌더링 컴퍼넌트의 「러버 스탬프」를 취득하고 나서, CellRendererPane를 사용해 셀을 페인트 합니다. 서브 클래스에서는 paint()가 아니고 이 메서드를 오버라이드(override) 할 수 있습니다.

관련 항목:

paint(java.awt.Graphics, javax.swing.JComponent)

paint

public void paint(Graphics  g,
                  JComponent  c)

Graphics 객체의 clipRect와 교차하는 행을 페인트 합니다. 이 메서드는 필요에 따라서 paintCell를 호출합니다. 서브 클래스는 이러한 메서드를 오버라이드(override) 할 수 있습니다.

오버라이드(override):

클래스 ComponentUI 내의 paint

파라미터:

g - 페인트 대상의 Graphics 컨텍스트

c - 페인트 되는 컴퍼넌트. 이 인수는 자주 무시되지만, UI 객체가 상태없이 복수의 컴퍼넌트에 공유되는 경우에 사용되는 일이 있는

관련 항목:

paintCell(java.awt.Graphics, int, java.awt.Rectangle, javax.swing.ListCellRenderer, javax.swing.ListModel, javax.swing.ListSelectionModel, int)

getPreferredSize

public Dimension  getPreferredSize(JComponent  c)

리스트의 preferredSize는 배치 방향에 의해 정해집니다.

배치 방향	적절한 사이즈
JList.VERTICAL	리스트의 preferredSize는 행의 높이의 합계와 셀의 최대폭입니다. JList.fixedCellHeight가 가리키는 경우, 행의 높이의 합계는 (cellVerticalMargins + fixedCellHeight) * model.getSize()가 됩니다. 여기서 rowVerticalMargins는 포커스를 나타내는 노란 아우트라인을 렌더링 하기 위해서 할당하는 영역에 상당합니다. 같이 fixedCellWidth가 가리키는 경우는 셀의 고정넓이를 사용합니다.
JList.VERTICAL_WRAP	가시의 행수가 0 보다 큰 경우, preferredHeight는 셀의 최대의 높이 * visibleRowCount가 됩니다. 가시의 행수가 0 아래의 경우, 적절한 높이는 현재의 리스트의 높이와 셀의 최대의 높이중 높은 편이 됩니다. 적절한 폭은 셀의 최대폭 * 필요한 렬수,가 됩니다. 여기서, 필요한 렬수는 리스트의 높이/셀의 최대의 높이입니다. 셀의 최대의 높이는 셀의 고정의 높이가 되는지, 모든 셀에 대해서 반복해 ListCellRenderer 로부터 최대의 높이를 검색하는 것으로써 정해집니다.
JList.HORIZONTAL_WRAP	가시의 행수가 0 보다 큰 경우, preferredHeight는 셀의 최대의 높이 * adjustedRowCount가 됩니다. 여기서, visibleRowCount는 렬수의 지정에 사용됩니다. 수평에 배치하기 위해, 행수는 렬수로부터 정해집니다. 예를 들어 10 항목의 모델로 가시행수가 8 이라고 합니다. 표시에 필요한 열은 2 열입니다만, 8 행이나 필요없고, 5 행으로 끝납니다. 따라서, adjustedRowCount는 5가 됩니다. 가시행수가 0 아래의 경우, 적절한 높이는 렬수에 따릅니다. 적어도 1 열로JList 넓이 (폭/최대 셀폭)에 적절한 범위내의 수가 됩니다. 적절한 높이는 모델 사이즈/렬수 * 셀의 최대의 높이가 됩니다. 셀의 최대의 높이는 셀의 고정의 높이가 되는지, 모든 셀에 대해서 반복해 ListCellRenderer 로부터 최대의 높이를 검색하는 것으로써 정해집니다.

상기는 미처리인 적절한 폭과 높이입니다. 결과적으로 얻을 수 있는 적절한 폭은 상기의넓이 + insets.left + insets.right 로 결과적으로 얻을 수 있는 적절한 높이는 상기의 높이 + insets.top + insets.bottom 입니다. 여기서, Insets는 list.getInsets()로 부터 정해집니다.

오버라이드(override):

클래스 ComponentUI 내의 getPreferredSize

파라미터:

c - JList 컴퍼넌트

반환값:

리스트의 총사이즈

관련 항목:

JComponent.getPreferredSize(), LayoutManager.preferredLayoutSize(java.awt.Container)

selectPreviousIndex

protected void selectPreviousIndex()

1개 전의 행을 선택해, 그것을 강제적으로 가시로 합니다.

관련 항목:

JList.ensureIndexIsVisible(int)

selectNextIndex

protected void selectNextIndex()

1개 전의 행을 선택해, 그것을 강제적으로 가시로 합니다.

관련 항목:

JList.ensureIndexIsVisible(int)

installKeyboardActions

protected void installKeyboardActions()

BasicListUI를 관련된 JList 상의 키보드 바인딩을 리턴합니다. 이 메서드는 installUI() 실행시에 호출합니다.

관련 항목:

installUI(javax.swing.JComponent)

uninstallKeyboardActions

protected void uninstallKeyboardActions()

installKeyboardActions로 부터 인스톨 된 키보드 액션의 등록을 해제합니다. 이 메서드는 uninstallUI()의 실행시에 호출합니다. 서브 클래스는 installUI 실행시에 등록된 키보드 액션을 모두, 여기서 삭제할 필요가 있습니다.

관련 항목:

installUI(javax.swing.JComponent)

installListeners

protected void installListeners()

JList, 그 모델 및 selectionModel 리스너를 작성 및 인스톨 합니다. 이 메서드는 installUI()의 실행시에 호출합니다.

관련 항목:

installUI(javax.swing.JComponent), uninstallListeners()

uninstallListeners

protected void uninstallListeners()

JList, 그 모델 및 selectionModel 리스너를 삭제합니다. 여기서, 리스너의 필드는 모두 null에 리셋 됩니다. 이 메서드는 uninstallUI()의 실행시에 호출합니다. installListners와 의 동기를 유지하도록의해 주세요.

관련 항목:

uninstallUI(javax.swing.JComponent), installListeners()

installDefaults

protected void installDefaults()

JList 프로퍼티 (폰트, foreground 및 백그라운드등)를 초기화해, CellRendererPane를 추가합니다. 폰트, foreground 및 백그라운드의 각 프로퍼티는 그러한 현재의 값이 null 나 UIResource 인 경우에만 설정됩니다. 그 외의 프로퍼티는 현재의 값이 null 인 경우로 설정됩니다.

관련 항목:

uninstallDefaults(), installUI(javax.swing.JComponent), CellRendererPane

uninstallDefaults

protected void uninstallDefaults()

null에 명시적으로 오버라이드(override)되어 있지 않은 JList 프로퍼티를 설정합니다. 현재의 값이 UIResouce가 아니면, 프로퍼티는 오버라이드(override) 되었다고 판단됩니다.

관련 항목:

installDefaults(), uninstallUI(javax.swing.JComponent), CellRendererPane

installUI

public void installUI(JComponent  c)

installDefaults(), installListeners() 및 installKeyboardActions()를 순서에 호출해, this.list를 초기화합니다.

오버라이드(override):

클래스 ComponentUI 내의 installUI

파라미터:

c - UI 위양이 인스톨 되고 있는 컴퍼넌트

관련 항목:

installDefaults(), installListeners(), installKeyboardActions()

uninstallUI

public void uninstallUI(JComponent  c)

uninstallListeners(), uninstallKeyboardActions() 및 uninstallDefaults()를 순서에 호출해, this.list 초기화를 해제합니다. this.list는 null 로 설정됩니다.

오버라이드(override):

클래스 ComponentUI 내의 uninstallUI

파라미터:

c - 이 UI 위양이 삭제되는 컴퍼넌트. 이 인수는 자주 무시되지만, UI 객체가 상태없이 복수의 컴퍼넌트에 공유되는 경우에 사용되는 일이 있는

관련 항목:

uninstallListeners(), uninstallKeyboardActions(), uninstallDefaults()

createUI

public static ComponentUI  createUI(JComponent  list)

BasicListUI 새로운 인스턴스를 리턴합니다. BasicListUI 위양은 JList 1개을 뒤따라 1개을 할당할 수 있습니다.

반환값:

Winodws Look & Feel를 위한, 새로운 ListUI 구현

locationToIndex

public int locationToIndex(JList  list,
                           Point  location)

JList 좌표상의 점을 그 위치에 있는 셀의 인덱스로 변환합니다. 셀이 실제로 그 위치를 포함할지 어떨지를 판정하려면, 이 메서드와 getCellBounds를 조합해 사용합니다. 모델이 비어있는 경우는 -1을 리턴합니다.

정의:

클래스 ListUI 내의 locationToIndex

location - 셀의 JList 상의 상대 좌표

반환값:

지정된 위치에 있는 셀의 인덱스, 또는 -1

관련 항목:

ListUI.locationToIndex(javax.swing.JList, java.awt.Point)

indexToLocation

public Point  indexToLocation(JList  list,
                             int index)

클래스 ListUI 기술:

지정된 항목의 JList 좌표에 있어서의 원점을 리턴합니다. 무효인 인덱스를 지정했을 경우는 null을 리턴합니다.

정의:

클래스 ListUI 내의 indexToLocation

index - JList 셀의 인덱스

반환값:

index 로 지정된 번호의 셀의 원점. index가 무효의 경우는 null

관련 항목:

ListUI.indexToLocation(javax.swing.JList, int)

getCellBounds

public Rectangle  getCellBounds(JList  list,
                               int index1,
                               int index2)

클래스 ListUI 기술:

지정된 항목의 JList 좌표에 있어서의 경계를 리턴합니다. 무효인 인덱스를 지정했을 경우는 null을 리턴합니다.

정의:

클래스 ListUI 내의 getCellBounds

반환값:

index 로 지정된 번호의 셀의 경계

관련 항목:

ListUI.getCellBounds(javax.swing.JList, int, int)

getRowHeight

protected int getRowHeight(int row)

현재의 레이아웃으로 지정된 행의 높이를 리턴합니다.

반환값:

지정된 행의 높이. 행의 지정이 무효인 경우는 -1

관련 항목:

convertYToRow(int), convertRowToY(int), updateLayoutState()

convertYToRow

protected int convertYToRow(int y0)

JList 상대 좌표를, 현재의 레이아웃을 기본으로 해, 좌표를 포함한 행으로 변환합니다. y0가 어느 행에도 포함되지 않는 경우는 -1을 리턴합니다.

반환값:

y0를 포함한 행, 또는 -1

관련 항목:

getRowHeight(int), updateLayoutState()

convertRowToY

protected int convertRowToY(int row)

지정된 행의 원점의 JList 상대 Y 좌표를 리턴합니다. 행이 무효인 경우는 -1을 리턴합니다.

반환값:

행의 원점의 Y 좌표, 또는 -1

관련 항목:

getRowHeight(int), updateLayoutState()

maybeUpdateLayoutState

protected void maybeUpdateLayoutState()

updateLayoutStateNeeded가 제로가 아니면, updateLayoutState()을 호출해 updateLayoutStateNeeded를 리셋 합니다. 이 메서드는 리스트의 지오메트리에 근거한데 등인가의 처리를 하기 전에 다른 메서드로 호출하도록의해 주세요. 예를 들어 paint() 및 getPreferredSize()로 최초로 호출해 주세요.

관련 항목:

updateLayoutState()

updateLayoutState

protected void updateLayoutState()

cellHeight (또는 cellHeights) 및 cellWidth 값을 현재의 폰트와 fixedCellWidth, fixedCellHeight 및 prototypeCellValue 현재의 값을 기본으로의해 다시 계산합니다.

관련 항목:

maybeUpdateLayoutState()

createMouseInputListener

protected MouseInputListener  createMouseInputListener()

MouseInputListener를 구현하는 위양을 작성합니다. 이 위양은 installUI()의 실행시에 대응하는 java.awt.Component 리스너 리스트에 추가됩니다. 서브 클래스는 이 메서드를 오버라이드(override)의해 독자적인 MouseInputListener를 돌려줄 수가 있습니다. 다음에 예를 나타냅니다.

 class MyListUI extends BasicListUI {
    protected MouseInputListener createMouseInputListener() {
        return new MyMouseInputHandler();
    }
    public class MyMouseInputHandler extends MouseInputHandler {
        public void mouseMoved(MouseEvent e) {
            // do some extra work when the mouse moves
            super.mouseMoved(e);
        }
    }
 }
 

관련 항목:

BasicListUI.MouseInputHandler, installUI(javax.swing.JComponent)

createFocusListener

protected FocusListener  createFocusListener()

createListSelectionListener

protected ListSelectionListener  createListSelectionListener()

selectionModel에 의해 필요에 따라서 JList에 추가되는 ListSelectionHandler 인스턴스를 생성합니다. 서브 클래스는 이 메서드를 오버라이드(override)의해 독자적인 ListSelectionListener를 돌려줄 수가 있습니다. 다음에 예를 나타냅니다.

 class MyListUI extends BasicListUI {
    protected ListSelectionListener createListSelectionListener() {
        return new MySelectionListener();
    }
    public class MySelectionListener extends ListSelectionHandler {
        public void valueChanged(ListSelectionEvent e) {
            // do some extra work when the selection changes
            super.valueChange(e);
        }
    }
 }
 

관련 항목:

BasicListUI.ListSelectionHandler, installUI(javax.swing.JComponent)

createListDataListener

protected ListDataListener  createListDataListener()

모델에 의해 필요에 따라서 JList에 추가되는 ListDataListener 인스턴스를 생성합니다. 서브 클래스는 이 메서드를 오버라이드(override)의해 독자적인 ListDataListener를 돌려줄 수가 있습니다. 다음에 예를 나타냅니다.

 class MyListUI extends BasicListUI {
    protected ListDataListener createListDataListener() {
        return new MyListDataListener();
    }
    public class MyListDataListener extends ListDataHandler {
        public void contentsChanged(ListDataEvent e) {
            // do some extra work when the models contents change
            super.contentsChange(e);
        }
    }
 }
 

관련 항목:

ListDataListener, JList.getModel(), installUI(javax.swing.JComponent)

createPropertyChangeListener

protected PropertyChangeListener  createPropertyChangeListener()

installUI()에 의해 JList에 추가되는 PropertyChangeHandler 인스턴스를 생성합니다. 서브 클래스는 이 메서드를 오버라이드(override)의해 독자적인 PropertyChangeListener를 돌려줄 수가 있습니다. 다음에 예를 나타냅니다.

 class MyListUI extends BasicListUI {
    protected PropertyChangeListener createPropertyChangeListener() {
        return new MyPropertyChangeListener();
    }
    public class MyPropertyChangeListener extends PropertyChangeHandler {
        public void propertyChange(PropertyChangeEvent e) {
            if (e.getPropertyName(). equals("model")) {
                // do some extra work when the model changes
            }
            super.propertyChange(e);
        }
    }
 }
 

관련 항목:

PropertyChangeListener, installUI(javax.swing.JComponent)