com.github.lgooddatepicker.tableeditors.DateTimeTableEditor Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of LGoodDatePicker Show documentation
Java 8 Swing Date Picker. Easy to use, good looking, nice features, and localized. Uses the JSR-310 standard.
The newest version!
package com.github.lgooddatepicker.tableeditors;

import com.github.lgooddatepicker.components.DatePickerSettings;
import com.github.lgooddatepicker.components.DateTimePicker;
import com.github.lgooddatepicker.components.TimePickerSettings;
import com.github.lgooddatepicker.zinternaltools.InternalUtilities;
import com.privatejgoodies.forms.layout.ConstantSize;
import java.awt.Color;
import java.awt.Component;
import java.awt.event.MouseEvent;
import java.time.LocalDateTime;
import java.util.EventObject;
import javax.swing.AbstractCellEditor;
import javax.swing.JLabel;
import javax.swing.JTable;
import javax.swing.border.Border;
import javax.swing.border.EmptyBorder;
import javax.swing.table.DefaultTableCellRenderer;
import javax.swing.table.TableCellEditor;
import javax.swing.table.TableCellRenderer;

/**
 * DateTimeTableEditor, This class is used to add a DateTimePicker to cells (or entire columns) of a
 * Swing JTable or a SwingX JXTable component. This class can be used as a table cell "Editor", or
 * as a "Renderer", or as both editor and renderer. Separate class instances should be used for the
 * editor and the renderer.
 *
 * 
 * // Usage example:
 * // Create a table.
 * JTable table = new JTable();
 * //Set up a renderer and editor for the LocalDateTime type.
 * table.setDefaultRenderer(LocalDateTime.class, new DateTimeTableEditor());
 * table.setDefaultEditor(LocalDateTime.class, new DateTimeTableEditor());
 * 
 *
 * The DateTimePicker and Settings: The DateTimePicker and picker settings can be accessed with the
 * supplied getter functions. Note that most of the settings for the DateTimePicker are left at
 * their default values, but a few (mostly cosmetic) settings are changed in the DateTimeTableEditor
 * constructor. See the DateTimeTableEditor constructor implementation to learn which default
 * settings were changed.
 *
 * Auto adjust row height: By default, this class will automatically adjust the minimum height of
 * all table rows. This occurs during the first time that any cell with an editor or render is
 * displayed. The row height is only adjusted if the current table row height value is below the
 * minimum value that is needed to display the DateTimePicker component. This auto adjust behavior
 * can be turned off from the constructor.
 *
 */
