JavaTM 2
Platform
Std.  Ed.  v1. 4.0

javax.swing
클래스 JList

java.lang.Object 
  |
  +--java.awt.Component 
        |
        +--java.awt.Container 
              |
              +--javax.swing.JComponent 
                    |
                    +--javax.swing.JList
모든 구현 인터페이스:
Accessible , ImageObserver , MenuContainer , Scrollable , Serializable

public class JList
extends JComponent
implements Scrollable , Accessible

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

// 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 는 스크롤을 직접 서포트하고 있습니다. 스크롤 리스트를 작성하려면 ,JListJScrollPane 의 뷰포트뷰로서 설정합니다. 다음에 예를 나타냅니다.

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

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

String[] data = {"one", "two", "three", "four"};
JList dataList = new JList(data);
dataList.setSelectedIndex(1);  // select "two"
dataList.getSelectedValue();   // returns "two"

JList 의 내용은 동적입니다. 즉,JList 의 작성 후에 리스트 요소의 값이나 리스트의 사이즈를 변경할 수 있습니다. JListswing.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");

JListcellRenderer 를 호출하는 delegate에 의해 제공되는 java.awt.Component 를 사용해, 리스트내에서 가시 셀을 표현 합니다. 가시의 각 행은 셀 렌더링 컴퍼넌트를 「고무 스탬프」와 같이 사용해 표현 됩니다. 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 를 이용하면 그것들을 간단하게 처리할 수가 있습니다. 클릭된 셀을 조사하려면 ,JListlocationToIndex() 메소드를 사용합니다. 다음에 예를 나타냅니다.

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 가 되고 있습니다.

표준의 Look & Feel (L&F) 표현으로 이 컴퍼넌트가 사용하는 키보드의 키에 대해서는 JList 의 키의 할당을 참조해 주세요.

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

자세한 것은 「The Java Tutorial」「How to Use Lists」를 참조해 주세요. 또,「The Swing Connection」「Advanced JList Programming」도 참조해 주세요.

관련 항목:
ListModel , AbstractListModel , DefaultListModel , ListSelectionModel , DefaultListSelectionModel , ListCellRenderer

중첩된 클래스의 개요
protected  class JList.AccessibleJList
          이 클래스는 JList 클래스용의 유저 보조 기능의 서포트를 구현하고 있습니다.
 
클래스 javax.swing. JComponent 을 상속받은 중첩된 클래스
 
클래스 java.awt. Container 을 상속받은 중첩된 클래스
 
