|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 모든 클래스 | ||||||||||
개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.JList
유저가 리스트로부터 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
는 스크롤을 직접 서포트하고 있습니다. 스크롤 리스트를 작성하려면 ,JList
를 JScrollPane
의 뷰포트뷰로서 설정합니다. 다음에 예를 나타냅니다.
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
의 작성 후에 리스트 요소의 값이나 리스트의 사이즈를 변경할 수 있습니다. 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
를 호출하는 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
를 이용하면 그것들을 간단하게 처리할 수가 있습니다. 클릭된 셀을 조사하려면 ,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
가 되고 있습니다.
표준의 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)
선택 모델이 변경된 것을 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)
리스트내의 각 셀을 표현 하는 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)
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 프로퍼티를 리셋트 합니다. |
클래스 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.lang. Object 에서 상속받은 메소드 |
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait |
필드의 상세 |
public static final int VERTICAL
setLayoutOrientation(int)
,
정수 필드치 public static final int VERTICAL_WRAP
setLayoutOrientation(int)
,
정수 필드치 public static final int HORIZONTAL_WRAP
setLayoutOrientation(int)
,
정수 필드치 생성자의 상세 |
public JList(ListModel dataModel)
null
이외의 모델의 요소를 표시하는 JList
를 구축합니다. 모든 JList
constructor 은 이 오브젝트에 delegate 합니다.
dataModel
- 이 리스트의 데이터 모델
IllegalArgumentException
- dataModel
가 null
의 경우public JList(Object [] listData)
JList
를 구축합니다. 이 constructor 은 ListModel
constructor 에 delegate 합니다.
listData
- 데이터 모델에 로드 되는 Object 의 배열public JList(Vector listData)
Vector
의 요소를 표시하는 JList
를 구축합니다. 이 constructor 은 ListModel
constructor 에 delegate 합니다.
listData
- 데이터 모델에 로드 되는 Vector
public JList()
JList
를 구축합니다.
메소드의 상세 |
public ListUI getUI()
ListUI
오브젝트public void setUI(ListUI ui)
ui
- ListUI
L&F 오브젝트UIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
JComponent
내의 updateUI
UIManager.getUI(javax.swing.JComponent)
public String getUIClassID()
JComponent
내의 getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public Object getPrototypeCellValue()
prototypeCellValue
프로퍼티의 값setPrototypeCellValue(java.lang.Object)
public void setPrototypeCellValue(Object prototypeCellValue)
fixedCellWidth
및 fixedCellHeight
프로퍼티를 계산합니다. 인덱스 0 의 cellRenderer
를 지정치로 설정하고 나서, 렌더링 컴퍼넌트의 우선 사이즈를 계산합니다. 리스트가 너무 길어 JList
가 각 셀의 폭과 높이를 계산하지 못하고, 다른 셀과 같은 스페이스를 가지는 것을 알 수 있고 있는 셀이 있는 경우에는 이 프로퍼티가 편리합니다.
fixedCellWidth
및 fixedCellHeight
프로퍼티를 여기서 설정해도,prototypeCellValue
만으로 PropertyChangeEvent
가 방아쇠 되는 것에 주의해 주세요.
이 프로퍼티의 설정예를 참조하려면 , 상기의클래스의 설명을 참조해 주세요.
이 프로퍼티의 디폴트 값은 null
입니다.
이것은 JavaBeans 바운드 프로퍼티입니다.
prototypeCellValue
- fixedCellWidth
및 fixedCellHeight
의 베이스가 되는 값getPrototypeCellValue()
,
setFixedCellWidth(int)
,
setFixedCellHeight(int)
,
JComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)
public int getFixedCellWidth()
fixedCellWidth
프로퍼티로 지정되고 있는 값입니다.
setFixedCellWidth(int)
public void setFixedCellWidth(int width)
width
가 -1 의 경우, 각 리스트 요소의 cellRenderer
컴퍼넌트에 getPreferredSize
를 적용하는 것으로써, 셀폭이 계산됩니다.
이 프로퍼티의 디폴트 값은 -1 입니다.
이것은 JavaBeans 바운드 프로퍼티입니다.
width
- 픽셀 단위의, 리스트내의 모든 셀의 폭getPrototypeCellValue()
,
setFixedCellWidth(int)
,
JComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)
public int getFixedCellHeight()
fixedCellHeight
프로퍼티로 지정되고 있는 값입니다.
setFixedCellHeight(int)
public void setFixedCellHeight(int height)
height
가 -1 의 경우, 각 리스트 요소의 cellRenderer
컴퍼넌트에 getPreferredSize
를 적용하는 것으로써, 셀의 높이가 계산됩니다.
이 프로퍼티의 디폴트 값은 -1 입니다.
이것은 JavaBeans 바운드 프로퍼티입니다.
height
- 리스트내의 모든 셀의 높이를 픽셀수로 지정하는 정수getPrototypeCellValue()
,
setFixedCellWidth(int)
,
JComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)
public ListCellRenderer getCellRenderer()
ListCellRenderer
setCellRenderer(javax.swing.ListCellRenderer)
public void setCellRenderer(ListCellRenderer cellRenderer)
prototypeCellValue
가 설정되어 있으면,fixedCellWidth
및 fixedCellHeight
프로퍼티도 설정됩니다. 그러나,cellRenderer
프로퍼티에 대해서는 PropertyChangeEvent
는 1 개만 생성됩니다.
이 프로퍼티의 디폴트 값은 ListUI delegate (Look & Feel 의 구현)에 의해 제공됩니다.
셀 렌더링의 설정예를 참조하려면 , 상기의 클래스의 설명을 참조해 주세요.
이것은 JavaBeans 바운드 프로퍼티입니다.
cellRenderer
- 리스트내의 셀을 표현 하는 ListCellRenderer
getCellRenderer()
public Color getSelectionForeground()
Color
오브젝트setSelectionForeground(java.awt.Color)
,
setSelectionBackground(java.awt.Color)
public void setSelectionForeground(Color selectionForeground)
이 프로퍼티의 디폴트 값은 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)
public Color getSelectionBackground()
Color
setSelectionBackground(java.awt.Color)
,
setSelectionForeground(java.awt.Color)
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)
public int getVisibleRowCount()
setVisibleRowCount(int)
public void setVisibleRowCount(int visibleRowCount)
JViewport
의 상위 오브젝트 (존재하는 경우만)에 의해 결정됩니다. 이 프로퍼티치는 JList
의 preferredScrollableViewportSize
의 값에게만 영향을 줍니다.
이 프로퍼티의 디폴트 값은 8 입니다.
이것은 JavaBeans 바운드 프로퍼티입니다.
visibleRowCount
- 가시행의 적절한 수를 지정하는 정수getVisibleRowCount()
,
JComponent.getVisibleRect()
,
JViewport
public int getLayoutOrientation()
JList.VERTICAL
, 컨텐츠가 수직 방향의 다음에 수평 방향의 순서에 줄선 「신문 스타일」의 경우는 JList.VERTICAL_WRAP
, 컨텐츠가 수평 방향의 다음에 수직 방향의 순서에 줄선 「신문 스타일」의 경우는 JList.HORIZONTAL_WRAP
를 돌려줍니다.
setLayoutOrientation(int)
public void setLayoutOrientation(int layoutOrientation)
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 개getLayoutOrientation()
,
setVisibleRowCount(int)
,
getScrollableTracksViewportHeight()
public int getFirstVisibleIndex()
componentOrientation
프로퍼티에 의합니다. 방향이, 왼쪽에서 오른쪽에의 수평 방향인 경우, 최초의 가시 셀은 리스트의 좌상구석이 되어, 금방 다른 곳으로의 수평 방향의 경우는 우상구석이 됩니다. 어느 셀도 가시가 아닌 경우나 리스트가 하늘인 경우에는 -1 을 돌려줍니다. 돌려주어진 셀은 부분적으로 가시에서도 괜찮습니다.
getLastVisibleIndex()
,
JComponent.getVisibleRect()
public int getLastVisibleIndex()
componentOrientation
프로퍼티에 의합니다. 방향이, 왼쪽에서 오른쪽에의 수평 방향인 경우, 마지막 가시 셀은 JList 의 우하구석이 되어, 금방 다른 곳으로의 수평 방향의 경우는 왼쪽 하단 모서리가 됩니다. 어느 셀도 가시가 아닌 경우나 리스트가 하늘인 경우에는 -1 을 돌려줍니다. 돌려주어진 셀은 부분적으로 가시에서도 괜찮습니다.
getFirstVisibleIndex()
,
JComponent.getVisibleRect()
public void ensureIndexIsVisible(int index)
JViewport
내에서 JList
를 표시할 필요가 있습니다.
index
- 가시로 하는 셀의 인덱스JComponent.scrollRectToVisible(java.awt.Rectangle)
,
JComponent.getVisibleRect()
public void setDragEnabled(boolean b)
dragEnabled
프로퍼티를 설정합니다. 이 컴퍼넌트의 자동 드러그 처리 (드러그&드롭의 최초의 부분)를 사용 가능하게 하려면 true
로 할 필요가 있습니다. 드러그 해 어떠한 조작을 실시하려면 transferHandler
프로퍼티는 null
이외의 값으로 설정합니다. dragEnabled
프로퍼티의 디폴트 값은 false
입니다.
자동 드러그 처리가 사용 가능하게 되면(자), 대부분의 Look & Feel 는 유저가 선택 범위상에서 mouse button를 누르고 나서 마우스를 수픽셀 이동했을 때에 드러그&드롭 조작을 개시합니다. 따라서, 이 프로퍼티를 true
로 설정하면(자), 선택 범위의 동작 정원않고 게 영향을 줍니다.
자동 드러그 처리를 서포트하고 있지 않는 Look & Feel 도 있어, 그 경우 이 프로퍼티는 무시됩니다. 서포트하고 있지 않는 Look & Feel 를 회피하려면 ,TransferHandler
의 exportAsDrag
메소드를 직접 호출해 컴퍼넌트를 변경합니다.
b
- dragEnabled
프로퍼티로 설정하는 값
HeadlessException
- b
가 true
또한 GraphicsEnvironment.isHeadless()
가 true
를 돌려주는 경우GraphicsEnvironment.isHeadless()
,
getDragEnabled()
,
JComponent.setTransferHandler(javax.swing.TransferHandler)
,
TransferHandler
public boolean getDragEnabled()
dragEnabled
프로퍼티를 취득합니다.
dragEnabled
프로퍼티의 값setDragEnabled(boolean)
public int getNextMatch(String prefix, int startIndex, Position.Bias bias)
prefix
- 일치를 테스트하는 캐릭터 라인startIndex
- 검색을 개시하는 인덱스bias
- 검색 방향. Position.Bias.Forward, 또는 Position.Bias.Backward
IllegalArgumentException
- 접두사가 null 또는 startIndex 가 범위외에 있는 경우public String getToolTipText(MouseEvent event)
JComponent
의 getToolTipText
메소드를 오버라이드(override) 해, 렌더링의 힌트 (텍스트 세트가 있는 경우)를 사용할 수 있게 합니다.
JList
가 렌더링의 툴 힌트를 적절히 표시할 수 있게 하려면 ,JList
는 ToolTipManager
에 등록을 마친 컴퍼넌트가 아니면 안됩니다. 이것은 constructor 으로 자동적으로 행해집니다만, 나중에 JList
에 setToolTipText(null)
를 통지하면(자), 리스트 컴퍼넌트를 등록 해제하므로, 렌더링으로부터의 힌트는 그 이상 표시되지 않습니다.
JComponent
내의 getToolTipText
JComponent.getToolTipText()
public int locationToIndex(Point location)
JList
의 좌표상의 점을 그 위치에 있는 셀의 인덱스로 변환합니다. 셀이 실제로 그 위치를 포함할지 어떨지를 판정하려면 , 이 메소드와 getCellBounds
를 조합해 사용합니다. 모델이 비었을 경우는 -1 을 돌려줍니다.
location
- JList
에 관련한 셀의 좌표
public Point indexToLocation(int index)
JList
좌표에 있어서의 원점을 돌려줍니다. index
가 무효인 경우는 null
를 돌려줍니다.
index
- JList
셀의 인덱스
public Rectangle getCellBounds(int index0, int index1)
JList
좌표로 지정된 항목 범위의 경계를 돌려줍니다. 인덱스가 무효인 경우는 null
를 돌려줍니다.
index0
- 범위내의 최초의 JList
셀의 인덱스index1
- 범위내의 마지막 JList
셀의 인덱스
public ListModel getModel()
JList
컴퍼넌트에 의해 표시되는 항목의 리스트를 보관 유지하는 데이터 모델을 돌려줍니다.
ListModel
setModel(javax.swing.ListModel)
public void setModel(ListModel model)
PropertyChangeListener
에의 통지 후에 리스트의 선택물을 클리어 합니다.
이것은 JavaBeans 바운드 프로퍼티입니다.
model
- 표시되는 항목의 리스트를 제공하는 ListModel
IllegalArgumentException
- model
가 null
의 경우getModel()
public void setListData(Object [] listData)
ListModel
를 구축해,setModel
를 적용합니다.
listData
- 리스트에 표시하는 항목을 보관 유지하는 Object 의 배열setModel(javax.swing.ListModel)
public void setListData(Vector listData)
Vector
로부터 ListModel
를 구축해,setModel
를 적용합니다.
listData
- 리스트에 표시하는 항목을 보관 유지하는 Vector
setModel(javax.swing.ListModel)
protected ListSelectionModel createSelectionModel()
DefaultListSelectionModel
의 인스턴스를 돌려줍니다. 이 메소드는 constructor 이 selectionModel
프로퍼티를 초기화하는데 사용합니다.
JList
가 사용하는 ListSelectionModel
setSelectionModel(javax.swing.ListSelectionModel)
,
DefaultListSelectionModel
public ListSelectionModel getSelectionModel()
ListSelectionModel
setSelectionModel(javax.swing.ListSelectionModel)
,
ListSelectionModel
protected void fireSelectionValueChanged(int firstIndex, int lastIndex, boolean isAdjusting)
JList
의 ListSelectionListener
에 통지합니다. 이 메소드는 ListSelectionEvent
를 selectionModel
로부터, 직접 JList
에 추가된 ListSelectionListener
에 전송 하기 위해서 사용됩니다.
firstIndex
- 선택되고 있는 최초의 인덱스lastIndex
- 선택되고 있는 마지막 인덱스isAdjusting
- 복수의 변경을 했을 경우는 trueaddListSelectionListener(javax.swing.event.ListSelectionListener)
,
removeListSelectionListener(javax.swing.event.ListSelectionListener)
,
EventListenerList
public void addListSelectionListener(ListSelectionListener listener)
JList
에 직접 추가되는 청취자는 (ListSelectionModel
대신에) ListSelectionEvent.getSource()
(이 JList)를 가집니다.
listener
- 추가하는 ListSelectionListener
getSelectionModel()
public void removeListSelectionListener(ListSelectionListener listener)
listener
- 삭제하는 ListSelectionListener
addListSelectionListener(javax.swing.event.ListSelectionListener)
,
getSelectionModel()
public ListSelectionListener [] getListSelectionListeners()
ListSelectionListener
의 배열을 돌려줍니다.
ListSelectionListener
. 추가된 청취자가 없는 경우는 하늘의 배열public void setSelectionModel(ListSelectionModel selectionModel)
selectionModel
를 null
가 아닌 ListSelectionModel
구현으로 설정합니다. 선택 모델은 단일 선택, 인접한 범위의 선택, 및 비인접 선택을 작성하는 태스크를 처리합니다.
이것은 JavaBeans 바운드 프로퍼티입니다.
selectionModel
- 선택을 구현하는 ListSelectionModel
IllegalArgumentException
- selectionModel
가 null
의 경우getSelectionModel()
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()
public int getSelectionMode()
selectionMode
프로퍼티의 값setSelectionMode(int)
public int getAnchorSelectionIndex()
addSelectionModel
또는 setSelectionInterval
호출해에 있어서의 최초의 인덱스 인수를 돌려줍니다. selectionModel
에 delegate 하는 간이 메소드입니다.
ListSelectionModel.getAnchorSelectionIndex()
,
addSelectionInterval(int, int)
,
setSelectionInterval(int, int)
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public int getLeadSelectionIndex()
addSelectionInterval
또는 setSelectionInterval
호출해에 있어서의 2 번째의 인덱스 인수를 돌려줍니다. selectionModel
에 delegate 하는 간이 메소드입니다.
ListSelectionModel.getLeadSelectionIndex()
,
addSelectionInterval(int, int)
,
setSelectionInterval(int, int)
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public int getMinSelectionIndex()
selectionModel
에 delegate 하는 간이 메소드입니다.
ListSelectionModel.getMinSelectionIndex()
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public int getMaxSelectionIndex()
selectionModel
에 delegate 하는 간이 메소드입니다.
ListSelectionModel.getMaxSelectionIndex()
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public boolean isSelectedIndex(int index)
selectionModel
에 delegate 하는 간이 메소드입니다.
index
- 선택 상태가 조회되는 인덱스
ListSelectionModel.isSelectedIndex(int)
,
setSelectedIndex(int)
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public boolean isSelectionEmpty()
selectionModel
에 delegate 하는 간이 메소드입니다.
ListSelectionModel.isSelectionEmpty()
,
clearSelection()
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public void clearSelection()
isSelectionEmpty
는 true 를 돌려줍니다. selectionModel
에 delegate 하는 간이 메소드입니다.
ListSelectionModel.clearSelection()
,
isSelectionEmpty()
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public void setSelectionInterval(int anchor, int lead)
anchor
및 lead
인덱스가 포함됩니다. anchor
가 lead
보다 작지 않아도 괜찮습니다. 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)
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)
public void removeSelectionInterval(int index0, int index1)
index0
및 index1 인덱스가 삭제됩니다. index0
가 index1
보다 작지 않아도 괜찮습니다. 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)
public void setValueIsAdjusting(boolean b)
isAdjusting
프로퍼티를 true 로 설정해, 모든 선택 이벤트 (선택 모드로 리스트 항목상을 마우스로 드러그 하고 있는 경우등)가 완료한 시점에서 단일 이벤트가 생성되도록(듯이) 합니다.
b
- 프로퍼티치의 boolean 치ListSelectionModel.setValueIsAdjusting(boolean)
public boolean getValueIsAdjusting()
isAdjusting
프로퍼티의 값을 돌려줍니다. 복수의 변경을 하고 있는 경우에는 true 를 돌려줍니다.
ListSelectionModel.getValueIsAdjusting()
public int[] getSelectedIndices()
removeSelectionInterval(int, int)
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public void setSelectedIndex(int index)
index
- 선택하는 단일 셀의 인덱스ListSelectionModel.setSelectionInterval(int, int)
,
isSelectedIndex(int)
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public void setSelectedIndices(int[] indices)
indices
- 선택하는 셀의 인덱스의 배열ListSelectionModel.addSelectionInterval(int, int)
,
isSelectedIndex(int)
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public Object [] getSelectedValues()
isSelectedIndex(int)
,
getModel()
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public int getSelectedIndex()
getMinSelectionIndex
의 값getMinSelectionIndex()
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public Object getSelectedValue()
null
를 돌려줍니다.
getMinSelectionIndex()
,
getModel()
,
addListSelectionListener(javax.swing.event.ListSelectionListener)
public void setSelectedValue(Object anObject, boolean shouldScroll)
anObject
- 선택하는 오브젝트shouldScroll
- 오브젝트가 존재해, 리스트를 스크롤 해 선택한 오브젝트를 표시하는 경우는 true. 그렇지 않은 경우는 falsepublic 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)
public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
null
이면, 1 을 돌려줍니다. 표준적인 캐릭터 라인 ("m" 등)의 폭은 아니고, 계산이 용이한 font size를 사용하고 있습니다.
수직 스크롤의 경우는 아래방향에 스크롤 하는 경우에 (direction
가 0 보다 크다), 선두행이 visibleRect
에 대해서 완전하게 가시이면, 선두행의 높이를 돌려줍니다. 아래방향에 스크롤 하는 경우에, 선두행이 부분적에게만 가시이면, 선두행의 가시 분의 높이를 돌려줍니다. 똑같이, 윗방향에 스크롤 하는 경우에, 선두행이 완전하게 가시이면, 선두행 위의 행의 높이를 돌려줍니다.
visibleRect
의 값은 this.getVisibleRect()
와 같지 않으면 안됩니다.
Scrollable
내의 getScrollableUnitIncrement
visibleRect
- 가시 구형orientation
- HORIZONTAL 또는 VERTICALdirection
- <= 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 또는 VERTICALdirection
- <= 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
개요
패키지
클래스
사용
계층 트리
비추천 API
색인
헬프
JavaTM 2
Platform
Std. Ed. v1. 4.0
전의 클래스
다음의 클래스
프레임 있어
프레임 없음
모든 클래스
개요: 상자 | 필드 | constructor | 메소드
상세: 필드 | constructor | 메소드
버그의 보고와 기능의 리퀘스트
이외의 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.