javax.swing
클래스 JList

java.lang.Object 
  java.awt.Component 
      java.awt.Container 
          javax.swing.JComponent 
              javax.swing.JList

모든 구현된 인터페이스:

ImageObserver, MenuContainer, Serializable, Accessible, Scrollable

public class JList
extends JComponent 
implements Scrollable,
 Accessible 

사용자가 리스트로부터 1개 또는 복수의 객체를 선택하기 위한 컴퍼넌트입니다. 다른 모델인 ListModel는 리스트의 내용을 나타냅니다. ListModel 인스턴스를 생성하는 JList 생성자를 사용하면, 객체의 배열 또는 벡터를 간단하게 표시할 수 있습니다.

// Create a JList that displays the strings in data[]

String[] data = {"one", "two", "three", "four"};
JList dataList = new JList(data);
 
// The value of the JList model property is an object that provides
// a read-only view of the data.   It was constructed automatically.

for(int i = 0; i < dataList.getModel(). getSize(); i++) {
System.out.println(dataList.getModel(). getElementAt(i));
 }

// Create a JList that displays the superclass of JList.class.
// We store the superclasses in a java.util.Vector.

Vector superClasses = new Vector();
Class rootClass = javax.swing.JList.class;
for(Class cls = rootClass; cls ! = null; cls = cls.getSuperclass()) {
superClasses.addElement(cls);
 }
JList classList = new JList(superClasses);
 

JList는 스크롤을 직접 지원 하고 있습니다. 스크롤 리스트를 작성하려면, JList를 JScrollPane 뷰포트뷰로서 설정합니다. 다음에 예를 나타냅니다.

JScrollPane scrollPane = new JScrollPane(dataList);
// Or in two steps:
JScrollPane scrollPane = new JScrollPane();
scrollPane.getViewport(). setView(dataList);
 

디폴트에서는 정수 MULTIPLE_INTERVAL_SELECTION를 사용해, JList 선택 모델에 의해 항목의 편성을 한 번에 선택할 수 있습니다 . 선택 상태는 실제로는 개별의 위양 객체, ListSelectionModel 인스턴스로 관리되고 있습니다. 다만, JList에 서는 선택 관리에 편리한 프로퍼티가 제공됩니다.

String[] data = {"one", "two", "three", "four"};
JList dataList = new JList(data);

dataList.setSelectedIndex(1);  // select "two"
dataList.getSelectedValue();   // returns "two"
 

JList 내용은 동적입니다. 즉, JList 작성 후에 리스트 요소의 값이나 리스트의 사이즈를 변경할 수 있습니다. JList는 swing.event.ListDataListener 구현에 의해 모델의 변경을 감시합니다. ListModel가 올바르게 구현되고 있으면, 변경이 발생할 때마다 리스너에게 통지합니다. 변경은 수정, 추가 또는 삭제된 리스트 인덱스의 범위를 식별하는 swing.event.ListDataEvent에 의해 기술됩니다. 단순한 동적 내용의 JList 어플리케이션은, DefaultListModel 클래스를 사용해 리스트 요소를 포함할 수 있습니다. 이 클래스는 ListModel인터페이스를 구현해, java.util.Vector API도 제공합니다. 커스텀 ListModel 구현을 제공할 필요가 있는 어플리케이션은 기본적인 ListDataListener 지원를 제공하는 AbstractListModel을 상속할 수 있습니다 . 다음에 예를 나타냅니다.

// This list model has about 2^16 elements.   Enjoy scrolling.

 
ListModel bigData = new AbstractListModel() {
public int getSize() { return Short.MAX_VALUE; }
public Object getElementAt(int index) { return "Index " + index; }
 };

JList bigDataList = new JList(bigData);

// We don't want the JList implementation to compute the width
// or height of all of the list cells, so we give it a string
// that's as big as we'll need for any cell.   It uses this to
// compute values for the fixedCellWidth and fixedCellHeight
// properties.

bigDataList.setPrototypeCellValue("Index 1234567890");
 

JList는 cellRenderer를 호출하는 위양에 의해 제공되는 java.awt.Component를 사용해, 리스트내에서 가시 셀을 렌더링 합니다. 가시의 각 행은 셀 렌더링 컴퍼넌트를 「rubber-stamp」와 같이 사용해 렌더링 됩니다. JList는 셀을 렌더링 할 필요가 있을 때마다, 셀 렌더링에 컴퍼넌트를 요구해, setBounds()를 사용해 적절한 장소에 배치하고 나서, 렌더링의 렌더링 메서드를 호출해 렌더링 합니다. 디폴트의 셀 렌더링은, JLabel 컴퍼넌트를 사용해, 각 컴퍼넌트의 캐릭터 라인치를 렌더링 합니다. 다음과 같은 코드에의해 자신의 셀 렌더링을 사용할 수도 있습니다.

  // Display an icon and a string for each object in the list.

 
 class MyCellRenderer extends JLabel implements ListCellRenderer {
     final static ImageIcon longIcon = new ImageIcon("long.gif");
     final static ImageIcon shortIcon = new ImageIcon("short.gif");

     // This is the only method defined by ListCellRenderer.
     // We just reconfigure the JLabel each time we're called.

     public Component getListCellRendererComponent(       JList list,
       Object value,            // value to display
       int index,               // cell index
       boolean isSelected,      // is the cell selected
       boolean cellHasFocus)    // the list and the cell have the focus
     {
         String s = value.toString();
         setText(s);
         setIcon((s.length() > 10) ?  longIcon : shortIcon);
           if (isSelected) {
             setBackground(list.getSelectionBackground());
               setForeground(list.getSelectionForeground());
           }
         else {
               setBackground(list.getBackground());
               setForeground(list.getForeground());
           }
           setEnabled(list.isEnabled());
           setFont(list.getFont());
         setOpaque(true);
         return this;
     }
 }

 String[] data = {"one", "two", "three", "four"};
 JList dataList = new JList(data);
 dataList.setCellRenderer(new MyCellRenderer());
 

JList는 더블 클릭이나 트리플 ( 및 그 이상의 회수의) 클릭을 특별히는 지원 하고 있었습니다만, MouseListener를 이용하면 그것들을 간단하게 처리할 수 있습니다 . 클릭된 셀을 조사하려면, JList locationToIndex() 메서드를 사용합니다. 다음에 예를 나타냅니다.

 final JList list = new JList(dataModel);
 MouseListener mouseListener = new MouseAdapter() {
     public void mouseClicked(MouseEvent e) {
         if (e.getClickCount() == 2) {
             int index = list.locationToIndex(e.getPoint());
             System.out.println("Double clicked on Item " + index);
          }
     }
 };
 list.addMouseListener(mouseListener);
 

이 예에서는 dataList는 익명의 MouseListener 클래스에 의해 참조되고 있기 때문에 final가 되고 있습니다.

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

자세한 것은, 「The Java Tutorial」의 「How to Use Lists」를 참조하십시오. 또한, 「The Swing Connection」 「Advanced JList Programming」도 참조하십시오.

관련 항목:

ListModel, AbstractListModel, DefaultListModel, ListSelectionModel, DefaultListSelectionModel, ListCellRenderer

중첩(Nested) 클래스 개요

protected class

JList.AccessibleJList 이 클래스는 JList 클래스용의 사용자 보조 기능의 지원를 구현하고 있습니다.

클래스 javax.swing. JComponent 로부터 상속된 중첩(Nested) 클래스/인터페이스

