目錄
- JList、JComboBox實作串列框
- 簡單串列框
- 不強制存盤串列項的ListModel和ComboBoxModel
- 強制存盤串列項的DefaultListModel和DefaultComboBoxModel
- 使用ListCellRenderer改變串列外觀
JList、JComboBox實作串列框
無論從哪個角度來看， JList 和 JComboBox 都是極其相似的，它們都有一個串列框，只是 JComboBox的串列框需要 以下拉方式顯示出來; JList 和 JComboBox 都可以通過呼叫 setRendererO方法來改變串列項的表現形式 ，甚至維護這兩個組件的 Model 都是相似的， JList 使用 ListModel, JComboBox 使用ComboBoxModel ，而 ComboBoxModel 是 ListModel 的子類 ，
簡單串列框
使用JList或JComboBox實作簡單串列框的步驟：
- 創建JList或JComboBox物件
JList(final E[] listData):創建JList物件，把listData陣列中的每項內容轉換成一個串列項展示
JList(final Vector<? extends E> listData):創建JList物件，把listData陣列中的每項內容轉換成一個串列項展示
JComboBox(E[] items):
JComboBox(Vector<E> items):
- 設定JList或JComboBox的外觀行為
---------------------------JList----------------------------------------------
addSelectionInterval(int anchor, int lead):在已經選中串列項的基礎上，增加選中從anchor到lead索引范圍內的所有串列項
setFixedCellHeight(int height)/setFixedCellWidth(int width):設定串列項的高度和寬度
setLayoutOrientation(int layoutOrientation)：設定串列框的布局方向
setSelectedIndex(int index)：設定默認選中項
setSelectedIndices(int[] indices)：設定默認選中的多個串列項
setSelectedValue(Object anObject,boolean shouldScroll)：設定默認選中項，并滾動到該項顯示
setSelectionBackground(Color selectionBackground)：設定選中項的背景顏色
setSelectionForeground(Color selectionForeground)：設定選中項的前景色
setSelectionInterval(int anchor, int lead):設定從anchor到lead范圍內的所有串列項被選中
setSelectionMode(int selectionMode)：設定選中模式，默認沒有限制，也可以設定為單選或者區域選中
setVisibleRowCount(int visibleRowCount)：設定串列框的可是高度足以顯示多少行串列項
---------------------------JComboBox----------------------------------------------
setEditable(boolean aFlag)：設定是否可以直接修改串列文本框的值，默認為不可以
setMaximumRowCount(int count)：設定串列框的可是高度足以顯示多少行串列項
setSelectedIndex(int anIndex)：設定默認選中項
setSelectedItem(Object anObject)：根據串列項的值，設定默認選中項
- 設定監聽器，監聽串列項的變化，JList通過addListSelectionListener完成，JComboBox通過addItemListener完成
案例：
? 使用JList和JComboBox完成下圖效果：
演示代碼：
import javax.swing.*;
import javax.swing.border.EtchedBorder;
import javax.swing.border.TitledBorder;
import javax.swing.event.ListSelectionEvent;
import javax.swing.event.ListSelectionListener;
import java.awt.*;
import java.awt.event.ItemEvent;
import java.awt.event.ItemListener;
import java.util.List;
import java.util.Vector;
public class ListTest {
JFrame mainWin = new JFrame("串列框測驗");
String[] books = {"java自學寶典","輕量級javaEE企業應用實戰","Android基礎教程","jQuery實戰教程","SpringBoot企業級開發"};
//用一個字串陣列來創建一個JList物件
JList<String> bookList = new JList<>(books);
JComboBox<String> bookSelector;
//定義 布局選擇按鈕 所在的面板
JPanel layoutPanel = new JPanel();
ButtonGroup layoutGroup = new ButtonGroup();
//定義 選擇模式按鈕 所在面板
JPanel selectModePanel = new JPanel();
ButtonGroup selectModeGroup = new ButtonGroup();
JTextArea favorite = new JTextArea(4,40);
public void init(){
//設定JList的可視高度可以同時展示3個串列項
bookList.setVisibleRowCount(3);
//設定Jlist默認選中第三項到第五項
bookList.setSelectionInterval(2,4);
addLayoutButton("縱向滾動",JList.VERTICAL);
addLayoutButton("縱向換行",JList.VERTICAL_WRAP);
addLayoutButton("橫向換行",JList.HORIZONTAL_WRAP);
addSelectModeButton("無限制", ListSelectionModel.MULTIPLE_INTERVAL_SELECTION);
addSelectModeButton("單選", ListSelectionModel.SINGLE_SELECTION);
addSelectModeButton("單范圍", ListSelectionModel.SINGLE_INTERVAL_SELECTION);
Box listBox = Box.createVerticalBox();
//將JList組件放置到JScrollPane中，并將JScrollPane放置到box中
listBox.add(new JScrollPane(bookList));
listBox.add(layoutPanel);
listBox.add(selectModePanel);
//為JList添加事件監聽器
bookList.addListSelectionListener(new ListSelectionListener() {
@Override
public void valueChanged(ListSelectionEvent e) {
List<String> selectedValuesList = bookList.getSelectedValuesList();
favorite.setText("");
for (String s : selectedValuesList) {
favorite.append(s+"\n");
}
}
});
//定義一個Vector物件
Vector<String> bookCollection = new Vector<>();
List<String> books = List.of("java自學寶典","輕量級javaEE企業應用實戰","Android基礎教程","jQuery實戰教程","SpringBoot企業級開發");
bookCollection.addAll(books);
//創建JComboBox物件
bookSelector = new JComboBox<>(bookCollection);
//為JComboBox添加事件監聽器
bookSelector.addItemListener(new ItemListener() {
@Override
public void itemStateChanged(ItemEvent e) {
Object selectedItem = bookSelector.getSelectedItem();
favorite.setText(selectedItem.toString());
}
});
//設定JComboBox的串列項可編輯
bookSelector.setEditable(true);
//設定下拉串列的可視高度最多顯示4個串列項
bookSelector.setMaximumRowCount(4);
JPanel panel = new JPanel();
panel.add(bookSelector);
Box box = Box.createHorizontalBox();
box.add(listBox);
box.add(panel);
JPanel favoritePanel = new JPanel();
favoritePanel.setLayout(new BorderLayout());
favoritePanel.add(new JScrollPane(favorite));
favoritePanel.add(new JLabel("您最喜歡的圖書："),BorderLayout.NORTH);
mainWin.add(box);
mainWin.add(favoritePanel,BorderLayout.SOUTH);
mainWin.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
mainWin.pack();
mainWin.setVisible(true);
}
public void addLayoutButton(String label,int orientation){
layoutPanel.setBorder(new TitledBorder(new EtchedBorder(),"確定選項布局"));
JRadioButton button = new JRadioButton(label);
layoutPanel.add(button);
//默認選中第一個按鈕
if (layoutGroup.getButtonCount()==0){
button.setSelected(true);
}
layoutGroup.add(button);
button.addActionListener(e->{
//改變串列框里串列項的布局方向
bookList.setLayoutOrientation(orientation);
});
}
public void addSelectModeButton(String label,int selectMode){
selectModePanel.setBorder(new TitledBorder(new EtchedBorder(),"確定選擇模式"));
JRadioButton button = new JRadioButton(label);
selectModePanel.add(button);
if (selectModeGroup.getButtonCount()==0){
button.setSelected(true);
}
selectModeGroup.add(button);
button.addActionListener(e->{
bookList.setSelectionMode(selectMode);
});
}
public static void main(String[] args) {
new ListTest().init();
}
}
不強制存盤串列項的ListModel和ComboBoxModel
與JProgressBar一樣，JList和JComboBox也采用了MVC的設計模式，JList和JComboBox只負責外觀的顯示，而組件底層的狀態資料則由對應的Model來維護，JList對應的Model是ListModel介面，JComboBox對應的Model是ComboBox介面，其代碼如下：
public interface ListModel<E>{
int getSize();
E getElementAt(int index);
void addListDataListener(ListDataListener l);
void removeListDataListener(ListDataListener l);
}
public interface ComboBoxModel<E> extends ListModel<E> {
void setSelectedItem(Object anItem);
Object getSelectedItem();
}
從上面介面來看，這個 ListMode l 不管 JList 里的所有串列項的存盤形式，它甚至不強制存盤所有的串列項，只要 ListModel的實作類提供了getSize()和 getElementAt()兩個方法 ， JList 就可以根據該ListModel 物件來生成串列框 ，ComboBoxModel 繼承了 ListModel ，它添加了"選擇項"的概念，選擇項代表 JComboBox 顯示區域內可見的串列項 ，
在使用JList和JComboBox時，除了可以使用jdk提供的Model實作類，程式員自己也可以根據需求，自己定義Model的實作類，實作對應的方法使用，
案例：
? 自定義NumberListModel和NumberComboBoxModel實作類，允許使用數值范圍來創建JList和JComboBox
?
演示代碼：
import javax.swing.*;
import java.math.BigDecimal;
import java.math.RoundingMode;
public class NumberListModel extends AbstractListModel<BigDecimal> {
protected BigDecimal start;
protected BigDecimal end;
protected BigDecimal step;
public NumberListModel(double start,double end,double step) {
this.start = new BigDecimal(start);
this.end = new BigDecimal(end);
this.step = new BigDecimal(step);
}
@Override
public int getSize() {
int floor = (int) Math.floor(end.subtract(start).divide(step,2, RoundingMode.HALF_DOWN).doubleValue());
return floor+1;
}
@Override
public BigDecimal getElementAt(int index) {
return BigDecimal.valueOf(index).multiply(step).add(start).setScale(1,RoundingMode.HALF_DOWN);
}
}
import javax.swing.*;
import java.math.BigDecimal;
import java.math.RoundingMode;
public class NumberComboBoxModel extends NumberListModel implements ComboBoxModel<BigDecimal> {
//用于保存用戶選中項的索引
private int selectId = 0;
public NumberComboBoxModel(double start, double end, double step) {
super(start, end, step);
}
//設定選擇項
@Override
public void setSelectedItem(Object anItem) {
if (anItem instanceof BigDecimal){
BigDecimal target = (BigDecimal) anItem;
selectId = target.subtract(super.start).divide(super.step,2, RoundingMode.HALF_DOWN).intValue();
}
}
//獲取選中項的索引
@Override
public BigDecimal getSelectedItem() {
return BigDecimal.valueOf(selectId).multiply(step).add(start).setScale(1,RoundingMode.HALF_DOWN);
}
}
import javax.swing.*;
import javax.swing.event.ListSelectionEvent;
import javax.swing.event.ListSelectionListener;
import java.awt.*;
import java.awt.event.ItemEvent;
import java.awt.event.ItemListener;
import java.math.BigDecimal;
import java.util.List;
public class ListModelTest {
JFrame mainWin = new JFrame("測驗ListModel");
//根據NumberListModel物件創建一個JList
JList<BigDecimal> numScopeList = new JList<>(new NumberListModel(1,21,2));
//根據NumberComboBoxModel物件創建一個JComboBox
JComboBox<BigDecimal> numScopeSelector = new JComboBox<>(new NumberComboBoxModel(0.1,1.2,0.1));
JTextField showVal = new JTextField(10);
public void init(){
//JList可視高度可同時顯示四個串列項
numScopeList.setVisibleRowCount(4);
//默認選中第三項到第五項
numScopeList.setSelectionInterval(2,4);
//設定每個串列項具有指定高度和寬度
numScopeList.setFixedCellHeight(30);
numScopeList.setFixedCellWidth(90);
//為numScopeList添加監聽器
numScopeList.addListSelectionListener(new ListSelectionListener() {
@Override
public void valueChanged(ListSelectionEvent e) {
//獲取用戶選中的所有數字
List<BigDecimal> selectedValuesList = numScopeList.getSelectedValuesList();
showVal.setText("");
for (BigDecimal bigDecimal : selectedValuesList) {
showVal.setText(showVal.getText()+bigDecimal.toString()+", ");
}
}
});
//設定下拉串列的可視高度可顯示5個串列項
numScopeSelector.setMaximumRowCount(5);
Box box = Box.createHorizontalBox();
box.add(new JScrollPane(numScopeList));
JPanel p = new JPanel();
p.add(numScopeSelector);
box.add(p);
//為numberScopeSelector添加監聽器
numScopeSelector.addItemListener(new ItemListener() {
@Override
public void itemStateChanged(ItemEvent e) {
Object value = https://www.cnblogs.com/kohler21/archive/2022/05/05/numScopeSelector.getSelectedItem();
showVal.setText(value.toString());
}
});
JPanel bottom = new JPanel();
bottom.add(new JLabel("您選擇的值是："));
bottom.add(showVal);
mainWin.add(box);
mainWin.add(bottom, BorderLayout.SOUTH);
mainWin.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
mainWin.pack();
mainWin.setVisible(true);
}
public static void main(String[] args) {
new ListModelTest().init();
}
}
強制存盤串列項的DefaultListModel和DefaultComboBoxModel
前面只是介紹了如何創建 JList 、 JComboBox 物件， 當 呼叫 JList 和 JComboBox構造方法時時傳入陣列或 Vector 作為引數，這些陣列元素或集合元素將會作為串列項，當使用JList 或 JComboBox 時 常常還需要動態地增加、洗掉串列項,例如JCombox提供了下列方法完成增刪操作：
addItem(E item):添加一個串列項
insertItemAt(E item, int index)：向指定索引處插入一個串列項
removeAllItems()：洗掉所有串列項
removeItem(Object anObject)：洗掉指定串列項
removeItemAt(int anIndex)：洗掉指定索引處的串列項
JList 并沒有提供這些類似的方法，如果需要創建一個可以增加、洗掉串列項的 JList 物件，則應該在創建 JLi st 時顯式使用 DefaultListModel作為構造引數 ，因為 DefaultListModel 作為 JList 的 Model，它負責維護 JList 組件的所有串列資料，所以可以通過向 DefaultListModel 中添加、洗掉元素來實作向 JList 物件中增加 、洗掉串列項 ，DefaultListModel 提供了如下幾個方法來添加、洗掉元素:
add(int index, E element): 在該 ListModel 的指定位置處插入指定元素 ，
addElement(E obj): 將指定元素添加到該 ListModel 的末尾 ，
insertElementAt(E obj, int index): 在該 ListModel 的指定位置處插入指定元素 ，
Object remove(int index): 洗掉該 ListModel 中指定位置處的元素
removeAllElements(): 刪 除該 ListModel 中的所有元素，并將其的大小設定為零 ，
removeElement(E obj): 洗掉該 ListModel 中第一個與引數匹配的元素，
removeElementAt(int index): 洗掉該 ListModel 中指定索引處的元素 ，
removeRange(int 企omIndex ， int toIndex): 洗掉該 ListModel 中指定范圍內的所有元素，
set(int index, E element) : 將該 ListModel 指定索引處的元素替換成指定元素，
setElementAt(E obj, int index): 將該 ListModel 指定索引處的元素替換成指定元素，
案例：
? 使用DefaultListModel完成下圖效果：
演示代碼：
import javax.swing.*;
import java.awt.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
public class DefaultListModelTest {
JFrame mainWin = new JFrame("測驗DefaultListModel");
//定義一個JList物件
JList<String> bookList;
//定義一個DefaultListModel物件
DefaultListModel<String> bookModel = new DefaultListModel<>();
JTextField bookName = new JTextField(20);
JButton removeBtn = new JButton("洗掉選中圖書");
JButton addBtn = new JButton("添加指定圖書");
public void init(){
//向bookModel中添加元素
bookModel.addElement("java自學寶典");
bookModel.addElement("輕量級javaEE企業應用實戰");
bookModel.addElement("Android基礎教程");
bookModel.addElement("jQuery實戰教程");
bookModel.addElement("SpringBoot企業級開發");
//根據DefaultListModel創建一個JList物件
bookList = new JList<>(bookModel);
//設定最大可視高度
bookList.setVisibleRowCount(4);
//設定只能單選
bookList.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);
//為addBtn添加事件監聽器
addBtn.addActionListener(new ActionListener() {
@Override
public void actionPerformed(ActionEvent e) {
//當bookName文本框內容不為空時添加串列項
if (!bookName.getText().trim().equals("")){
bookModel.addElement(bookName.getText());
}
}
});
//為removeBtn添加事件監聽器
removeBtn.addActionListener(new ActionListener() {
@Override
public void actionPerformed(ActionEvent e) {
int selectedIndex = bookList.getSelectedIndex();
if (selectedIndex>=0){
bookModel.remove(selectedIndex);
}
}
});
JPanel p = new JPanel();
p.add(bookName);
p.add(addBtn);
p.add(removeBtn);
mainWin.add(new JScrollPane(bookList));
mainWin.add(p, BorderLayout.SOUTH);
mainWin.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
mainWin.pack();
mainWin.setVisible(true);
}
public static void main(String[] args) {
new DefaultListModelTest().init();
}
}
使用ListCellRenderer改變串列外觀
前面程式中的 JList 和 JComboBox 采用的都是簡單的字串串列項， 實際上 ， JList 和 JComboBox還可以支持圖示串列項，如果在創建 JList 或 JComboBox 時傳入圖示陣列，則創建的 JList 和 JComboBox的串列項就是圖示 ，
如果希望串列項是更復雜 的組件，例如，希望像 QQ 程式那樣每個串列項既有圖示，此時需要使用ListCellRenderer介面的實作類物件，自定義每個條目組件的渲染程序：
public interface ListCellRenderer<E>
{
Component getListCellRendererComponent(
JList<? extends E> list,//串列組件
E value,//當前串列項的值額索引
int index,//當前串列項d
boolean isSelected,//當前串列項是否被選中
boolean cellHasFocus);//當前串列項是否獲取了焦點
}
通過JList的setCellRenderer(ListCellRenderer<? super E> cellRenderer)方法，把自定義的ListCellRenderer物件傳遞給JList，就可以按照自定義的規則繪制串列項組件了，
案例：
? 使用ListCellRenderer實作下圖效果：
演示代碼：
import javax.swing.*;
import java.awt.*;
public class ListCellRendererTest {
private JFrame mainWin = new JFrame("好友串列");
private String[] friends = {
"李清照",
"蘇格拉底",
"李白",
"弄玉",
"虎頭"
};
//定義一個JList物件
JList friendsList = new JList(friends);
public void init() {
//設定JList使用ImageCellRenderer作為串列項繪制器
friendsList.setCellRenderer(new ImageCellRenderer());
mainWin.add(new JScrollPane(friendsList));
mainWin.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
mainWin.pack();
mainWin.setVisible(true);
}
public static void main(String[] args) {
new ListCellRendererTest().init();
}
class ImageCellRenderer extends JPanel implements ListCellRenderer {
private ImageIcon icon;
private String name;
//定義繪制單元格的背景色
private Color background;
//定義繪制單元格的前景色
private Color foreground;
@Override
public Component getListCellRendererComponent(JList list, Object value, int index, boolean isSelected, boolean cellHasFocus) {
icon = new ImageIcon(ImagePathUtil.getRealPath("9\\" + value + ".gif"));
name = value.toString();
background = isSelected ? list.getSelectionBackground() : list.getBackground();
foreground = isSelected ? list.getSelectionForeground() : list.getForeground();
//回傳當前JPanel物件，作為串列項繪制器
return this;
}
@Override
protected void paintComponent(Graphics g) {
int width = icon.getImage().getWidth(null);
int height = icon.getImage().getHeight(null);
//填充背景矩形
g.setColor(background);
g.fillRect(0,0,getWidth(),getHeight());
g.setColor(foreground);
//繪制好友頭像
g.drawImage(icon.getImage(),getWidth()/2-width/2,10,null);
//繪制好友昵稱
g.setFont(new Font("SansSerif",Font.BOLD,18));
g.drawString(name,getWidth()/2-name.length()*10,height+30);
}
@Override
public Dimension getPreferredSize() {
return new Dimension(60,80);
}
}
}
公眾號文章：https://mp.weixin.qq.com/s/RFZozhh05cSt_b46mOOOiw
轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/469703.html
標籤：其他