ilog.views.util.swing.calendar

Class IlvJTimeChooser

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

ilog.views.util.swing.calendar.IlvJTimeChooser

All Implemented Interfaces:

ilog.views.util.swing.validation.IlvValidatableForm, ActionListener, ImageObserver, MenuContainer, Serializable, EventListener

public class IlvJTimeChooser
extends JComponent
implements ilog.views.util.swing.validation.IlvValidatableForm, ActionListener

IlvJTimeChooser is a Swing component that displays the current time.

Since:

JViews 6.0

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
static String	MODEL_CHANGED_PROPERTY Identifies that the time chooser's calendar model has changed.
static String	TIME_FORMAT_CHANGED_PROPERTY Identifies that the time chooser's time format has changed.

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
IlvJTimeChooser() Creates a new IlvJTimeChooser that is initialized with a default data model.
IlvJTimeChooser(IlvCalendarModel model) Creates a new IlvJTimeChooser that is initialized with the specified data model.

Method Summary

Modifier and Type	Method and Description
void	actionPerformed(ActionEvent event) Notifies listeners when an action occurs in this component.
void	addActionListener(ActionListener listener) Adds a listener to the list that is notified when an action is performed in this time chooser.
void	addValidationListener(ilog.views.util.swing.validation.ValidationListener listener) Adds a listener to the list that is notified each time a validation occurs.
protected IlvCalendarModel	createDefaultModel() Returns the default calendar model object for this component, which is an IlvDefaultCalendarModel.
Calendar	getCalendar() Returns the calendar displayed by the time chooser.
IlvCalendarModel	getModel() Returns the data model that holds the calendar displayed by the time chooser.
DateFormat	getTimeFormat() Returns the time format used by the time chooser.
TimeChooserUI	getUI() Returns the look and feel (L&F) object that renders this time chooser.
String	getUIClassID() Returns the suffix used to construct the name of the look and feel (L&F) class used to render this component.
com.ibm.icu.util.ULocale	getULocale() Returns the locale of this component.
boolean	isAllValid() Returns true if all subcomponents are currently valid.
void	removeActionListener(ActionListener listener) Removes a listener from the list that is notified when an action is performed in this time chooser.
void	removeValidationListener(ilog.views.util.swing.validation.ValidationListener listener) Removes a listener from the list that is notified each time a validation occurs.
void	setCalendar(Calendar calendar) Sets the calendar displayed by the time chooser.
void	setLocale(Locale locale) Sets the locale of this component.
void	setModel(IlvCalendarModel model) Sets the data model that holds the calendar displayed by the time chooser.
void	setTimeFormat(DateFormat format) Sets the time format used by the time chooser.
void	setUI(TimeChooserUI ui) Sets the look and feel (L&F) object that renders this time chooser.
void	setULocale(com.ibm.icu.util.ULocale locale) Sets the locale of this component.
void	updateUI() Resets the UI property with the value from the current look and feel.
void	validationPerformed(boolean valid) This method is invoked after a validation was performed.

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

MODEL_CHANGED_PROPERTY

public static final String MODEL_CHANGED_PROPERTY

Identifies that the time chooser's calendar model has changed.

See Also:

Constant Field Values

TIME_FORMAT_CHANGED_PROPERTY

public static final String TIME_FORMAT_CHANGED_PROPERTY

Identifies that the time chooser's time format has changed.

See Also:

Constant Field Values

Constructor Detail

IlvJTimeChooser

public IlvJTimeChooser(IlvCalendarModel model)

Creates a new IlvJTimeChooser that is initialized with the specified data model.

Parameters:

model - The data model for the time chooser.

IlvJTimeChooser

public IlvJTimeChooser()

Creates a new IlvJTimeChooser that is initialized with a default data model.

See Also:

createDefaultModel()

Method Detail

getULocale

public com.ibm.icu.util.ULocale getULocale()

Returns the locale of this component. If none is set on this component, this component inherits its locale from the parent component.

Returns:

An ICU ULocale.

Throws:

IllegalStateException - if this component's locale has been removed through setLocale(null) and none of the ancestors has a Locale set either

Since:

JViews 8.8

See Also:

setULocale(ULocale)

setULocale

public void setULocale(com.ibm.icu.util.ULocale locale)