JComponent.AccessibleJComponent

클래스 java.awt. Container 로부터 상속된 중첩(Nested) 클래스/인터페이스

Container.AccessibleAWTContainer

클래스 java.awt. Component 로부터 상속된 중첩(Nested) 클래스/인터페이스

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

필드 개요

static int	HORIZONTAL_WRAP 셀이 수평 방향의 다음에 수직 방향의 순서로 나란해지는 「신문 스타일」레이아웃을 나타냅니다.
static int	VERTICAL 디폴트의 레이아웃을 나타냅니다.
static int	VERTICAL_WRAP 셀이 수직 방향의 다음에 수평 방향의 순서로 나란해지는 「신문 스타일」레이아웃을 나타냅니다.

클래스 javax.swing. JComponent 로부터 상속된 필드

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

클래스 java.awt. Component 로부터 상속된 필드

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

인터페이스 java.awt.image. ImageObserver 로부터 상속된 필드

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

생성자 개요

JList ()
비어있는 모델로 JList를 구축합니다.

JList (ListModel dataModel)
지정된 null 이외의 모델의 요소를 표시하는 JList를 구축합니다.

JList (Object [] listData)
지정된 배열의 요소를 표시하는 JList를 구축합니다.

JList (Vector <? > listData)
지정된 Vector 요소를 표시하는 JList를 구축합니다.

메서드 개요

void	addListSelectionListener (ListSelectionListener listener) 선택이 변경될 때마다 통지되는 리스트에 리스너를 추가합니다.
void	addSelectionInterval (int anchor, int lead) 지정된 구간을 현재의 선택에 가세합니다.
void	clearSelection () 선택을 클리어 합니다.
protected ListSelectionModel	createSelectionModel () DefaultListSelectionModel 인스턴스를 리턴합니다.
void	ensureIndexIsVisible (int index) 뷰포트를 스크롤 해, 지정된 셀을 완전하게 가시로 합니다.
protected void	fireSelectionValueChanged (int firstIndex, int lastIndex, boolean isAdjusting) 선택 모델이 변경된 것을 JList ListSelectionListener에 통지합니다.
AccessibleContext	getAccessibleContext () 이 JList에 관련한 AccessibleContext를 리턴합니다.
int	getAnchorSelectionIndex () 마지막 addSelectionModel 또는 setSelectionInterval 호출해에 있어서의 최초의 인덱스 인수를 리턴합니다.
Rectangle	getCellBounds (int index0, int index1) JList 좌표로 지정된 항목 범위의 경계를 리턴합니다.
ListCellRenderer	getCellRenderer () 리스트 항목을 렌더링 하는 객체를 리턴합니다.
boolean	getDragEnabled () dragEnabled 프로퍼티를 취득합니다.
int	getFirstVisibleIndex () 최초의 가시 셀의 인덱스를 리턴합니다.
int	getFixedCellHeight () 고정 셀고의 값을 리턴합니다.
int	getFixedCellWidth () 고정 셀폭의 값을 리턴합니다.
int	getLastVisibleIndex () 마지막 가시 셀의 인덱스를 리턴합니다.
int	getLayoutOrientation () 레이아웃이 셀의 단일의 열의 경우는 JList.VERTICAL, 컨텐츠가 수직 방향의 다음에 수평 방향의 순서에 줄선 「신문 스타일」의 경우는 JList.VERTICAL_WRAP, 컨텐츠가 수평 방향의 다음에 수직 방향의 순서에 줄선 「신문 스타일」의 경우는 JList.HORIZONTAL_WRAP를 리턴합니다.
int	getLeadSelectionIndex () 마지막 addSelectionInterval 또는 setSelectionInterval 호출해에 있어서의 2번째의 인덱스 인수를 리턴합니다.
ListSelectionListener []	getListSelectionListeners () 이 JList에 addListSelectionListener()로 추가된 모든 ListSelectionListener 배열을 리턴합니다.
int	getMaxSelectionIndex () 선택되고 있는 셀의 최대 인덱스를 리턴합니다.
int	getMinSelectionIndex () 선택되고 있는 셀의 최소 인덱스를 리턴합니다.
ListModel	getModel () JList 컴퍼넌트에 의해 표시되는 항목의 리스트를 보관 유지하는 데이터 모델을 리턴합니다.
int	getNextMatch (String prefix, int startIndex, Position.Bias bias) 접두사로 시작되는 다음의 리스트 요소를 리턴합니다.
Dimension	getPreferredScrollableViewportSize () visibleRowCount 행을 표시하기 위해서 필요한 뷰포트의 사이즈를 계산합니다.
Object	getPrototypeCellValue () 「prototype 셀」의 셀넓이를 리턴합니다.
int	getScrollableBlockIncrement (Rectangle visibleRect, int orientation, int direction) 다음 또는 전의 블록을 표시하기 위해서 스크롤 하는 거리를 리턴합니다.
boolean	getScrollableTracksViewportHeight () 이 JList이 JViewport에 표시되어 뷰포트가 JList 적절한 높이보다 높은 경우, 또는 레이아웃 방향이 VERTICAL_WRAP 이며, 가시행 카운트가 0 아래의 경우는 true를 리턴합니다.
boolean	getScrollableTracksViewportWidth () 이 JList이 JViewport에 표시되어 뷰포트가 JList 적절한 폭보다 넓은 경우, 또는 레이아웃 방향이 HORIZONTAL_WRAP 이며, 가시행 카운트가 <= 0인 경우는 true를 리턴합니다.
int	getScrollableUnitIncrement (Rectangle visibleRect, int orientation, int direction) 다음 또는 전의 행 (수직 스크롤) 또는 열 (수평 스크롤)을 표시하기 위해서 스크롤 하는 거리를 리턴합니다.
int	getSelectedIndex () 최초로 선택된 인덱스를 돌려주는지, 선택 항목이 없는 경우는 -1을 리턴합니다.
int[]	getSelectedIndices () 선택 떠날 수 있어 모든 인덱스의 승순 배열을 리턴합니다.
Object	getSelectedValue () 최초로 선택된 인덱스를 돌려주는지, 선택이 비어있는 경우는 null을 리턴합니다.
Object []	getSelectedValues () 선택된 셀의 값의 배열을 리턴합니다.
Color	getSelectionBackground () 선택된 셀의 백그라운드 컬러를 리턴합니다.
Color	getSelectionForeground () foreground 컬러의 선택을 리턴합니다.
int	getSelectionMode () 단일 항목 선택 또는 복수 항목 선택의 어느 쪽이 허용 되고 있을까를 리턴합니다.
ListSelectionModel	getSelectionModel () 현재의 선택 모델의 값을 리턴합니다.
String	getToolTipText (MouseEvent event) JComponent getToolTipText 메서드를 오버라이드(override) 해, 텍스트 세트가 있는 경우, 렌더링의 힌트를 사용할 수 있도록 합니다.
ListUI	getUI () 이 컴퍼넌트를 렌더링 하는 Look & Feel (L&F) 객체를 리턴합니다.
String	getUIClassID () Look & Feel (L&F) 클래스의 이름의 구축에 사용된 접두사를 리턴합니다.
boolean	getValueIsAdjusting () 데이터 모델의 isAdjusting 프로퍼티의 값을 리턴합니다.
int	getVisibleRowCount () 가시행의 적절한 수를 리턴합니다.
Point	indexToLocation (int index) 지정된 항목의 JList 좌표에 있어서의 원점을 리턴합니다.
boolean	isSelectedIndex (int index) 지정된 인덱스가 선택되고 있는 경우는 true를 리턴합니다.
boolean	isSelectionEmpty () 아무것도 선택되어 있지 않은 경우는 true를 리턴합니다.
int	locationToIndex (Point location) JList 좌표상의 점을 그 위치에 있는 셀의 인덱스로 변환합니다.
protected String	paramString () 이 JList 캐릭터 라인 표현을 리턴합니다.
void	removeListSelectionListener (ListSelectionListener listener) 선택이 변경될 때마다 통지되는 리스너를 리스트로부터 삭제합니다.
void	removeSelectionInterval (int index0, int index1) 선택 범위를, 지정된 구간과 현재의 선택 범위와의 차이 집합으로 설정합니다.
void	setCellRenderer (ListCellRenderer cellRenderer) 리스트내의 각 셀을 렌더링 하는 위양을 설정합니다.
void	setDragEnabled (boolean b) dragEnabled 프로퍼티를 설정합니다.
void	setFixedCellHeight (int height) 리스트에 있는 모든 셀의 높이를 설정합니다.
void	setFixedCellWidth (int width) 리스트에 있는 모든 셀의 넓이를 설정합니다.
void	setLayoutOrientation (int layoutOrientation) 리스트의 셀의 배치 방법을 정의합니다.
void	setListData (Object [] listData) Object 배열로부터 ListModel을 구축해, setModel을 적용합니다.
void	setListData (Vector <? > listData) Vector로 부터 ListModel을 구축해, setModel을 적용합니다.
void	setModel (ListModel model) 리스트의 내용 또는 「값」을 나타내는 모델을 설정해, PropertyChangeListener에 의 통지 후에 리스트의 선택 범위를 클리어 합니다.
void	setPrototypeCellValue (Object prototypeCellValue) fixedCellWidth 및 fixedCellHeight 프로퍼티를 계산합니다.
void	setSelectedIndex (int index) 단일 셀을 선택합니다.
void	setSelectedIndices (int[] indices) 셀세트를 선택합니다.
void	setSelectedValue (Object anObject, boolean shouldScroll) 지정된 객체를 리스트로부터 선택합니다.
void	setSelectionBackground (Color selectionBackground) 선택된 셀의 백그라운드 컬러를 설정합니다.
void	setSelectionForeground (Color selectionForeground) 선택된 셀의 foreground 컬러를 설정합니다.
void	setSelectionInterval (int anchor, int lead) 지정된 구간을 선택합니다.
void	setSelectionMode (int selectionMode) 단일 항목 선택 또는 복수 항목 선택이 가능한가 어떤가를 판정합니다.
void	setSelectionModel (ListSelectionModel selectionModel) 리스트의 selectionModel을 null이 아닌 ListSelectionModel 구현으로 설정합니다.
void	setUI (ListUI ui) 이 컴퍼넌트를 렌더링 하는 Look & Feel (L&F) 객체를 설정합니다.
void	setValueIsAdjusting (boolean b) 데이터 모델의 isAdjusting 프로퍼티를 true 로 설정해, 모든 선택 이벤트 (선택 모드로 리스트 항목상을 마우스로 드래그 하고 있는 경우등)가 완료한 시점에서 단일 이벤트가 생성되도록 합니다.
void	setVisibleRowCount (int visibleRowCount) 스크롤 바를 사용하지 않고 표시할 수 있는 리스트내의 행의 적절한 수를 설정합니다.
void	updateUI () 현재의 Look & Feel 로부터의 값을 가지는 UI 프로퍼티를 리셋 합니다.

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

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

