org.havi.ui

Class HRangeValue

java.lang.Object

java.awt.Component

org.havi.ui.HComponent

org.havi.ui.HVisible

org.havi.ui.HStaticRange

org.havi.ui.HRange

org.havi.ui.HRangeValue

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, TestOpacity, HAdjustmentInputPreferred, HAdjustmentValue, HMatteLayer, HNavigable, HNavigationInputPreferred, HNoInputPreferred, HOrientable, HState

public class HRangeValue
extends HRange
implements HAdjustmentValue

The HRangeValue is a user interface component used to display a value within a fixed range (as org.havi.ui.HStaticRange HStaticRange}) which enables a user to navigate to and alter the value of it, i.e. it can have the input focus and it can be adjusted. By default it uses the HRangeLook to render itself. The parameters to the constructors are as follows, in cases where parameters are not used, then the constructor should use the default values.

Default parameter values exposed in the constructors

Parameter	Description	Default value	Set method	Get method
x	x-coordinate of top left hand corner of this component in pixels, relative to its parent container (subject to layout management).	---	java.awt.Component#setBounds	java.awt.Component#getBounds
y	y-coordinate of top left hand corner of this component in pixels, relative to its parent container (subject to layout management).	---	java.awt.Component#setBounds	java.awt.Component#getBounds
width	width of this component in pixels (subject to layout management).	---	java.awt.Component#setBounds	java.awt.Component#getBounds
height	height of this component in pixels (subject to layout management).	---	java.awt.Component#setBounds	java.awt.Component#getBounds
orientation	The "orientation" of the range object.	ORIENT_LEFT_TO_RIGHT	setOrientation	getOrientation
minimum	The minimum value that can be returned by this range object.	0	setRange	getMinValue
maximum	The maximum value that can be returned by this range object.	100	setRange	getMaxValue
value	The current value returned by this range object.	0	setValue	getValue

Default parameter values not exposed in the constructors

Description	Default value	Set method	Get method
Associated matte (HMatte).	none (i.e. getMatte() returns null)	setMatte	getMatte
The text layout manager responsible for text formatting.	An HDefaultTextLayoutManager object.	HVisible.setTextLayoutManager(org.havi.ui.HTextLayoutManager)	HVisible.getTextLayoutManager()
The background painting mode	HVisible.NO_BACKGROUND_FILL	HVisible.setBackgroundMode(int)	HVisible.getBackgroundMode()
The default preferred size	not set (i.e. NO_DEFAULT_SIZE) unless specified by width and height parameters	HVisible.setDefaultSize(java.awt.Dimension)	HVisible.getDefaultSize()
The horizontal content alignment	HVisible.HALIGN_CENTER	HVisible.setHorizontalAlignment(int)	HVisible.getHorizontalAlignment()
The vertical content alignment	HVisible.VALIGN_CENTER	HVisible.setVerticalAlignment(int)	HVisible.getVerticalAlignment()
The content scaling mode	HVisible.RESIZE_NONE	HVisible.setResizeMode(int)	HVisible.getResizeMode()
The border mode	true	HVisible.setBordersEnabled(boolean)	HVisible.getBordersEnabled()
The default "look" for this class.	A platform specific HRangeLook	HRangeValue.setDefaultLook	HRangeValue.getDefaultLook
The "look" for this object.	The HRangeLook returned from HRangeValue.getDefaultLook when this object was created.	HRangeValue.setLook	HRangeValue.getLook
The offsets for the "thumb" of this range control	min = 0, max = 0	setThumbOffsets	getThumbMinOffset / getThumbMaxOffset
The behavior of this range object with respect to its "thumb" values	SLIDER_BEHAVIOR	setBehavior	getBehavior
The block increment for this object.	1 unit	setBlockIncrement	getBlockIncrement
The gain focus sound.	null	setGainFocusSound	getGainFocusSound
The lose focus sound.	null	setLoseFocusSound	getLoseFocusSound

See Also:

HStaticRange, HRange, HNavigable, HAdjustmentValue, Serialized Form

Nested Class Summary

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

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

Field Summary

Fields inherited from class org.havi.ui.HStaticRange

SCROLLBAR_BEHAVIOR, SLIDER_BEHAVIOR

Fields inherited from class org.havi.ui.HVisible