클래스 java.awt. Component 을 상속받은 중첩된 클래스
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)
          선택 모델이 변경된 것을 JListListSelectionListener 에 통지합니다.
 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 ()
          이 JListJViewport 에 표시되어 뷰포트가 JList 의 적절한 높이보다 높은 경우, 또는 레이아웃 방향이 VERTICAL_WRAP 이며, 가시행 카운트가 <= 0 의 경우는 true 를 돌려줍니다.
 boolean getScrollableTracksViewportWidth ()
          이 JListJViewport 에 표시되어 뷰포트가 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)
          JComponentgetToolTipText 메소드를 오버라이드(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)
          리스트내의 각 셀을 표현 하는 delegate을 설정합니다.
 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)
          fixedCellWidthfixedCellHeight 프로퍼티를 계산합니다.
 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)
          리스트의 selectionModelnull 가 아닌 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 , addPropertyChangeListener , addPropertyChangeListener , addVetoableChangeListener , computeVisibleRect , contains , createToolTip , disable , enable , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , fireVetoableChange , getActionForKeyStroke , getActionMap , getAlignmentX , getAlignmentY , getAncestorListeners , getAutoscrolls , getBorder , getBounds , getClientProperty , getComponentGraphics , getConditionForKeyStroke , getDebugGraphicsOptions , getDefaultLocale , getGraphics , getHeight , getInputMap , getInputMap , getInputVerifier , getInsets , getInsets , getListeners , getLocation , getMaximumSize , getMinimumSize , getNextFocusableComponent , getPreferredSize , getPropertyChangeListeners , getPropertyChangeListeners , getRegisteredKeyStrokes , getRootPane , getSize , getToolTipLocation , getToolTipText , getTopLevelAncestor , getTransferHandler , getVerifyInputWhenFocusTarget , getVetoableChangeListeners , getVisibleRect , getWidth , getX , getY , grabFocus , isDoubleBuffered , isLightweightComponent , isManagingFocus , isMaximumSizeSet , isMinimumSizeSet , isOpaque , isOptimizedDrawingEnabled , isPaintingTile , isPreferredSizeSet , isRequestFocusEnabled , isValidateRoot , paint , paintBorder , paintChildren , paintComponent , paintImmediately , paintImmediately , print , printAll , printBorder , printChildren , printComponent , processComponentKeyEvent , processKeyBinding , processKeyEvent , processMouseMotionEvent , putClientProperty , registerKeyboardAction , registerKeyboardAction , removeAncestorListener , removeNotify , removePropertyChangeListener , removePropertyChangeListener , removeVetoableChangeListener , repaint , repaint , requestDefaultFocus , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , resetKeyboardActions , reshape , revalidate , scrollRectToVisible , setActionMap , setAlignmentX , setAlignmentY , setAutoscrolls , setBackground , setBorder , setDebugGraphicsOptions , setDefaultLocale , setDoubleBuffered , setEnabled , setFont , setForeground , 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 , applyComponentOrientation , areFocusTraversalKeysSet , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getContainerListeners , getFocusTraversalKeys , getFocusTraversalPolicy , getLayout , insets , invalidate , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicySet , layout , list , list , locate , minimumSize , paintComponents , preferredSize , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , setFocusCycleRoot , setFocusTraversalKeys , setFocusTraversalPolicy , 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 , getBackground , getBounds , getColorModel , getComponentListeners , getComponentOrientation , getCursor , getDropTarget , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeysEnabled , getFont , getFontMetrics , getForeground , getGraphicsConfiguration , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getInputMethodRequests , getKeyListeners , getLocale , getLocation , getLocationOnScreen , getMouseListeners , getMouseMotionListeners , getMouseWheelListeners , getName , getParent , getPeer , getSize , getToolkit , getTreeLock , gotFocus , handleEvent , hasFocus , hide , imageUpdate , inside , isBackgroundSet , isCursorSet , isDisplayable , isEnabled , isFocusable , isFocusOwner , isFocusTraversable , isFontSet , isForegroundSet , isLightweight , 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 , processMouseEvent , processMouseWheelEvent , remove , removeComponentListener , removeFocusListener , removeHierarchyBoundsListener , removeHierarchyListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removeMouseWheelListener , 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 constructor 은 이 오브젝트에 delegate 합니다.

파라미터:
dataModel - 이 리스트의 데이터 모델
예외:
IllegalArgumentException - dataModelnull 의 경우

JList

public JList(Object [] listData)
지정된 배열의 요소를 표시하는 JList 를 구축합니다. 이 constructor 은 ListModel constructor 에 delegate 합니다.

파라미터:
listData - 데이터 모델에 로드 되는 Object 의 배열

JList

public JList(Vector  listData)
지정된 Vector 의 요소를 표시하는 JList 를 구축합니다. 이 constructor 은 ListModel constructor 에 delegate 합니다.

파라미터:
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)
fixedCellWidthfixedCellHeight 프로퍼티를 계산합니다. 인덱스 0 의 cellRenderer 를 지정치로 설정하고 나서, 렌더링 컴퍼넌트의 우선 사이즈를 계산합니다. 리스트가 너무 길어 JList 가 각 셀의 폭과 높이를 계산하지 못하고, 다른 셀과 같은 스페이스를 가지는 것을 알 수 있고 있는 셀이 있는 경우에는 이 프로퍼티가 편리합니다.