클래스 java.awt. Container 로부터 상속된 메서드

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree

클래스 java.awt. Component 로부터 상속된 메서드

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

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

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

필드의 상세

VERTICAL

public static final int VERTICAL

디폴트의 레이아웃을 나타냅니다. 셀의 1개의 열입니다.

도입된 버전 :

1.4

관련 항목:

setLayoutOrientation(int), 정수 필드값

VERTICAL_WRAP

public static final int VERTICAL_WRAP

셀이 수직 방향의 다음에 수평 방향의 순서로 나란해지는 「신문 스타일」레이아웃을 나타냅니다.

도입된 버전 :

1.4

관련 항목:

setLayoutOrientation(int), 정수 필드값

HORIZONTAL_WRAP

public static final int HORIZONTAL_WRAP

셀이 수평 방향의 다음에 수직 방향의 순서로 나란해지는 「신문 스타일」레이아웃을 나타냅니다.

도입된 버전 :

1.4

관련 항목:

setLayoutOrientation(int), 정수 필드값

생성자 상세

JList

public JList(ListModel  dataModel)

지정된 null 이외의 모델의 요소를 표시하는 JList를 구축합니다. 모든 JList 생성자는 이 객체에 위양 합니다.

파라미터:

dataModel - 이 리스트의 데이터 모델

예외:

IllegalArgumentException - dataModel가 null인 경우

JList

public JList(Object [] listData)

지정된 배열의 요소를 표시하는 JList를 구축합니다. 이 생성자는 ListModel 생성자에 위양 합니다.

파라미터:

listData - 데이터 모델에 로드 되는 Object 배열

JList

public JList(Vector <? > listData)

지정된 Vector 요소를 표시하는 JList를 구축합니다. 이 생성자는 ListModel 생성자에 위양 합니다.

파라미터:

listData - 데이터 모델에 로드 되는 Vector

JList

public JList()

비어있는 모델로 JList를 구축합니다.

메서드의 상세

getUI

public ListUI  getUI()

이 컴퍼넌트를 렌더링 하는 Look & Feel (L&F) 객체를 리턴합니다.

반환값:

이 컴퍼넌트를 렌더링 하는 ListUI 객체

setUI

public void setUI(ListUI  ui)

이 컴퍼넌트를 렌더링 하는 Look & Feel (L&F) 객체를 설정합니다.

파라미터:

ui - ListUI L&F 객체

관련 항목:

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

현재의 Look & Feel 로부터의 값을 가지는 UI 프로퍼티를 리셋 합니다.

오버라이드(override):

클래스 JComponent 내의 updateUI

관련 항목:

UIManager.getUI(javax.swing.JComponent)

getUIClassID

public String  getUIClassID()

Look & Feel (L&F) 클래스의 이름의 구축에 사용된 접두사를 리턴합니다. 이 클래스는 이 컴퍼넌트를 렌더링 하는데 사용됩니다.

오버라이드(override):

클래스 JComponent 내의 getUIClassID

반환값:

캐릭터 라인 「ListUI」

관련 항목:

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

getPrototypeCellValue

public Object  getPrototypeCellValue()

「prototype 셀」의 셀넓이를 리턴합니다. 다른 모든 리스트 항목과 같은 값을 가지기 때문에 prototype 셀은 셀폭의 계산에 사용됩니다.

반환값:

prototypeCellValue 프로퍼티의 값

관련 항목:

setPrototypeCellValue(java.lang.Object)

setPrototypeCellValue

public void setPrototypeCellValue(Object  prototypeCellValue)

fixedCellWidth 및 fixedCellHeight 프로퍼티를 계산합니다. 인덱스 0 cellRenderer를 지정치로 설정하고 나서, 렌더링 컴퍼넌트의 우선 사이즈를 계산합니다. 리스트가 너무 길어 JList이 각 셀의 폭과 높이를 계산하지 못하고, 다른 셀과 같은 스페이스를 가지는 것을 알 수 있는 셀이 있는 경우에는 이 프로퍼티가 편리합니다.