public class DateTimeTableEditor extends AbstractCellEditor
        implements TableCellEditor, TableCellRenderer {

    /**
     * autoAdjustMinimumTableRowHeight, This indicates whether the minimum table row height (for all
     * rows) should be modified when an editor or render is displayed. The row height is only
     * adjusted if it is below the minimum value needed to display the DateTimePicker component.
     */
    private boolean autoAdjustMinimumTableRowHeight = true;

    /**
     * clickCountToEdit, An integer specifying the number of clicks needed to start editing. Even if
     * clickCountToEdit is defined as zero, it will not initiate until a click occurs.
     */
    public int clickCountToEdit = 1;

    /**
     * matchTableBackgroundColor, This indicates whether this table editor should set the picker
     * text area background color to match the background color of the table. The default value is
     * true.
     */
    private boolean matchTableBackgroundColor = true;

    /**
     * matchTableSelectionBackgroundColor, This indicates whether this table editor should set the
     * picker text area background color to match the background color of the table selection (when
     * selected). The default value is true.
     */
    private boolean matchTableSelectionBackgroundColor = true;

    /**
     * borderFocusedCell, This holds the border that is used when a cell has focus.
     */
    private Border borderFocusedCell;

    /**
     * borderUnfocusedCell, This holds the border that is used when a cell does not have focus.
     */
    private Border borderUnfocusedCell;

    /**
     * dateTimepicker, This holds the DateTimePicker instance.
     */
    private DateTimePicker dateTimePicker;

    /**
     * minimumRowHeight, This holds the minimum row height needed to display the DateTimePicker.
     */
    private int minimumRowHeightInPixels;

    /**
     * Constructor, default.
     */
    public DateTimeTableEditor() {
        this(true, true, true);
    }

    /**
     * Constructor, with options.
     *
     * @param autoAdjustMinimumTableRowHeight Set this to true to have this class automatically
     * adjust the the minimum row height of all rows in the table, the first time that a
     * DateTimeTableEditor is displayed. Set this to false to turn off any row height adjustments.
     * The default value is true.
     */
    public DateTimeTableEditor(boolean autoAdjustMinimumTableRowHeight,
            boolean matchTableBackgroundColor, boolean matchTableSelectionBackgroundColor) {
        // Save the constructor parameters.
        this.autoAdjustMinimumTableRowHeight = autoAdjustMinimumTableRowHeight;
        this.matchTableBackgroundColor = matchTableBackgroundColor;
        this.matchTableSelectionBackgroundColor = matchTableSelectionBackgroundColor;
        // Create the borders that should be used for focused and unfocused cells.
        JLabel exampleDefaultRenderer = (JLabel) new DefaultTableCellRenderer().
                getTableCellRendererComponent(new JTable(), "", true, true, 0, 0);
        borderFocusedCell = exampleDefaultRenderer.getBorder();
        borderUnfocusedCell = new EmptyBorder(1, 1, 1, 1);
        // Create and set up the DateTimePicker.
        dateTimePicker = new DateTimePicker();
        dateTimePicker.timePicker.setEnableArrowKeys(false);
        dateTimePicker.setBorder(borderUnfocusedCell);
        dateTimePicker.setGapSize(2, ConstantSize.PIXEL);
        dateTimePicker.setBackground(Color.white);
        dateTimePicker.datePicker.setBackground(Color.white);
        dateTimePicker.timePicker.setBackground(Color.white);
        dateTimePicker.datePicker.getComponentDateTextField().setBorder(null);
        dateTimePicker.timePicker.getComponentTimeTextField().setBorder(null);
        // Adjust any needed picker settings.
        DatePickerSettings dateSettings = dateTimePicker.datePicker.getSettings();
        dateSettings.setGapBeforeButtonPixels(0);
        dateSettings.setSizeTextFieldMinimumWidthDefaultOverride(false);
        dateSettings.setSizeTextFieldMinimumWidth(20);
        TimePickerSettings timeSettings = dateTimePicker.timePicker.getSettings();
        timeSettings.setGapBeforeButtonPixels(0);
        timeSettings.setSizeTextFieldMinimumWidthDefaultOverride(false);
        timeSettings.setSizeTextFieldMinimumWidth(20);
        // Calculate and store the minimum row height needed to display the DateTimePicker.
        minimumRowHeightInPixels = (dateTimePicker.getPreferredSize().height + 1);
    }

    /**
     * getCellEditorValue, This returns the value contained in the editor. This is required by the
     * CellEditor interface.
     */
    @Override
    public Object getCellEditorValue() {
        return dateTimePicker.getDateTimePermissive();
    }

    /**
     * getDateTimePicker, Returns the DateTimePicker which is used by this class.
     */
    public DateTimePicker getDateTimePicker() {
        return dateTimePicker;
    }

    /**
     * getDatePickerSettings, Returns the DatePicker settings for the DateTimePicker used by this
     * class. These settings can be adjusted as desired by the programmer.
     */
    public DatePickerSettings getDatePickerSettings() {
        return dateTimePicker.datePicker.getSettings();
    }

    /**
     * getTimePickerSettings, Returns the TimePicker settings for the DateTimePicker used by this
     * class. These settings can be adjusted as desired by the programmer.
     */
    public TimePickerSettings getTimePickerSettings() {
        return dateTimePicker.timePicker.getSettings();
    }

    /**
     * getTableCellEditorComponent, this returns the editor that is used for editing the cell. This
     * is required by the TableCellEditor interface.
     *
     * For additional details, see the Javadocs for the function:
     * TableCellEditor.getTableCellEditorComponent().
     */
    @Override
    public Component getTableCellEditorComponent(JTable table, Object value,
            boolean isSelected, int row, int column) {
        // Save the supplied value to the DateTimePicker.
        setCellEditorValue(value);
        // If needed, adjust the minimum row height for the table.
        zAdjustTableRowHeightIfNeeded(table);
        // This fixes a bug where the picker text could "move around" during a table resize event.
        dateTimePicker.datePicker.getComponentDateTextField().setScrollOffset(0);
        dateTimePicker.timePicker.getComponentTimeTextField().setScrollOffset(0);
        // Return the DateTimepicker component.
        return dateTimePicker;
    }

    /**
     * getTableCellRendererComponent, Returns the renderer that is used for drawing the cell. This
     * is required by the TableCellRenderer interface.
     *
     * For additional details, see the Javadocs for the function:
     * TableCellRenderer.getTableCellRendererComponent().
     */
    @Override
    public Component getTableCellRendererComponent(JTable table, Object value,
            boolean isSelected, boolean hasFocus, int row, int column) {
        // Save the supplied value to the DateTimePicker.
        setCellEditorValue(value);
        // Draw the appropriate background colors to indicate a selected or unselected state.
        if (isSelected) {
            if (matchTableSelectionBackgroundColor) {
                Color selectionBackground = table.getSelectionBackground();
                dateTimePicker.setBackground(selectionBackground);
                dateTimePicker.datePicker.setBackground(selectionBackground);
                dateTimePicker.timePicker.setBackground(selectionBackground);
                dateTimePicker.datePicker.getComponentDateTextField().setBackground(selectionBackground);
                dateTimePicker.timePicker.getComponentTimeTextField().setBackground(selectionBackground);
            } else {
                dateTimePicker.datePicker.zDrawTextFieldIndicators();
                dateTimePicker.timePicker.zDrawTextFieldIndicators();
            }
        }
        if (!isSelected) {
            if (matchTableBackgroundColor) {
                Color tableBackground = table.getBackground();
                dateTimePicker.setBackground(tableBackground);
                dateTimePicker.datePicker.setBackground(tableBackground);
                dateTimePicker.timePicker.setBackground(tableBackground);
                dateTimePicker.datePicker.getComponentDateTextField().setBackground(tableBackground);
                dateTimePicker.timePicker.getComponentTimeTextField().setBackground(tableBackground);
            } else {
                dateTimePicker.datePicker.zDrawTextFieldIndicators();
                dateTimePicker.timePicker.zDrawTextFieldIndicators();
            }
        }
        // Draw the appropriate borders to indicate a focused or unfocused state.
        if (hasFocus) {
            dateTimePicker.setBorder(borderFocusedCell);
        } else {
            dateTimePicker.setBorder(borderUnfocusedCell);
        }
        // If needed, adjust the minimum row height for the table.
        zAdjustTableRowHeightIfNeeded(table);
        // This fixes a bug where the picker text could "move around" during a table resize event.
        dateTimePicker.datePicker.getComponentDateTextField().setScrollOffset(0);
        dateTimePicker.timePicker.getComponentTimeTextField().setScrollOffset(0);
        // Return the DateTimePicker component.
        return dateTimePicker;
    }

    /**
     * isCellEditable, Returns true if anEvent is not a MouseEvent. Otherwise, it returns true if
     * the necessary number of clicks have occurred, and returns false otherwise.
     */
    @Override
    public boolean isCellEditable(EventObject anEvent) {
        if (anEvent instanceof MouseEvent) {
            return ((MouseEvent) anEvent).getClickCount() >= clickCountToEdit;
        }
        return true;
    }

    /**
     * setCellEditorValue, This sets the picker to an appropriate value for the supplied object. If
     * the value is null, then picker will be cleared. If the value is a LocalDateTime instance,
     * then the picker will be set to that value. All other types (including strings) will be read
     * or converted to a string with a maximum length of the first 100 characters. The date picker
     * text will be set with the resulting string.
     */
    public void setCellEditorValue(Object value) {
        dateTimePicker.clear();
        if (value == null) {
            return;
        }
        if (value instanceof LocalDateTime) {
            LocalDateTime nativeValue = (LocalDateTime) value;
            dateTimePicker.setDateTimePermissive(nativeValue);
        } else {
            String text = value.toString();
            String shorterText = InternalUtilities.safeSubstring(text, 0, 100);
            dateTimePicker.datePicker.setText(shorterText);
        }
    }

    /**
     * zAdjustTableRowHeightIfNeeded, If needed, this will adjust the row height for all rows in the
     * supplied table to fit the minimum row height that is needed to display the DateTimePicker
     * component.
     *
     * If autoAdjustMinimumTableRowHeight is false, this will do nothing. If the row height of the
     * table is already greater than or equal to "minimumRowHeightInPixels", then this will do
     * nothing.
     */
    private void zAdjustTableRowHeightIfNeeded(JTable table) {
        if (!autoAdjustMinimumTableRowHeight) {
            return;
        }
        if ((table.getRowHeight() < minimumRowHeightInPixels)) {
            table.setRowHeight(minimumRowHeightInPixels);
        }
    }

}