fixedCellWidthfixedCellHeight 프로퍼티를 여기서 설정해도,prototypeCellValue 만으로 PropertyChangeEvent 가 방아쇠 되는 것에 주의해 주세요.

이 프로퍼티의 설정예를 참조하려면 , 상기의클래스의 설명을 참조해 주세요.

이 프로퍼티의 디폴트 값은 null 입니다.

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

파라미터:
prototypeCellValue - fixedCellWidthfixedCellHeight 의 베이스가 되는 값
관련 항목:
getPrototypeCellValue() , setFixedCellWidth(int) , setFixedCellHeight(int) , JComponent.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) , JComponent.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) , JComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)

getCellRenderer

public ListCellRenderer  getCellRenderer()
리스트 항목을 표현 하는 오브젝트를 돌려줍니다.

반환값:
ListCellRenderer
관련 항목:
setCellRenderer(javax.swing.ListCellRenderer)

setCellRenderer

public void setCellRenderer(ListCellRenderer  cellRenderer)
리스트내의 각 셀을 표현 하는 delegate을 설정합니다. prototypeCellValue 가 설정되어 있으면,fixedCellWidthfixedCellHeight 프로퍼티도 설정됩니다. 그러나,cellRenderer 프로퍼티에 대해서는 PropertyChangeEvent 는 1 개만 생성됩니다.

이 프로퍼티의 디폴트 값은 ListUI delegate (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 의 상위 오브젝트 (존재하는 경우만)에 의해 결정됩니다. 이 프로퍼티치는 JListpreferredScrollableViewportSize 의 값에게만 영향을 줍니다.

이 프로퍼티의 디폴트 값은 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 입니다.

layoutOrientationJList.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 도 있어, 그 경우 이 프로퍼티는 무시됩니다. 서포트하고 있지 않는 Look & Feel 를 회피하려면 ,TransferHandlerexportAsDrag 메소드를 직접 호출해 컴퍼넌트를 변경합니다.

파라미터:
b - dragEnabled 프로퍼티로 설정하는 값
예외:
HeadlessException - btrue 또한 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)
JComponentgetToolTipText 메소드를 오버라이드(override) 해, 렌더링의 힌트 (텍스트 세트가 있는 경우)를 사용할 수 있게 합니다.

주: JList 가 렌더링의 툴 힌트를 적절히 표시할 수 있게 하려면 ,JListToolTipManager 에 등록을 마친 컴퍼넌트가 아니면 안됩니다. 이것은 constructor 으로 자동적으로 행해집니다만, 나중에 JListsetToolTipText(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 - modelnull 의 경우
관련 항목:
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 의 인스턴스를 돌려줍니다. 이 메소드는 constructor 이 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)
선택 모델이 변경된 것을 JListListSelectionListener 에 통지합니다. 이 메소드는 ListSelectionEventselectionModel 로부터, 직접 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()

removeListSelectionListener

public void removeListSelectionListener(ListSelectionListener  listener)
선택이 변경될 때마다 통지되는 청취자를 리스트로부터 삭제합니다.

파라미터:
listener - 삭제하는 ListSelectionListener
관련 항목:
addListSelectionListener(javax.swing.event.ListSelectionListener) , getSelectionModel()

getListSelectionListeners

public ListSelectionListener [] getListSelectionListeners()
이 JList 에 addListSelectionListener()로 추가된 모든 ListSelectionListener 의 배열을 돌려줍니다.

반환값:
추가된 모든 ListSelectionListener. 추가된 청취자가 없는 경우는 하늘의 배열
도입된 버젼:
1.4

setSelectionModel

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

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

파라미터:
selectionModel - 선택을 구현하는 ListSelectionModel
예외:
IllegalArgumentException - selectionModelnull 의 경우
관련 항목:
getSelectionModel()

setSelectionMode

public void setSelectionMode(int selectionMode)
단일 항목 선택 또는 복수 항목 선택이 가능한가 어떤가를 판정합니다. 다음의 selectionMode 치를 지정할 수 있습니다.