fixedCellWidth 및 fixedCellHeight 프로퍼티를 여기서 설정해도, prototypeCellValue 만으로 PropertyChangeEvent이 트리거 되는 것에 주의해 주세요.

이 프로퍼티의 설정예를 참조하려면, 상기의 클래스의 설명을 참조하십시오.

이 프로퍼티의 기본값는 null 입니다.

이것은 JavaBeans 바운드 프로퍼티입니다.

파라미터:

prototypeCellValue - fixedCellWidth 및 fixedCellHeight 베이스가 되는 값

관련 항목:

getPrototypeCellValue(), setFixedCellWidth(int), setFixedCellHeight(int), Container.addPropertyChangeListener(java.beans.PropertyChangeListener)

getFixedCellWidth

public int getFixedCellWidth()

고정 셀폭의 값을 리턴합니다. 고정 셀폭의 값이란 리스트 요소로부터 계산된 값은 아니고, fixedCellWidth 프로퍼티로 가리키는 값입니다.

반환값:

고정 셀폭

관련 항목:

setFixedCellWidth(int)

setFixedCellWidth

public void setFixedCellWidth(int width)

리스트에 있는 모든 셀의 넓이를 설정합니다. width가 -1인 경우, 각 리스트 요소의 cellRenderer 컴퍼넌트에 getPreferredSize를 적용하는 것으로써, 셀폭이 계산됩니다.

이 프로퍼티의 기본값는 -1 입니다.

이것은 JavaBeans 바운드 프로퍼티입니다.

파라미터:

width - 픽셀 단위의, 리스트내의 모든 셀의 폭

관련 항목:

getPrototypeCellValue(), setFixedCellWidth(int), Container.addPropertyChangeListener(java.beans.PropertyChangeListener)

getFixedCellHeight

public int getFixedCellHeight()

고정 셀고의 값을 리턴합니다. 고정 셀고의 값이란 리스트 요소로부터 계산된 값은 아니고, fixedCellHeight 프로퍼티로 가리키는 값입니다.

반환값:

픽셀 단위의 고정 셀고

관련 항목:

setFixedCellHeight(int)

setFixedCellHeight

public void setFixedCellHeight(int height)

리스트에 있는 모든 셀의 높이를 설정합니다. height이 -1인 경우, 각 리스트 요소의 cellRenderer 컴퍼넌트에 getPreferredSize를 적용하는 것으로써, 셀의 높이가 계산됩니다.

이 프로퍼티의 기본값는 -1 입니다.

이것은 JavaBeans 바운드 프로퍼티입니다.

파라미터:

height - 리스트내의 모든 셀의 높이를 픽셀수로 지정하는 정수

관련 항목:

getPrototypeCellValue(), setFixedCellWidth(int), Container.addPropertyChangeListener(java.beans.PropertyChangeListener)

getCellRenderer

public ListCellRenderer  getCellRenderer()

리스트 항목을 렌더링 하는 객체를 리턴합니다.

반환값:

ListCellRenderer

관련 항목:

setCellRenderer(javax.swing.ListCellRenderer)

setCellRenderer

public void setCellRenderer(ListCellRenderer  cellRenderer)

리스트내의 각 셀을 렌더링 하는 위양을 설정합니다. prototypeCellValue가 설정되어 있으면, fixedCellWidth 및 fixedCellHeight 프로퍼티도 설정됩니다. 그러나, cellRenderer 프로퍼티에 대해서는 PropertyChangeEvent는 1개 만 생성됩니다.

이 프로퍼티의 기본값는 ListUI 위양 (Look & Feel 구현)에 의해 제공됩니다.

셀 렌더링의 설정예를 참조하려면, 상기의 클래스의 설명을 참조하십시오.

이것은 JavaBeans 바운드 프로퍼티입니다.

파라미터:

cellRenderer - 리스트내의 셀을 렌더링 하는 ListCellRenderer

관련 항목:

getCellRenderer()

getSelectionForeground

public Color  getSelectionForeground()

foreground 컬러의 선택을 리턴합니다.

반환값:

foreground 프로퍼티의 Color 객체

관련 항목:

setSelectionForeground(java.awt.Color), setSelectionBackground(java.awt.Color)

setSelectionForeground

public void setSelectionForeground(Color  selectionForeground)

선택된 셀의 foreground 컬러를 설정합니다. 셀 렌더링은 이 색을 사용해, 선택된 셀의 텍스트와 그래픽를 렌더링 합니다.

이 프로퍼티의 기본값는 Look & Feel 구현에 의해 정의됩니다.

이것은 JavaBeans 바운드 프로퍼티입니다.

파라미터:

selectionForeground - 선택된 리스트 항목의 foreground로 사용하는 Color

관련 항목:

getSelectionForeground(), setSelectionBackground(java.awt.Color), JComponent.setForeground(java.awt.Color), JComponent.setBackground(java.awt.Color), JComponent.setFont(java.awt.Font)

getSelectionBackground

public Color  getSelectionBackground()

선택된 셀의 백그라운드 컬러를 리턴합니다.

반환값:

선택된 리스트 항목의 백그라운드에서 사용하는 Color

관련 항목:

setSelectionBackground(java.awt.Color), setSelectionForeground(java.awt.Color)

setSelectionBackground

public void setSelectionBackground(Color  selectionBackground)

선택된 셀의 백그라운드 컬러를 설정합니다. 셀 렌더링은 이 색을 사용해, 선택된 셀을 전부 칠할 수 있습니다 .

이 프로퍼티의 기본값는 Look & Feel 구현에 의해 정의됩니다.

이것은 JavaBeans 바운드 프로퍼티입니다.

파라미터:

selectionBackground - 선택된 셀의 백그라운드에서 사용하는 Color

관련 항목:

getSelectionBackground(), setSelectionForeground(java.awt.Color), JComponent.setForeground(java.awt.Color), JComponent.setBackground(java.awt.Color), JComponent.setFont(java.awt.Font)

getVisibleRowCount

public int getVisibleRowCount()

가시행의 적절한 수를 리턴합니다.

반환값:

스크롤 바를 사용하지 않고 표시할 수 있는 행의 적절한 수를 나타내는 정수

관련 항목:

setVisibleRowCount(int)

setVisibleRowCount

public void setVisibleRowCount(int visibleRowCount)

스크롤 바를 사용하지 않고 표시할 수 있는 리스트내의 행의 적절한 수를 설정합니다. 이 값은 가장 가까운 JViewport 상위 객체 (존재하는 경우만)에 결정됩니다. 이 프로퍼티치는 JList preferredScrollableViewportSize값에게만 영향을 줍니다.

이 프로퍼티의 기본값는 8 입니다.

이것은 JavaBeans 바운드 프로퍼티입니다.

파라미터:

visibleRowCount - 가시행의 적절한 수를 지정하는 정수

관련 항목:

getVisibleRowCount(), JComponent.getVisibleRect(), JViewport

getLayoutOrientation

public int getLayoutOrientation()

레이아웃이 셀의 단일의 열의 경우는 JList.VERTICAL, 컨텐츠가 수직 방향의 다음에 수평 방향의 순서에 줄선 「신문 스타일」의 경우는 JList.VERTICAL_WRAP, 컨텐츠가 수평 방향의 다음에 수직 방향의 순서에 줄선 「신문 스타일」의 경우는 JList.HORIZONTAL_WRAP를 리턴합니다.

