296 lines
14 KiB
Java
296 lines
14 KiB
Java
/*
|
|
* Copyright (c) 1999, 2024, Oracle and/or its affiliates. All rights reserved.
|
|
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
|
*
|
|
* This code is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License version 2 only, as
|
|
* published by the Free Software Foundation.
|
|
*
|
|
* This code is distributed in the hope that it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
* version 2 for more details (a copy is included in the LICENSE file that
|
|
* accompanied this code).
|
|
*
|
|
* You should have received a copy of the GNU General Public License version
|
|
* 2 along with this work; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*
|
|
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
|
* or visit www.oracle.com if you need additional information or have any
|
|
* questions.
|
|
*/
|
|
|
|
import java.awt.Color;
|
|
import java.awt.Dimension;
|
|
|
|
import javax.swing.DefaultCellEditor;
|
|
import javax.swing.JComboBox;
|
|
import javax.swing.JFrame;
|
|
import javax.swing.JLabel;
|
|
import javax.swing.JScrollPane;
|
|
import javax.swing.JTable;
|
|
import javax.swing.border.BevelBorder;
|
|
import javax.swing.table.AbstractTableModel;
|
|
import javax.swing.table.DefaultTableCellRenderer;
|
|
import javax.swing.table.TableColumn;
|
|
import javax.swing.table.TableModel;
|
|
|
|
/*
|
|
* @test
|
|
* @key headful
|
|
* @bug 4112270 8264102 8329756
|
|
* @library /java/awt/regtesthelpers
|
|
* @build PassFailJFrame
|
|
* @summary Test Keyboard Navigation in JTable.
|
|
* @run main/manual KeyBoardNavigation
|
|
*/
|
|
|
|
public class KeyBoardNavigation {
|
|
static JFrame initTest() {
|
|
final String[] names = {"First Name", "Last Name", "Favorite Color",
|
|
"Favorite Number", "Vegetarian"};
|
|
final Object[][] data = {
|
|
{"Mark", "Andrews", "Red", 2, Boolean.TRUE},
|
|
{"Tom", "Ball", "Blue", 99, Boolean.FALSE},
|
|
{"Alan", "Chung", "Green", 838, Boolean.FALSE},
|
|
{"Jeff", "Dinkins", "Turquois", 8, Boolean.TRUE},
|
|
{"Amy", "Fowler", "Yellow", 3, Boolean.FALSE},
|
|
{"Brian", "Gerhold", "Green", 0, Boolean.FALSE},
|
|
{"James", "Gosling", "Pink", 21, Boolean.FALSE},
|
|
{"David", "Karlton", "Red", 1, Boolean.FALSE},
|
|
{"Dave", "Kloba", "Yellow", 14, Boolean.FALSE},
|
|
{"Peter", "Korn", "Purple", 12, Boolean.FALSE},
|
|
{"Phil", "Milne", "Purple", 3, Boolean.FALSE},
|
|
{"Dave", "Moore", "Green", 88, Boolean.FALSE},
|
|
{"Hans", "Muller", "Maroon", 5, Boolean.FALSE},
|
|
{"Rick", "Levenson", "Blue", 2, Boolean.FALSE},
|
|
{"Tim", "Prinzing", "Blue", 22, Boolean.FALSE},
|
|
{"Chester", "Rose", "Black", 0, Boolean.FALSE},
|
|
{"Ray", "Ryan", "Gray", 77, Boolean.FALSE},
|
|
{"Georges", "Saab", "Red", 4, Boolean.FALSE},
|
|
{"Willie", "Walker", "Phthalo Blue", 4, Boolean.FALSE},
|
|
{"Kathy", "Walrath", "Blue", 8, Boolean.FALSE},
|
|
{"Arnaud", "Weber", "Green", 44, Boolean.FALSE}
|
|
};
|
|
|
|
JFrame frame = new JFrame("JTable Keyboard Navigation Test");
|
|
|
|
JTable tableView = getTableDetails(names, data);
|
|
|
|
// Create a combo box to show that you can use one in a table.
|
|
JComboBox<String> comboBox = new JComboBox<>();
|
|
comboBox.addItem("Red");
|
|
comboBox.addItem("Orange");
|
|
comboBox.addItem("Yellow");
|
|
comboBox.addItem("Green");
|
|
comboBox.addItem("Blue");
|
|
comboBox.addItem("Indigo");
|
|
comboBox.addItem("Violet");
|
|
|
|
TableColumn colorColumn = tableView.getColumn("Favorite Color");
|
|
// Use the combo box as the editor in the "Favorite Color" column.
|
|
colorColumn.setCellEditor(new DefaultCellEditor(comboBox));
|
|
|
|
// Set a pink background and tooltip for the Color column renderer.
|
|
DefaultTableCellRenderer colorColumnRenderer = new DefaultTableCellRenderer();
|
|
colorColumnRenderer.setBackground(Color.pink);
|
|
colorColumnRenderer.setToolTipText("Click for combo box");
|
|
colorColumn.setCellRenderer(colorColumnRenderer);
|
|
|
|
// Set a tooltip for the header of the colors column.
|
|
if (colorColumn.getHeaderRenderer() instanceof DefaultTableCellRenderer headerRenderer) {
|
|
headerRenderer.setToolTipText("Hi Mom!");
|
|
}
|
|
|
|
// Set the width of the "Vegetarian" column.
|
|
TableColumn vegetarianColumn = tableView.getColumn("Vegetarian");
|
|
vegetarianColumn.setPreferredWidth(100);
|
|
|
|
// Show the values in the "Favorite Number" column in different colors.
|
|
TableColumn numbersColumn = tableView.getColumn("Favorite Number");
|
|
DefaultTableCellRenderer numberColumnRenderer = new DefaultTableCellRenderer() {
|
|
public void setValue(Object value) {
|
|
int cellValue = (value instanceof Number number) ? number.intValue() : 0;
|
|
setForeground((cellValue > 30) ? Color.black : Color.red);
|
|
setText((value == null) ? "" : value.toString());
|
|
}
|
|
};
|
|
numberColumnRenderer.setHorizontalAlignment(JLabel.RIGHT);
|
|
numbersColumn.setCellRenderer(numberColumnRenderer);
|
|
numbersColumn.setPreferredWidth(110);
|
|
|
|
tableView.setColumnSelectionAllowed(true);
|
|
JScrollPane scrollPane = new JScrollPane(tableView);
|
|
scrollPane.setBorder(new BevelBorder(BevelBorder.LOWERED));
|
|
scrollPane.setPreferredSize(new Dimension(430, 200));
|
|
|
|
frame.add(scrollPane);
|
|
frame.pack();
|
|
return frame;
|
|
}
|
|
|
|
private static JTable getTableDetails(String[] names, Object[][] data) {
|
|
TableModel dataModel = new AbstractTableModel() {
|
|
// These methods always need to be implemented.
|
|
public int getColumnCount() {
|
|
return names.length;
|
|
}
|
|
|
|
public int getRowCount() {
|
|
return data.length;
|
|
}
|
|
|
|
public Object getValueAt(int row, int col) {
|
|
return data[row][col];
|
|
}
|
|
|
|
// The default implementations of these methods in
|
|
// AbstractTableModel would work, but we can refine them.
|
|
public String getColumnName(int column) {
|
|
return names[column];
|
|
}
|
|
|
|
public Class<?> getColumnClass(int c) {
|
|
return getValueAt(0, c).getClass();
|
|
}
|
|
|
|
public boolean isCellEditable(int row, int col) {
|
|
return true;
|
|
}
|
|
|
|
public void setValueAt(Object aValue, int row, int column) {
|
|
System.out.println("Setting value to: " + aValue);
|
|
data[row][column] = aValue;
|
|
}
|
|
};
|
|
|
|
JTable tableView = new JTable(dataModel);
|
|
// Turn off auto-resizing so that we can set column sizes programmatically.
|
|
// In this mode, all columns will get their preferred widths, as set below.
|
|
tableView.setAutoResizeMode(JTable.AUTO_RESIZE_OFF);
|
|
return tableView;
|
|
}
|
|
|
|
public static void main(String[] args) throws Exception {
|
|
String INSTRUCTIONS = """
|
|
Instructions to Test:
|
|
1. Refer the below keyboard navigation specs
|
|
(referenced from bug report 4112270).
|
|
2. Check all combinations of navigational keys mentioned below
|
|
and verify each key combination against the spec defined.
|
|
If it does, press "pass", otherwise press "fail".
|
|
|
|
""";
|
|
|
|
INSTRUCTIONS += getOSSpecificInstructions();
|
|
PassFailJFrame.builder()
|
|
.instructions(INSTRUCTIONS)
|
|
.rows(30)
|
|
.columns(50)
|
|
.testUI(KeyBoardNavigation::initTest)
|
|
.testTimeOut(10)
|
|
.build()
|
|
.awaitAndCheck();
|
|
}
|
|
|
|
public static String getOSSpecificInstructions() {
|
|
final String WINDOWS_SPECIFIC = """
|
|
Tab, Shift-Tab - Navigate In.
|
|
Return/Shift-Return - Move focus one cell down/up.
|
|
Tab/Shift-Tab - Move focus one cell right/left.
|
|
Up/Down Arrow - Deselect current selection; move focus one
|
|
cell up/down
|
|
Left/Right Arrow - Deselect current selection; move focus
|
|
one cell left/right
|
|
PageUp/PageDown - Deselect current selection; scroll up/down
|
|
one JViewport view; first visible cell in
|
|
current column gets focus
|
|
Control-PageUp/PageDown - Deselect current selection;
|
|
move focus and view to
|
|
first/last cell in current row
|
|
Home/End - Deselect current selection; move focus and view to
|
|
first/last cell in current row
|
|
Control-Home/End - Deselect current selection;
|
|
scroll up/down one JViewport view;
|
|
first/last visible row of the table
|
|
F2 - Allows editing in a cell containing information without
|
|
overwriting the information
|
|
Esc - Resets the cell content back to the state it was in
|
|
before editing started
|
|
Ctrl+A, Ctrl+/ - Select All
|
|
Ctrl+\\ - Deselect all
|
|
Shift-Up/Down Arrow - Extend selection up/down one row
|
|
Shift-Left/Right Arrow - Extend selection left/right one
|
|
column
|
|
Control-shift Up/Down Arrow - Extend selection to top/bottom
|
|
of column
|
|
Shift-Home/End - Extend selection to left/right end of row
|
|
Control-Shift-Home/End - Extend selection to beginning/end
|
|
of data
|
|
Shift-PageUp/PageDown - Extend selection up/down one view
|
|
and scroll table
|
|
Control-Shift-PageUp/PageDown - Extend selection left/right
|
|
end of row
|
|
""";
|
|
|
|
final String LINUX_SPECIFIC = """
|
|
Tab, Shift-Tab - Navigate In.
|
|
Return/Shift-Return - Move focus one cell down/up.
|
|
Tab/Shift-Tab - Move focus one cell right/left.
|
|
Up/Down Arrow - Deselect current selection;
|
|
move focus one cell up/down
|
|
Left/Right Arrow - Deselect current selection;
|
|
move focus one cell left/right
|
|
PageUp/PageDown - Deselect current selection;
|
|
scroll up/down one JViewport view;
|
|
first visible cell in current column gets focus
|
|
Home/End - Deselect current selection; move focus and view to
|
|
first/last cell in current row
|
|
F2 - Allows editing in a cell containing information without
|
|
overwriting the information
|
|
Esc - Resets the cell content back to the state it was in
|
|
before editing started
|
|
Ctrl+A, Ctrl+/ - Select All
|
|
Ctrl+\\ - Deselect all
|
|
Shift-Up/Down Arrow - Extend selection up/down one row
|
|
Shift-Left/Right Arrow - Extend selection left/right one column
|
|
Control-Shift Up/Down Arrow - Extend selection to top/bottom of
|
|
column
|
|
Shift-Home/End - Extend selection to left/right end of row
|
|
Shift-PageUp/PageDown - Extend selection up/down one view and
|
|
scroll table
|
|
""";
|
|
|
|
final String MAC_SPECIFIC = """
|
|
Tab, Shift-Tab - Navigate In.
|
|
Return/Shift-Return - Move focus one cell down/up.
|
|
Tab/Shift-Tab - Move focus one cell right/left.
|
|
Up/Down Arrow - Deselect current selection; move focus one cell
|
|
up/down
|
|
Left/Right Arrow - Deselect current selection;
|
|
move focus one cell left/right
|
|
fn+Up/Down Arrow - Deselect current selection;
|
|
scroll up/down one JViewport view;
|
|
first visible cell in current column gets focus
|
|
fn - Allows editing in a cell containing information without
|
|
overwriting the information
|
|
Esc - Resets the cell content back to the state it was in
|
|
before editing started
|
|
Cmd+A - Select All
|
|
Shift-Up/Down Arrow - Extend selection up/down one row
|
|
Shift-Left/Right Arrow - Extend selection left/right one column
|
|
Ctrl-Shift Up/Down Arrow - Extend selection to top/bottom of row
|
|
Ctrl-Shift Left/Right Arrow - Extend selection to first/last of column
|
|
""";
|
|
String osName = System.getProperty("os.name").toLowerCase();
|
|
if (osName.startsWith("mac")) {
|
|
return MAC_SPECIFIC;
|
|
} else if (osName.startsWith("win")) {
|
|
return WINDOWS_SPECIFIC;
|
|
} else {
|
|
return LINUX_SPECIFIC;
|
|
}
|
|
}
|
|
}
|