ADJUSTMENT_VALUE_CHANGE, ANIMATE_CONTENT_CHANGE, ANIMATION_POSITION_CHANGE, BACKGROUND_FILL, BORDER_CHANGE, CARET_POSITION_CHANGE, CONTENT_CHANGE, ECHO_CHAR_CHANGE, EDIT_MODE_CHANGE, FIRST_CHANGE, GRAPHIC_CONTENT_CHANGE, HALIGN_CENTER, HALIGN_JUSTIFY, HALIGN_LEFT, HALIGN_RIGHT, ITEM_VALUE_CHANGE, LAST_CHANGE, LIST_CONTENT_CHANGE, LIST_ICONSIZE_CHANGE, LIST_LABELSIZE_CHANGE, LIST_MULTISELECTION_CHANGE, LIST_SCROLLPOSITION_CHANGE, LIST_SELECTION_CHANGE, MIN_MAX_CHANGE, NO_BACKGROUND_FILL, NO_DEFAULT_HEIGHT, NO_DEFAULT_SIZE, NO_DEFAULT_WIDTH, ORIENTATION_CHANGE, REPEAT_COUNT_CHANGE, RESIZE_ARBITRARY, RESIZE_NONE, RESIZE_PRESERVE_ASPECT, SIZE_CHANGE, STATE_CHANGE, TEXT_CONTENT_CHANGE, TEXT_VALUE_CHANGE, THUMB_OFFSETS_CHANGE, UNKNOWN_CHANGE, VALIGN_BOTTOM, VALIGN_CENTER, VALIGN_JUSTIFY, VALIGN_TOP

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface org.havi.ui.HOrientable

ORIENT_BOTTOM_TO_TOP, ORIENT_LEFT_TO_RIGHT, ORIENT_RIGHT_TO_LEFT, ORIENT_TOP_TO_BOTTOM

Fields inherited from interface org.havi.ui.HState

ACTIONED_FOCUSED_STATE, ACTIONED_STATE, ACTIONED_STATE_BIT, ALL_STATES, DISABLED_ACTIONED_FOCUSED_STATE, DISABLED_ACTIONED_STATE, DISABLED_FOCUSED_STATE, DISABLED_STATE, DISABLED_STATE_BIT, FIRST_STATE, FOCUSED_STATE, FOCUSED_STATE_BIT, LAST_STATE, NORMAL_STATE

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

Constructors

Constructor and Description
HRangeValue() Creates an HRangeValue object.
HRangeValue(int orientation, int minimum, int maximum, int value) Creates an HRangeValue object.
HRangeValue(int orientation, int minimum, int maximum, int value, int x, int y, int width, int height) Creates an HRangeValue object.

Method Summary

Methods

Modifier and Type	Method and Description
void	addAdjustmentListener(HAdjustmentListener l) Adds the specified HAdjustmentListener to receive HAdjustmentEvents sent from this object.
void	addHFocusListener(HFocusListener l) Adds the specified HFocusListener to receive HFocusEvent events sent from this HNavigable: If the listener has already been added further calls will add further references to the listener, which will then receive multiple copies of a single event.
HSound	getAdjustmentSound() Get the sound to be played when the value changes.
boolean	getAdjustMode() Get the adjustment mode for this HRangeValue.
int	getBlockIncrement() Get the block increment for this HRangeValue.
static HRangeLook	getDefaultLook() Returns the currently set default look for HRangeValue components.
HSound	getGainFocusSound() Get the sound associated with the gain focus event.
HSound	getLoseFocusSound() Get the sound associated with the lost focus event.
HNavigable	getMove(int keyCode) Provides the HNavigable object that is navigated to when a particular key is pressed.
int[]	getNavigationKeys() Retrieve the set of key codes which this component maps to navigation targets.
int	getUnitIncrement() Get the unit increment for this HRangeValue.
boolean	isSelected() Indicates if this component has focus.
void	processHAdjustmentEvent(HAdjustmentEvent evt) Process an HAdjustmentEvent sent to this HAdjustmentInputPreferred.
void	processHFocusEvent(HFocusEvent evt) Process an HFocusEvent sent to this HRangeValue.
void	removeAdjustmentListener(HAdjustmentListener l) Removes the specified HAdjustmentListener so that it no longer receives HAdjustmentEvents from this object.
void	removeHFocusListener(HFocusListener l) Removes the specified HFocusListener so that it no longer receives HFocusEvent events from this HNavigable.
void	setAdjustmentSound(HSound sound) Associate a sound to be played when the value is modified.
void	setAdjustMode(boolean adjust) Set the adjustment mode for this HRangeValue.
void	setBlockIncrement(int increment) Set the block increment for this HRangeValue.
static void	setDefaultLook(HRangeLook look) Sets the default HLook for further HRangeValue Components.
void	setFocusTraversal(HNavigable up, HNavigable down, HNavigable left, HNavigable right) Set the focus control for an HNavigable component.
void	setGainFocusSound(HSound sound) Associate a sound with gaining focus, i.e.
void	setLoseFocusSound(HSound sound) Associate a sound with losing focus, i.e.
void	setMove(int keyCode, HNavigable target) Defines the navigation path from the current HNavigable to another HNavigable when a particular key is pressed.
void	setUnitIncrement(int increment) Set the unit increment for this HRangeValue.