반환값:

layoutOrientation 프로퍼티의 값

도입된 버전 :

1.4

관련 항목:

setLayoutOrientation(int)

setLayoutOrientation

public void setLayoutOrientation(int layoutOrientation)

리스트의 셀의 배치 방법을 정의합니다. 4개의 셀을 가지는 JList인 경우, 다음의 방법의 어떤 것인가로 배치할 수 있습니다.

   0
   1
   2
   3
 

   0  1
   2  3
 

   0  2
   1  3
 

이것들은 다음의 값에 대응합니다.

값	설명
JList.VERTICAL	셀은 1개의 열로 수직 방향으로 배치되는
JList.HORIZONTAL_WRAP	셀은 수평 방향으로 배치되어 필요에 따라서 다음의 행에 되접어 꺾인다. 사용하는 행수는 0 보다 큰 경우 getVisibleRowCount로 정의되어 그렇지 않은 경우는 JList 폭으로 지정되는
JList.VERTICAL_WRAP	셀은 수직 방향으로 배치되어 필요에 따라서 다음의 열에 되접어 꺾인다. 사용하는 행수는 0 보다 큰 경우 getVisibleRowCount로 정의되어 그렇지 않은 경우는 JList 높이로 지정되는

이 프로퍼티의 기본값는 JList.VERTICAL 입니다.

layoutOrientation가 JList.HORIZONTAL_WRAP, JList.VERTICAL, 또는 JList.VERTICAL_WRAP 어떤 것도 아닌 경우는 IllegalArgumentException가 발생 됩니다.

파라미터:

layoutOrientation - 새로운 orientation. JList.HORIZONTAL_WRAP, JList.VERTICAL, 또는 JList.VERTICAL_WRAP 가운데 1개

도입된 버전 :

1.4

관련 항목:

getLayoutOrientation(), setVisibleRowCount(int), getScrollableTracksViewportHeight()

getFirstVisibleIndex

public int getFirstVisibleIndex()

최초의 가시 셀의 인덱스를 리턴합니다. 셀을 「최초」이다고 볼지 어떨지는 componentOrientation 프로퍼티에 합니다. 방향이, 왼쪽에서 오른쪽에의 수평 방향인 경우, 최초의 가시 셀은 리스트의 좌상구석이 되어, 금방 다른 곳으로의 수평 방향의 경우는 우상구석이 됩니다. 어느 셀도 가시가 아닌 경우나 리스트가 비어있는 경우에는 -1을 리턴합니다. 리턴된 셀은 부분적으로 가시에서도 괜찮습니다.

반환값:

최초의 가시 셀의 인덱스

관련 항목:

getLastVisibleIndex(), JComponent.getVisibleRect()

getLastVisibleIndex

public int getLastVisibleIndex()

마지막 가시 셀의 인덱스를 리턴합니다. 셀을 「최후」이다고 볼지 어떨지는 componentOrientation 프로퍼티에 합니다. 방향이, 왼쪽에서 오른쪽에의 수평 방향인 경우, 마지막 가시 셀은 JList 우하구석이 되어, 금방 다른 곳으로의 수평 방향의 경우는 왼쪽 하단 모서리가 됩니다. 어느 셀도 가시가 아닌 경우나 리스트가 비어있는 경우에는 -1을 리턴합니다. 리턴된 셀은 부분적으로 가시에서도 괜찮습니다.

반환값:

마지막 가시 셀의 인덱스

관련 항목:

getFirstVisibleIndex(), JComponent.getVisibleRect()

ensureIndexIsVisible

public void ensureIndexIsVisible(int index)

뷰포트를 스크롤 해, 지정된 셀을 완전하게 가시로 합니다. 이 메서드를 유효하게 하려면, JViewport 내에서 JList를 표시할 필요가 있습니다.

파라미터:

index - 가시로 하는 셀의 인덱스

관련 항목:

JComponent.scrollRectToVisible(java.awt.Rectangle), JComponent.getVisibleRect()

setDragEnabled

public void setDragEnabled(boolean b)

dragEnabled 프로퍼티를 설정합니다. 이 프로퍼티는 이 컴퍼넌트의 자동 드래그 처리 (드래그＆드롭의 최초의 처리)를 유효하게 하기 위해서 true가 되어 있을 필요가 있습니다. transferHandler 프로퍼티는 드래그 로 뭐든지 할 수 있도록 null 이외의 값으로 설정할 필요가 있습니다. dragEnabled 프로퍼티의 디폴트의 값은 false 입니다.

자동 드래그 처리가 유효의 경우, 대부분의 Look & Feel는 사용자가 선택을 위해서 mouse button를 눌러, 마우스를 수픽셀 이동하면 항상 드래그＆드롭 조작이 시작됩니다. 따라서, 이 프로퍼티를 true로 설정하는 것으로써, 선택의 동작에 미묘한 효과가 있습니다.

일부의 Look & Feel는 자동 드래그＆드롭 조작을 지원 하지 않는 경우가 있습니다. 이것들은 이 프로퍼티를 무시합니다. 직접 TransferHandler exportAsDrag 메서드를 호출해 컴퍼넌트를 변경하는 것으로써, 이러한 Look & Feel를 조작할 수 있습니다 .

파라미터:

b - dragEnabled 프로퍼티로 설정되는 값

예외:

HeadlessException - b가 true인 경우로 GraphicsEnvironment.isHeadless()가 true를 돌려주는 경우

도입된 버전 :

1.4

관련 항목:

GraphicsEnvironment.isHeadless(), getDragEnabled(), JComponent.setTransferHandler(javax.swing.TransferHandler), TransferHandler

getDragEnabled

public boolean getDragEnabled()

dragEnabled 프로퍼티를 취득합니다.

반환값:

dragEnabled 프로퍼티의 값

도입된 버전 :

1.4

관련 항목:

setDragEnabled(boolean)

getNextMatch

public int getNextMatch(String  prefix,
                        int startIndex,
                        Position.Bias  bias)

접두사로 시작되는 다음의 리스트 요소를 리턴합니다.

파라미터:

prefix - 일치를 테스트하는 캐릭터 라인

startIndex - 검색을 개시하는 인덱스

bias - 검색 방향. Position.Bias.Forward 또는 Position.Bias.Backward

반환값:

접두사로 시작되는 다음의 리스트 요소의 인덱스. 그렇지 않은 경우는 -1

예외:

IllegalArgumentException - 접두사가 null 또는 startIndex가 범위외에 있는 경우

도입된 버전 :

1.4

getToolTipText

public String  getToolTipText(MouseEvent  event)

JComponent getToolTipText 메서드를 오버라이드(override) 해, 텍스트 세트가 있는 경우, 렌더링의 힌트를 사용할 수 있도록 합니다.

주: JList이 렌더링의 툴 힌트를 적절히 표시할 수 있도록 하려면, JList는 ToolTipManager에 등록을 마친 컴퍼넌트가 아니면 안됩니다. 이것은 생성자 으로 자동적으로 행해집니다만, 나중에 JList에 setToolTipText(null)를 통지하면, 리스트 컴퍼넌트를 등록 해제하므로 렌더링으로부터의 힌트는 그 이상 표시되지 않습니다.

오버라이드(override):

클래스 JComponent 내의 getToolTipText

관련 항목:

JComponent.getToolTipText()