파라미터:
selectionMode - 가능한 선택 타입을 지정하는 정수
관련 항목:
getSelectionMode()

getSelectionMode

public int getSelectionMode()
단일 항목 선택 또는 복수 항목 선택의 어느 쪽이 허용 되고 있을까를 돌려줍니다.

반환값:
selectionMode 프로퍼티의 값
관련 항목:
setSelectionMode(int)

getAnchorSelectionIndex

public int getAnchorSelectionIndex()
마지막 addSelectionModel 또는 setSelectionInterval 호출해에 있어서의 최초의 인덱스 인수를 돌려줍니다. selectionModel 에 delegate 하는 간이 메소드입니다.

반환값:
마지막 구간 선택의 선두를 나타내는 인덱스
관련 항목:
ListSelectionModel.getAnchorSelectionIndex() , addSelectionInterval(int, int) , setSelectionInterval(int, int) , addListSelectionListener(javax.swing.event.ListSelectionListener)

getLeadSelectionIndex

public int getLeadSelectionIndex()
마지막 addSelectionInterval 또는 setSelectionInterval 호출해에 있어서의 2 번째의 인덱스 인수를 돌려줍니다. selectionModel 에 delegate 하는 간이 메소드입니다.

반환값:
마지막 구간 선택의 말미를 나타내는 인덱스
관련 항목:
ListSelectionModel.getLeadSelectionIndex() , addSelectionInterval(int, int) , setSelectionInterval(int, int) , addListSelectionListener(javax.swing.event.ListSelectionListener)

getMinSelectionIndex

public int getMinSelectionIndex()
선택되고 있는 셀의 최소 인덱스를 돌려줍니다. selectionModel 에 delegate 하는 간이 메소드입니다.

반환값:
선택되고 있는 셀의 최소 인덱스
관련 항목:
ListSelectionModel.getMinSelectionIndex() , addListSelectionListener(javax.swing.event.ListSelectionListener)

getMaxSelectionIndex

public int getMaxSelectionIndex()
선택되고 있는 셀의 최대 인덱스를 돌려줍니다. selectionModel 에 delegate 하는 간이 메소드입니다.

반환값:
선택되고 있는 셀의 최대 인덱스
관련 항목:
ListSelectionModel.getMaxSelectionIndex() , addListSelectionListener(javax.swing.event.ListSelectionListener)

isSelectedIndex

public boolean isSelectedIndex(int index)
지정된 인덱스가 선택되고 있는 경우는 true 를 돌려줍니다. selectionModel 에 delegate 하는 간이 메소드입니다.

파라미터:
index - 선택 상태가 조회되는 인덱스
반환값:
지정의 인덱스가 선택되고 있는 경우는 true
관련 항목:
ListSelectionModel.isSelectedIndex(int) , setSelectedIndex(int) , addListSelectionListener(javax.swing.event.ListSelectionListener)

isSelectionEmpty

public boolean isSelectionEmpty()
아무것도 선택되어 있지 않은 경우는 true 를 돌려줍니다. selectionModel 에 delegate 하는 간이 메소드입니다.

반환값:
아무것도 선택되어 있지 않은 경우는 true
관련 항목:
ListSelectionModel.isSelectionEmpty() , clearSelection() , addListSelectionListener(javax.swing.event.ListSelectionListener)

clearSelection

public void clearSelection()
선택을 클리어 합니다. 이 메소드를 호출한 뒤는 isSelectionEmpty 는 true 를 돌려줍니다. selectionModel 에 delegate 하는 간이 메소드입니다.

관련 항목:
ListSelectionModel.clearSelection() , isSelectionEmpty() , addListSelectionListener(javax.swing.event.ListSelectionListener)

setSelectionInterval

public void setSelectionInterval(int anchor,
                                 int lead)