Methods inherited from class org.havi.ui.HStaticRange

getBehavior, getMaxValue, getMinValue, getOrientation, getThumbMaxOffset, getThumbMinOffset, getValue, setBehavior, setLook, setOrientation, setRange, setThumbOffsets, setValue

Methods inherited from class org.havi.ui.HVisible

getAnimateContent, getBackgroundMode, getBordersEnabled, getContent, getDefaultSize, getGraphicContent, getHorizontalAlignment, getInteractionState, getLook, getLookData, getMaximumSize, getMinimumSize, getPreferredSize, getResizeMode, getTextContent, getTextLayoutManager, getVerticalAlignment, isFocusTraversable, isOpaque, paint, setAnimateContent, setBackgroundMode, setBordersEnabled, setContent, setDefaultSize, setEnabled, setGraphicContent, setHorizontalAlignment, setInteractionState, setLookData, setResizeMode, setTextContent, setTextLayoutManager, setVerticalAlignment, update

Methods inherited from class org.havi.ui.HComponent

getMatte, isDoubleBuffered, isEnabled, processEvent, setMatte

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isFocusable, isFocusCycleRoot, isFocusOwner, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, validate

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.havi.ui.HOrientable

getOrientation, setOrientation

Constructor Detail

HRangeValue

public HRangeValue()

Creates an HRangeValue object. See the class description for details of constructor parameters and default values.

HRangeValue

public HRangeValue(int orientation,
           int minimum,
           int maximum,
           int value,
           int x,
           int y,
           int width,
           int height)

Creates an HRangeValue object. See the class description for details of constructor parameters and default values.

HRangeValue

public HRangeValue(int orientation,
           int minimum,
           int maximum,
           int value)

Creates an HRangeValue object. See the class description for details of constructor parameters and default values.

Method Detail

setDefaultLook

public static void setDefaultLook(HRangeLook look)

Sets the default HLook for further HRangeValue Components.

Parameters:

look - The HLook that will be used by default when creating a new HRangeValue component. Note that this parameter may be null, in which case newly created components shall not draw themselves until a non-null look is set using the setLook method.

getDefaultLook

public static HRangeLook getDefaultLook()

Returns the currently set default look for HRangeValue components.

Returns:

The look that is used by default when creating a new HRangeValue component.

setMove

public void setMove(int keyCode,
           HNavigable target)

Defines the navigation path from the current HNavigable to another HNavigable when a particular key is pressed.

Note that setFocusTraversal is equivalent to multiple calls to setMove, where the key codes VK_UP, VK_DOWN, VK_LEFT, VK_RIGHT are used.

Specified by:

setMove in interface HNavigable

Overrides:

setMove in class HRange

Parameters:

keyCode - The key code of the pressed key. Any numerical keycode is allowed, but the platform may not be able to generate all keycodes. Application authors should only use keys for which HRcCapabilities.isSupported() or HKeyCapabilities.isSupported() returns true.

target - The target HNavigable object that should be navigated to. If a target is to be removed from a particular navigation path, then null shall be specified.

getMove

public HNavigable getMove(int keyCode)

Provides the HNavigable object that is navigated to when a particular key is pressed.

Specified by:

getMove in interface HNavigable

Overrides:

getMove in class HRange

Parameters:

keyCode - The key code of the pressed key.

Returns:

Returns the HNavigable object or null if no HNavigable is associated with the keyCode.

setFocusTraversal

public void setFocusTraversal(HNavigable up,
                     HNavigable down,
                     HNavigable left,
                     HNavigable right)

Set the focus control for an HNavigable component. Note setFocusTraversal is a convenience function for application programmers where a standard up, down, left and right focus traversal between components is required.

Note setFocusTraversal is equivalent to multiple calls to setMove, where the key codes VK_UP, VK_DOWN, VK_LEFT, VK_RIGHT are used.

Note that this API does not prevent the creation of "isolated" HNavigable components --- authors should endeavor to avoid confusing the user.

Specified by:

setFocusTraversal in interface HNavigable

Overrides:

setFocusTraversal in class HRange

Parameters:

up - The HNavigable component to move to, when the user generates a VK_UP KeyEvent. If there is no HNavigable component to move "up" to, then null shall be specified.

down - The HNavigable component to move to, when the user generates a VK_DOWN KeyEvent. If there is no HNavigable component to move "down" to, then null shall be specified.

left - The HNavigable component to move to, when the user generates a VK_LEFT KeyEvent. If there is no HNavigable component to move "left" to, then null shall be specified.

right - The HNavigable component to move to, when the user generates a VK_RIGHT KeyEvent. If there is no HNavigable component to move "right" to, then null shall be specified.

isSelected

public boolean isSelected()

Indicates if this component has focus.

Specified by:

isSelected in interface HNavigable

Overrides:

isSelected in class HRange

Returns:

true if the component has focus, otherwise returns false.

setGainFocusSound

public void setGainFocusSound(HSound sound)

Associate a sound with gaining focus, i.e. when the HNavigable receives a HFocusEvent event of type FOCUS_GAINED. This sound will start to be played when an object implementing this interface gains focus. It is not guaranteed to be played to completion. If the object implementing this interface loses focus before the audio completes playing, the audio will be truncated. Applications wishing to ensure the audio is always played to completion must implement special logic to slow down the focus transitions.

By default, an HNavigable object does not have any gain focus sound associated with it.

Note that the ordering of playing sounds is dependent on the order of the focus lost, gained events.

Specified by:

setGainFocusSound in interface HNavigable

Overrides:

setGainFocusSound in class HRange

Parameters:

sound - the sound to be played, when the component gains focus. If sound content is already set, the original content is replaced. To remove the sound specify a null HSound.

setLoseFocusSound

public void setLoseFocusSound(HSound sound)

Associate a sound with losing focus, i.e. when the HNavigable receives a HFocusEvent event of type FOCUS_LOST. This sound will start to be played when an object implementing this interface loses focus. It is not guaranteed to be played to completion. It is implementation dependent whether and when this sound will be truncated by any gain focus sound played by the next object to gain focus.

By default, an HNavigable object does not have any lose focus sound associated with it.

Note that the ordering of playing sounds is dependent on the order of the focus lost, gained events.

Specified by:

setLoseFocusSound in interface HNavigable

Overrides:

setLoseFocusSound in class HRange

Parameters:

sound - the sound to be played, when the component loses focus. If sound content is already set, the original content is replaced. To remove the sound specify a null HSound.

getGainFocusSound

public HSound getGainFocusSound()

Get the sound associated with the gain focus event.

Specified by:

getGainFocusSound in interface HNavigable

Overrides:

getGainFocusSound in class HRange

Returns:

The sound played when the component gains focus. If no sound is associated with gaining focus, then null shall be returned.

getLoseFocusSound

public HSound getLoseFocusSound()

Get the sound associated with the lost focus event.

Specified by:

getLoseFocusSound in interface HNavigable

Overrides:

getLoseFocusSound in class HRange

Returns:

The sound played when the component loses focus. If no sound is associated with losing focus, then null shall be returned.

addHFocusListener

public void addHFocusListener(HFocusListener l)

Adds the specified HFocusListener to receive HFocusEvent events sent from this HNavigable: If the listener has already been added further calls will add further references to the listener, which will then receive multiple copies of a single event.

Specified by:

addHFocusListener in interface HNavigable

Overrides:

addHFocusListener in class HRange

Parameters:

l - the HFocusListener to add

removeHFocusListener

public void removeHFocusListener(HFocusListener l)

Removes the specified HFocusListener so that it no longer receives HFocusEvent events from this HNavigable. If the specified listener is not registered, the method has no effect. If multiple references to a single listener have been registered it should be noted that this method will only remove one reference per call.

Specified by:

removeHFocusListener in interface HNavigable

Overrides:

removeHFocusListener in class HRange

Parameters:

l - the HFocusListener to remove

getNavigationKeys

public int[] getNavigationKeys()

Retrieve the set of key codes which this component maps to navigation targets.

Specified by:

getNavigationKeys in interface HNavigationInputPreferred

Overrides:

getNavigationKeys in class HRange

Returns:

an array of key codes, or null if no navigation targets are set on this component.

processHFocusEvent

public void processHFocusEvent(HFocusEvent evt)

Process an HFocusEvent sent to this HRangeValue.

Specified by:

processHFocusEvent in interface HNavigationInputPreferred

Overrides:

processHFocusEvent in class HRange

Parameters:

evt - the HFocusEvent to process.

setUnitIncrement

public void setUnitIncrement(int increment)