locationToIndex

public int locationToIndex(Point  location)

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

파라미터:

location - JList에 관련한 셀의 좌표

반환값:

정수 -- 지정 위치의 셀의 인덱스, 또는 -1

indexToLocation

public Point  indexToLocation(int index)

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

파라미터:

index - JList 셀의 인덱스

반환값:

index 로 지정된 번호의 셀의 원점

getCellBounds

public Rectangle  getCellBounds(int index0,
                               int index1)

JList 좌표로 지정된 항목 범위의 경계를 리턴합니다. 인덱스가 무효인 경우는 null을 리턴합니다.

파라미터:

index0 - 범위내의 최초의 JList 셀의 인덱스

index1 - 범위내의 마지막 JList 셀의 인덱스

반환값:

인덱스로 지정된 셀의 픽셀 단위의 경계

getModel

public ListModel  getModel()

JList 컴퍼넌트에 의해 표시되는 항목의 리스트를 보관 유지하는 데이터 모델을 리턴합니다.

반환값:

표시되는 항목의 리스트를 제공하는 ListModel

관련 항목:

setModel(javax.swing.ListModel)

setModel

public void setModel(ListModel  model)

리스트의 내용 또는 「값」을 나타내는 모델을 설정해, PropertyChangeListener에 의 통지 후에 리스트의 선택 범위를 클리어 합니다.

이것은 JavaBeans 바운드 프로퍼티입니다.

파라미터:

model - 표시되는 항목의 리스트를 제공하는 ListModel

예외:

IllegalArgumentException - model가 null인 경우

관련 항목:

getModel()

setListData

public void setListData(Object [] listData)

Object 배열로부터 ListModel을 구축해, setModel을 적용합니다.

파라미터:

listData - 리스트에 표시하는 항목을 보관 유지하는 Object 배열

관련 항목:

setModel(javax.swing.ListModel)

setListData

public void setListData(Vector <? > listData)

Vector로 부터 ListModel을 구축해, setModel을 적용합니다.

파라미터:

listData - 리스트에 표시하는 항목을 보관 유지하는 Vector

관련 항목:

setModel(javax.swing.ListModel)

createSelectionModel

protected ListSelectionModel  createSelectionModel()

DefaultListSelectionModel 인스턴스를 리턴합니다. 이 메서드는 생성자가 selectionModel 프로퍼티를 초기화하는데 사용합니다.

반환값:

이 JList이 사용하는 ListSelectionModel

관련 항목:

setSelectionModel(javax.swing.ListSelectionModel), DefaultListSelectionModel

getSelectionModel

public ListSelectionModel  getSelectionModel()

현재의 선택 모델의 값을 리턴합니다. 선택 모델은 단일 선택, 인접한 범위의 선택 및 비인접 선택의 작성 태스크를 처리합니다.

반환값:

리스트 선택을 구현하는 ListSelectionModel

관련 항목:

setSelectionModel(javax.swing.ListSelectionModel), ListSelectionModel

fireSelectionValueChanged

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

선택 모델이 변경된 것을 JList ListSelectionListener에 통지합니다. 이 메서드는 ListSelectionEvent를 selectionModel로 부터, 직접 JList에 추가된 ListSelectionListener에 전송 하기 위해서 사용됩니다.

파라미터:

firstIndex - 선택되고 있는 최초의 인덱스

lastIndex - 선택되고 있는 마지막 인덱스

isAdjusting - 복수의 변경을 했을 경우는 true

관련 항목:

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

addListSelectionListener

public void addListSelectionListener(ListSelectionListener  listener)

선택이 변경될 때마다 통지되는 리스트에 리스너를 추가합니다. JList에 직접 추가되는 리스너는 (ListSelectionModel 대신에) ListSelectionEvent.getSource() (이 JList)를 가집니다.

파라미터:

listener - 추가하는 ListSelectionListener

관련 항목:

getSelectionModel(), getListSelectionListeners()

removeListSelectionListener

public void removeListSelectionListener(ListSelectionListener  listener)

선택이 변경될 때마다 통지되는 리스너를 리스트로부터 삭제합니다.

파라미터:

listener - 삭제하는 ListSelectionListener

관련 항목:

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

getListSelectionListeners

public ListSelectionListener [] getListSelectionListeners()

이 JList에 addListSelectionListener()로 추가된 모든 ListSelectionListener 배열을 리턴합니다.

반환값:

추가된 모든 ListSelectionListener. 추가된 리스너가 없는 경우는 비어있는 배열

도입된 버전 :

1.4

관련 항목:

addListSelectionListener(javax.swing.event.ListSelectionListener)

setSelectionModel

public void setSelectionModel(ListSelectionModel  selectionModel)

리스트의 selectionModel을 null이 아닌 ListSelectionModel 구현으로 설정합니다. 선택 모델은 단일 선택, 인접한 범위의 선택 및 비인접 선택을 작성하는 태스크를 처리합니다.

이것은 JavaBeans 바운드 프로퍼티입니다.

파라미터:

selectionModel - 선택을 구현하는 ListSelectionModel

예외:

IllegalArgumentException - selectionModel가 null인 경우

관련 항목:

getSelectionModel()

setSelectionMode

public void setSelectionMode(int selectionMode)

단일 항목 선택 또는 복수 항목 선택이 가능한가 어떤가를 판정합니다. 다음의 selectionMode값을 지정할 수 있습니다.

• ListSelectionModel.SINGLE_SELECTION - 1회에 1개의 리스트 인덱스만을 선택할 수 있습니다. 이 모드에서는 setSelectionInterval 및 addSelectionInterval 메서드는 동등이 되어, 2번째의 인덱스 인수만이 사용됩니다.
• ListSelectionModel.SINGLE_INTERVAL_SELECTION - 연속하는 인덱스 구간을 1회에 1개 선택할 수 있습니다. 이 모드에서는 setSelectionInterval 메서드와 addSelectionInterval 메서드는 동등합니다.
• ListSelectionModel.MULTIPLE_INTERVAL_SELECTION - 이 모드에서는 선택 대상으로 제한은 없습니다. 이것이 디폴트입니다.

파라미터:

selectionMode - 가능한 선택 타입을 지정하는 정수

관련 항목:

getSelectionMode()

getSelectionMode

public int getSelectionMode()

단일 항목 선택 또는 복수 항목 선택의 어느 쪽이 허용 되고 있을까를 리턴합니다.

반환값:

selectionMode 프로퍼티의 값

관련 항목:

setSelectionMode(int)

getAnchorSelectionIndex

public int getAnchorSelectionIndex()

마지막 addSelectionModel 또는 setSelectionInterval 호출해에 있어서의 최초의 인덱스 인수를 리턴합니다. selectionModel에 위양 하는 간이 메서드입니다.

반환값:

마지막 구간 선택의 선두를 나타내는 인덱스

관련 항목:

ListSelectionModel.getAnchorSelectionIndex(), addSelectionInterval(int, int), setSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)

getLeadSelectionIndex

public int getLeadSelectionIndex()

마지막 addSelectionInterval 또는 setSelectionInterval 호출해에 있어서의 2번째의 인덱스 인수를 리턴합니다. selectionModel에 위양 하는 간이 메서드입니다.

반환값:

마지막 구간 선택의 말미를 나타내는 인덱스

관련 항목:

ListSelectionModel.getLeadSelectionIndex(), addSelectionInterval(int, int), setSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)

getMinSelectionIndex

