/* * 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 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; } } }