지정된 구간을 선택합니다. anchorlead 인덱스가 포함됩니다. anchorlead 보다 작지 않아도 괜찮습니다. selectionModel 에 delegate 하는 간이 메소드입니다. 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 에 delegate 하는 간이 메소드입니다. 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 인덱스가 삭제됩니다. index0index1 보다 작지 않아도 괜찮습니다. selectionModel 에 delegate 하는 간이 메소드입니다. 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 의 행을 표시하기 위해서 필요한 뷰포트의 사이즈를 계산합니다. fixedCellWidthfixedCellHeight 프로퍼티가 지정되고 있는 경우에는 이 사이즈는 분명합니다. 이러한 프로퍼티치는 prototypeCellValue 프로퍼티에 의해 암묵으로 지정되는 일도 있습니다. fixedCellWidth 가 지정되어 있지 않은 경우에는 이 사이즈는 가장 폭의 넓은 리스트 요소를 찾아내는 것에 의해 계산됩니다. fixedCellHeight 가 지정되어 있지 않은 경우에는 다음과 같은 경험칙에 의지합니다. 레이아웃 방향이 VERTICAL 가 아닌 경우,getPreferredSize 로부터의 값을 돌려줍니다. 현재의 ListUI 에 의해, 적절한 값을 돌려주도록(듯이) getPreferredSize 가 오버라이드(override) 되는 것이 예상됩니다.

정의:
인터페이스 Scrollable 내의 getPreferredScrollableViewportSize
반환값:
visibleRowCount 행의 표시에 필요한 뷰포트의 사이즈를 포함한 치수
관련 항목:
getPreferredScrollableViewportSize() , setPrototypeCellValue(java.lang.Object)

getScrollableUnitIncrement

public int getScrollableUnitIncrement(Rectangle  visibleRect,
                                      int orientation,
                                      int direction)
전 또는 다음의 행 (수직 스크롤), 또는 캐릭터 (수평 스크롤)를 표시하기 위해서 스크롤 하는 거리를 돌려줍니다. 수평 스크롤의 경우는 리스트의 font size를 돌려줍니다. 폰트가 null 이면, 1 을 돌려줍니다. 표준적인 캐릭터 라인 ("m" 등)의 폭은 아니고, 계산이 용이한 font size를 사용하고 있습니다.

수직 스크롤의 경우는 아래방향에 스크롤 하는 경우에 (direction 가 0 보다 크다), 선두행이 visibleRect 에 대해서 완전하게 가시이면, 선두행의 높이를 돌려줍니다. 아래방향에 스크롤 하는 경우에, 선두행이 부분적에게만 가시이면, 선두행의 가시 분의 높이를 돌려줍니다. 똑같이, 윗방향에 스크롤 하는 경우에, 선두행이 완전하게 가시이면, 선두행 위의 행의 높이를 돌려줍니다.

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 의 값은 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()
JListJViewport 에 표시되어 뷰포트가 JList 의 적절한 폭보다 넓은 경우, 또는 레이아웃 방향이 HORIZONTAL_WRAP 이며, 가시행 카운트가 <= 0 의 경우는 true 를 돌려줍니다. 그렇지 않은 경우는 false 를 돌려줍니다. false 의 경우, 뷰포트의 폭을 추적하지 않습니다. 이것에 의해,JViewport 자체가 JScrollPane 에 짜넣어지고 있는 경우, 수평 스크롤이 생기게 됩니다.

정의:
인터페이스 Scrollable 내의 getScrollableTracksViewportWidth
반환값:
뷰포트가 JList 의 적절한 폭보다 넓은 경우는 true, 그렇지 않은 경우는 false
관련 항목:
Scrollable.getScrollableTracksViewportWidth()

getScrollableTracksViewportHeight

public boolean getScrollableTracksViewportHeight()
JListJViewport 에 표시되어 뷰포트가 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

JavaTM 2
Platform
Std.  Ed.  v1. 4.0

버그의 보고와 기능의 리퀘스트
이외의 API 레퍼런스 및 개발자용 문서에 대해서는 Java 2 SDK SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.