public int getMinSelectionIndex()

선택되고 있는 셀의 최소 인덱스를 리턴합니다. selectionModel에 위양 하는 간이 메서드입니다.

반환값:

선택되고 있는 셀의 최소 인덱스

관련 항목:

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

getMaxSelectionIndex

public int getMaxSelectionIndex()

선택되고 있는 셀의 최대 인덱스를 리턴합니다. selectionModel에 위양 하는 간이 메서드입니다.

반환값:

선택되고 있는 셀의 최대 인덱스

관련 항목:

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

isSelectedIndex

public boolean isSelectedIndex(int index)

지정된 인덱스가 선택되고 있는 경우는 true를 리턴합니다. selectionModel에 위양 하는 간이 메서드입니다.

파라미터:

index - 선택 상태가 조회되는 인덱스

반환값:

지정의 인덱스가 선택되고 있는 경우는 true

관련 항목:

ListSelectionModel.isSelectedIndex(int), setSelectedIndex(int), addListSelectionListener(javax.swing.event.ListSelectionListener)

isSelectionEmpty

public boolean isSelectionEmpty()

아무것도 선택되어 있지 않은 경우는 true를 리턴합니다. selectionModel에 위양 하는 간이 메서드입니다.

반환값:

아무것도 선택되어 있지 않은 경우는 true

관련 항목:

ListSelectionModel.isSelectionEmpty(), clearSelection(), addListSelectionListener(javax.swing.event.ListSelectionListener)

clearSelection

public void clearSelection()

선택을 클리어 합니다. 이 메서드를 호출한 뒤는 isSelectionEmpty는 true를 리턴합니다. selectionModel에 위양 하는 간이 메서드입니다.

관련 항목:

ListSelectionModel.clearSelection(), isSelectionEmpty(), addListSelectionListener(javax.swing.event.ListSelectionListener)

setSelectionInterval

public void setSelectionInterval(int anchor,
                                 int lead)

지정된 구간을 선택합니다. anchor 및 lead인덱스가 포함됩니다. anchor가 lead 보다 작지 않아도 괜찮습니다. selectionModel에 위양 하는 간이 메서드입니다. anchor 또는 lead가 -1인 경우, DefaultListSelectionModel 구현은 아무것도 실시하지 않습니다. anchor 또는 lead가 -1 미만의 경우, IndexOutOfBoundsException가 발생 됩니다.

파라미터:

anchor - 선택하는 최초의 인덱스

lead - 선택하는 마지막 인덱스

예외:

IndexOutOfBoundsException - anchor 또는 lead가 -1 미만의 경우

관련 항목:

ListSelectionModel.setSelectionInterval(int, int), addSelectionInterval(int, int), removeSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)

addSelectionInterval

public void addSelectionInterval(int anchor,
                                 int lead)

지정된 구간을 현재의 선택에 가세합니다. 선두 및 최종 인덱스가 포함됩니다. 선두 인덱스가 최종 인덱스보다 작지 않아도 괜찮습니다. selectionModel에 위양 하는 간이 메서드입니다. anchor 또는 lead가 -1인 경우, DefaultListSelectionModel 구현은 아무것도 실시하지 않습니다. anchor 또는 lead가 -1 미만의 경우, IndexOutOfBoundsException가 발생 됩니다.

파라미터:

anchor - 선택에 추가하는 최초의 인덱스

lead - 선택에 추가하는 마지막 인덱스

예외:

IndexOutOfBoundsException - anchor 또는 lead가 -1 미만의 경우

관련 항목:

ListSelectionModel.addSelectionInterval(int, int), setSelectionInterval(int, int), removeSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)

removeSelectionInterval

public void removeSelectionInterval(int index0,
                                    int index1)

선택 범위를, 지정된 구간과 현재의 선택 범위와의 차이 집합으로 설정합니다. index0 및 index1인덱스가 삭제됩니다. index0가 index1 보다 작지 않아도 괜찮습니다. selectionModel에 위양 하는 간이 메서드입니다. index0 또는 index1가 -1인 경우, DefaultListSelectionModel 구현은 아무것도 실시하지 않습니다. index0 또는 index1가 -1 미만의 경우, IndexOutOfBoundsException가 발생 됩니다.

파라미터:

index0 - 선택으로부터 삭제하는 최초의 인덱스

index1 - 선택으로부터 삭제하는 마지막 인덱스

예외:

IndexOutOfBoundsException - index0 또는 index1가 -1 미만의 경우

관련 항목:

ListSelectionModel.removeSelectionInterval(int, int), setSelectionInterval(int, int), addSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

데이터 모델의 isAdjusting 프로퍼티를 true 로 설정해, 모든 선택 이벤트 (선택 모드로 리스트 항목상을 마우스로 드래그 하고 있는 경우등)가 완료한 시점에서 단일 이벤트가 생성되도록 합니다.

파라미터:

b - 프로퍼티치의 boolean 치

관련 항목:

ListSelectionModel.setValueIsAdjusting(boolean)

getValueIsAdjusting

public boolean getValueIsAdjusting()

데이터 모델의 isAdjusting 프로퍼티의 값을 리턴합니다. 복수의 변경을 하고 있는 경우에는 true를 리턴합니다.

반환값:

복수의 선택 변경이 발생하고 있는 경우 (리스트 항목상을 마우스로 드래그 하고 있는 경우등)는 true

관련 항목:

ListSelectionModel.getValueIsAdjusting()

getSelectedIndices

public int[] getSelectedIndices()

선택 떠날 수 있어 모든 인덱스의 승순 배열을 리턴합니다.

반환값:

선택 떠날 수 있어 모든 인덱스 (승순)

관련 항목:

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

setSelectedIndex

public void setSelectedIndex(int index)

단일 셀을 선택합니다.

파라미터:

index - 선택하는 단일 셀의 인덱스

관련 항목:

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

setSelectedIndices

public void setSelectedIndices(int[] indices)

셀세트를 선택합니다.

파라미터:

indices - 선택하는 셀의 인덱스의 배열

관련 항목:

ListSelectionModel.addSelectionInterval(int, int), isSelectedIndex(int), addListSelectionListener(javax.swing.event.ListSelectionListener)

getSelectedValues

public Object [] getSelectedValues()

선택된 셀의 값의 배열을 리턴합니다. 값은 인덱스의 승순에 늘어놓을 수 있습니다.

반환값:

선택된 값. 아무것도 선택되어 있지 않은 경우는 비어있는 리스트

관련 항목:

isSelectedIndex(int), getModel(), addListSelectionListener(javax.swing.event.ListSelectionListener)

getSelectedIndex

public int getSelectedIndex()

최초로 선택된 인덱스를 돌려주는지, 선택 항목이 없는 경우는 -1을 리턴합니다.

반환값:

getMinSelectionIndex값

관련 항목:

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

getSelectedValue

public Object  getSelectedValue()

최초로 선택된 인덱스를 돌려주는지, 선택이 비어있는 경우는 null을 리턴합니다.

반환값:

최초로 선택된 값

관련 항목:

getMinSelectionIndex(), getModel(), addListSelectionListener(javax.swing.event.ListSelectionListener)

setSelectedValue

public void setSelectedValue(Object  anObject,
                             boolean shouldScroll)

지정된 객체를 리스트로부터 선택합니다.

파라미터:

anObject - 선택하는 객체

shouldScroll - 객체가 존재해, 리스트를 스크롤의해 선택한 객체를 표시하는 경우는 true. 그렇지 않은 경우는 false