Set the unit increment for this HRangeValue.

Specified by:

setUnitIncrement in interface HAdjustmentValue

Parameters:

increment - the amount by which the value of the HRangeValue should change when an HAdjustmentEvent.ADJUST_LESS or HAdjustmentEvent.ADJUST_MORE event is received. Values of increment less than one shall be treated as a value of one.

getUnitIncrement

public int getUnitIncrement()

Get the unit increment for this HRangeValue. 1 shall be returned if this method is called before its corresponding set method.

Specified by:

getUnitIncrement in interface HAdjustmentValue

Returns:

the increment value for this HRangeValue.

setBlockIncrement

public void setBlockIncrement(int increment)

Set the block increment for this HRangeValue.

Specified by:

setBlockIncrement in interface HAdjustmentValue

Parameters:

increment - the amount by which the value of the HRangeValue should change when an HAdjustmentEvent.ADJUST_PAGE_LESS or HAdjustmentEvent.ADJUST_PAGE_MORE event is received. Values of increment less than one shall be treated as a value of one.

getBlockIncrement

public int getBlockIncrement()

Get the block increment for this HRangeValue. 1 shall be returned if this method is called before its corresponding set method.

Specified by:

getBlockIncrement in interface HAdjustmentValue

Returns:

the block increment value for this HRangeValue.

addAdjustmentListener

public void addAdjustmentListener(HAdjustmentListener l)

Adds the specified HAdjustmentListener to receive HAdjustmentEvents sent from this object. If the listener has already been added further calls will add further references to the listener, which will then receive multiple copies of a single event.

Specified by:

addAdjustmentListener in interface HAdjustmentValue

Parameters:

l - the HAdjustmentListener to be notified.

removeAdjustmentListener

public void removeAdjustmentListener(HAdjustmentListener l)

Removes the specified HAdjustmentListener so that it no longer receives HAdjustmentEvents from this object. If the specified listener is not registered, the method has no effect. If multiple references to a single listener have been registered it should be noted that this method will only remove one reference per call.

Specified by:

removeAdjustmentListener in interface HAdjustmentValue

Parameters:

l - the HAdjustmentListener to be removed from notification.

setAdjustmentSound

public void setAdjustmentSound(HSound sound)

Associate a sound to be played when the value is modified. The sound is played irrespective of whether an HAdjustmentEvent is sent to one or more listeners.

Specified by:

setAdjustmentSound in interface HAdjustmentValue

Parameters:

sound - the sound to be played, when the value is modified. If sound content is already set, the original content is replaced. To remove the sound specify a null HSound.

getAdjustmentSound

public HSound getAdjustmentSound()

Get the sound to be played when the value changes. null shall be returned if this method is called before its corresponding set method.

Specified by:

getAdjustmentSound in interface HAdjustmentValue

Returns:

The sound played when the value changes

getAdjustMode

public boolean getAdjustMode()

Get the adjustment mode for this HRangeValue. If the returned value is true the component is in adjustment mode, and its value may be changed on receipt of HAdjustmentEvent.ADJUST_LESS and HAdjustmentEvent.ADJUST_MORE events.

The component is switched into and out of adjustment mode on receiving HAdjustmentEvent.ADJUST_START_CHANGE HAdjustmentEvent.ADJUST_END_CHANGE events. Note that these events are ignored, if the component is disabled.

Specified by:

getAdjustMode in interface HAdjustmentInputPreferred

Returns:

true if this component is in adjustment mode, false otherwise.

See Also:

HComponent.setEnabled(boolean)

setAdjustMode

public void setAdjustMode(boolean adjust)

Set the adjustment mode for this HRangeValue.

This method is provided for the convenience of component implementors. Interoperable applications shall not call this method. It cannot be made protected because interfaces cannot have protected methods.

Calls to this method shall be ignored, if the component is disabled.

Specified by:

setAdjustMode in interface HAdjustmentInputPreferred

Parameters:

adjust - true to switch this component into adjustment mode, false otherwise.

See Also:

HAdjustmentInputPreferred.getAdjustMode(), HComponent.setEnabled(boolean)

processHAdjustmentEvent

public void processHAdjustmentEvent(HAdjustmentEvent evt)

Process an HAdjustmentEvent sent to this HAdjustmentInputPreferred. Widgets implementing this interface shall ignore HAdjustmentEvents, while the component is disabled.

Specified by:

processHAdjustmentEvent in interface HAdjustmentInputPreferred

Parameters:

evt - the HAdjustmentEvent to process.

See Also:

HComponent.setEnabled(boolean)