Sets the locale of this component.

Parameters:

locale - An ICU ULocale, or null if this component shall inherit its locale from the parent component.

Since:

JViews 8.8

See Also:

getULocale(), setLocale(Locale)

setLocale

public void setLocale(Locale locale)

Sets the locale of this component.

Overrides:

setLocale in class Component

Parameters:

locale - An Locale, or null if this component shall inherit its locale from the parent component.

See Also:

setULocale(ULocale)

createDefaultModel

protected IlvCalendarModel createDefaultModel()

Returns the default calendar model object for this component, which is an IlvDefaultCalendarModel. A subclass can override this method to return a different calendar model object.

Returns:

The default calendar model object.

See Also:

getModel(), setModel(ilog.views.util.swing.calendar.IlvCalendarModel)

getModel

public IlvCalendarModel getModel()

Returns the data model that holds the calendar displayed by the time chooser.

See Also:

setModel(ilog.views.util.swing.calendar.IlvCalendarModel), createDefaultModel()

setModel

public void setModel(IlvCalendarModel model)

Sets the data model that holds the calendar displayed by the time chooser.

Parameters:

model - The data model to set.

See Also:

getModel(), createDefaultModel()

getCalendar

public Calendar getCalendar()

Returns the calendar displayed by the time chooser.

See Also:

setCalendar(java.util.Calendar)

setCalendar

public void setCalendar(Calendar calendar)

Sets the calendar displayed by the time chooser.

Parameters:

calendar - The calendar to set.

See Also:

getCalendar()

getUIClassID

public String getUIClassID()

Returns the suffix used to construct the name of the look and feel (L&F) class used to render this component.

Overrides:

getUIClassID in class JComponent

getUI

public TimeChooserUI getUI()

Returns the look and feel (L&F) object that renders this time chooser.

Returns:

The TimeChooserUI object that renders this component.

setUI

public void setUI(TimeChooserUI ui)

Sets the look and feel (L&F) object that renders this time chooser.

Parameters:

ui - The TimeChooserUI L&F object.

updateUI

public void updateUI()

Resets the UI property with the value from the current look and feel.

Overrides:

updateUI in class JComponent

getTimeFormat

public DateFormat getTimeFormat()

Returns the time format used by the time chooser.

See Also:

setTimeFormat(java.text.DateFormat)

setTimeFormat

public void setTimeFormat(DateFormat format)

Sets the time format used by the time chooser.

Parameters:

format - The time format to set.

See Also:

getTimeFormat()

isAllValid

public boolean isAllValid()

Returns true if all subcomponents are currently valid.

Specified by:

isAllValid in interface ilog.views.util.swing.validation.IlvValidatableForm

Since:

JViews 8.8

Internal: do not use!

addValidationListener

public void addValidationListener(ilog.views.util.swing.validation.ValidationListener listener)

Adds a listener to the list that is notified each time a validation occurs.

Specified by:

addValidationListener in interface ilog.views.util.swing.validation.IlvValidatableForm

Parameters:

listener - A validation listener.

Since:

JViews 8.0

Internal: do not use!

removeValidationListener

public void removeValidationListener(ilog.views.util.swing.validation.ValidationListener listener)

Removes a listener from the list that is notified each time a validation occurs.

Specified by:

removeValidationListener in interface ilog.views.util.swing.validation.IlvValidatableForm

Parameters:

listener - A validation listener.

Since:

JViews 8.0

Internal: do not use!

validationPerformed

public void validationPerformed(boolean valid)

This method is invoked after a validation was performed. It notifies all subscribed validation listeners.

Parameters:

valid - True if the validation was successful.

Since:

JViews 8.0

addActionListener

public void addActionListener(ActionListener listener)

Adds a listener to the list that is notified when an action is performed in this time chooser.

Parameters:

listener - A validation listener.

Since:

JViews 8.5

Internal: do not use!

removeActionListener

public void removeActionListener(ActionListener listener)

Removes a listener from the list that is notified when an action is performed in this time chooser.

Parameters:

listener - A validation listener.

Since:

JViews 8.5

Internal: do not use!

actionPerformed

public void actionPerformed(ActionEvent event)

Notifies listeners when an action occurs in this component.

Specified by:

actionPerformed in interface ActionListener

Since:

JViews 8.5