getPreferredScrollableViewportSize

public Dimension  getPreferredScrollableViewportSize()

visibleRowCount 행을 표시하기 위해서 필요한 뷰포트의 사이즈를 계산합니다. fixedCellWidth 및 fixedCellHeight 프로퍼티가 가리키는 경우에는 이 사이즈는 분명합니다. 이러한 프로퍼티치는 prototypeCellValue 프로퍼티에 의해 암묵으로 지정되는 일도 있습니다. fixedCellWidth가 지정되어 있지 않은 경우에는 이 사이즈는 가장 폭의 넓은 리스트 요소를 찾아내는 것에 의해 계산됩니다. fixedCellHeight이 지정되어 있지 않은 경우에는 다음과 같이의해 휴리스틱에 결착됩니다.

• 모델이 비어있지 않다면, 선두행의 높이를 visibleRowCount에 의해 곱셈합니다.
• 모델이 비어있다면 (JList.getModel(). getSize() == 0 이면), 가시행 근처 16 픽셀을 할당해 폭에 (fixedCellWidth가 설정되어 있지 않으면) 256 픽셀을 할당해 최선의 결과를 기대합니다.

레이아웃 방향이 VERTICAL가 아닌 경우, getPreferredSize로 부터의 값을 리턴합니다. 현재의 ListUI에 의해 적절한 값을 돌려주도록 getPreferredSize가 오버라이드(override) 되는 것이 예상됩니다.

정의:

인터페이스 Scrollable 내의 getPreferredScrollableViewportSize

반환값:

visibleRowCount 행의 표시에 필요한 뷰포트의 사이즈를 포함한 크기

관련 항목:

getPreferredScrollableViewportSize(), setPrototypeCellValue(java.lang.Object)

getScrollableUnitIncrement

public int getScrollableUnitIncrement(Rectangle  visibleRect,
                                      int orientation,
                                      int direction)

다음 또는 전의 행 (수직 스크롤) 또는 열 (수평 스크롤)을 표시하기 위해서 스크롤 하는 거리를 리턴합니다.

수평 방향의 스크롤에서는 리스트가 수직 방향으로 배치되고 있는 (orientation가 VERTICAL) 경우, 리스트의 font size가 리턴됩니다 . 폰트가 null인 경우는 1 이 리턴됩니다 .

visibleRect값은, this.getVisibleRect()와 같지 않으면 안됩니다.

정의:

인터페이스 Scrollable 내의 getScrollableUnitIncrement

파라미터:

visibleRect - 가시 구형

orientation - HORIZONTAL 또는 VERTICAL

direction - 0 아래의 경우는 위에 스크롤, 0 보다 큰 경우는 아래에 스크롤

반환값:

다음 또는 전의 행을 표시하기 위해서 스크롤 하는 픽셀 단위의 거리

예외:

IllegalArgumentException - visibleRect가 null인 경우, 혹은 orientation가 SwingConstants.VERTICAL 또는 SwingConstants.HORIZONTAL 어느 쪽인지 나오지 않는 경우

관련 항목:

Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int)

getScrollableBlockIncrement

public int getScrollableBlockIncrement(Rectangle  visibleRect,
                                       int orientation,
                                       int direction)

다음 또는 전의 블록을 표시하기 위해서 스크롤 하는 거리를 리턴합니다. 수직 방향의 스크롤에는 다음의 룰을 사용합니다.

• 아래에 스크롤 하는 (direction가 0 보다 크다) 경우는 마지막 가시 요소가 최초의 완전한 가시 요소가 된다
• 위에 스크롤 하는 경우는 최초의 가시 요소가 마지막 완전한 가시 요소가 된다
• 리스트가 비어있는 경우는 visibleRect.height

수평 방향의 스크롤에는 리스트가 수평 방향으로 배치되고 있는 경우 (orientation가 VERTICAL_WRAP 또는 HORIZONTAL_WRAP), 다음의 룰을 사용합니다.

오른쪽으로 스크롤 하는 (direction가 0 보다 크다) 경우는 마지막 가시 요소가 최초의 완전한 가시 요소가 된다

왼쪽으로 스크롤 하는 경우는 최초의 가시 요소가 마지막 완전한 가시 요소가 된다

리스트가 비어있는 경우는 visibleRect.width

리스트가 수직 방향으로 배치되고 있는 경우는 visibleRect.width를 리턴합니다.

visibleRect값은, this.getVisibleRect()와 같지 않으면 안됩니다.

정의:

인터페이스 Scrollable 내의 getScrollableBlockIncrement

파라미터:

visibleRect - 가시 구형

orientation - HORIZONTAL 또는 VERTICAL

direction - 0 아래의 경우는 위에 스크롤, 0 보다 큰 경우는 아래에 스크롤

반환값:

블록의 증분량

예외:

IllegalArgumentException - visibleRect가 null인 경우, 혹은 orientation가 SwingConstants.VERTICAL 또는 SwingConstants.HORIZONTAL 어느 쪽인지 나오지 않는 경우

관련 항목:

Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int)

getScrollableTracksViewportWidth

public boolean getScrollableTracksViewportWidth()

이 JList이 JViewport에 표시되어 뷰포트가 JList 적절한 폭보다 넓은 경우, 또는 레이아웃 방향이 HORIZONTAL_WRAP 이며, 가시행 카운트가 <= 0인 경우는 true를 리턴합니다. 그렇지 않은 경우는 false를 리턴합니다. false인 경우, 뷰포트의 넓이를 추적하지 않습니다. 이것에 의해 JViewport 자체가 JScrollPane에 삽입되어 있는 경우, 수평 스크롤이 생기게 됩니다.

정의:

인터페이스 Scrollable 내의 getScrollableTracksViewportWidth

반환값:

뷰포트가 JList 적절한 폭보다 넓은 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Scrollable.getScrollableTracksViewportWidth()

getScrollableTracksViewportHeight

public boolean getScrollableTracksViewportHeight()

이 JList이 JViewport에 표시되어 뷰포트가 JList 적절한 높이보다 높은 경우, 또는 레이아웃 방향이 VERTICAL_WRAP 이며, 가시행 카운트가 0 아래의 경우는 true를 리턴합니다. 그렇지 않은 경우는 false를 리턴합니다. false인 경우, 뷰포트의 높이를 추적하지 않습니다. 이것에 의해 JViewport 자체가 JScrollPane에 삽입되어 있는 경우, 수직 스크롤이 생기게 됩니다.

정의:

인터페이스 Scrollable 내의 getScrollableTracksViewportHeight

반환값:

뷰포트가 Jlist 적절한 높이보다 높은 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Scrollable.getScrollableTracksViewportHeight()

paramString

protected String  paramString()

이 JList 캐릭터 라인 표현을 리턴합니다. 이 메서드는 디버그 전용이며, 리턴된 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 리턴된 캐릭터 라인은 비어있는 경우가 있습니다만, null로는 되지 않습니다.

오버라이드(override):

클래스 JComponent 내의 paramString

반환값:

이 JList 캐릭터 라인 표현

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 JList에 관련한 AccessibleContext를 리턴합니다. JList인 경우, AccessibleContext는 AccessibleJList 형식을 취합니다. 필요에 따라서 새로운의 AccessibleJList 인스턴스가 작성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 JComponent 내의 getAccessibleContext

반환값:

이 JList AccessibleContext 로서 기능하는 AccessibleJList