org.gnu.gtk

Class Range

Known Direct Subclasses:
Scale, ScrollBar

public abstract class Range
extends Widget

This is the base class for the group of widgets that involve graphic display and manipulation of a vale bounded within a specific minumumand maximum value.

See Also:
HScale, HScrollBar, VScale, VScrollBar

Field Summary

Fields inherited from class org.gnu.glib.GObject

eventsInitialized

Constructor Summary

Range(Handle handle)
Create a new Widget with a handle to a native resource returned from a call to the native libraries.

Method Summary

void
addListener(RangeListener listener)
Register an object to handle range events.
void
addRangeListener(RangeListener listener)
Register an object to handle range events.
protected void
fireRangeEvent(RangeEvent event)
Adjustment
getAdjustment()
Get the Adjustment which is the "model" object for Range.
Class
getEventListenerClass(String signal)
EventType
getEventType(String signal)
boolean
getInverted()
Gets the vaue set by setInverted(boolean).
static Type
getType()
Retrieve the runtime type used by the GLib library.
UpdateType
getUpdatePolicy()
Gets the update policy
double
getValue()
Gets the current value of the range.
protected static Handle
gtk_range_get_adjustment(Handle range)
protected static boolean
gtk_range_get_inverted(Handle range)
protected static int
gtk_range_get_type()
protected static int
gtk_range_get_update_policy(Handle range)
protected static double
gtk_range_get_value(Handle range)
protected static void
gtk_range_set_adjustment(Handle range, Handle adjustment)
protected static void
gtk_range_set_increments(Handle range, double step, double page)
protected static void
gtk_range_set_inverted(Handle range, boolean setting)
protected static void
gtk_range_set_range(Handle range, double min, double max)
protected static void
gtk_range_set_update_policy(Handle range, int policy)
protected static void
gtk_range_set_value(Handle range, double value)
void
removeRangeListener(RangeListener listener)
Removes a listener
void
setAdjustment(Adjustment adjustment)
Sets the adjustment to be used as the "model" object for this range widget.
void
setIncrements(double step, double page)
Sets the step and page sizes for the range.
void
setInverted(boolean setting)
Ranges normally move from lower to higher values as the slider moves from top to bottom or left to right.
void
setRange(double min, double max)
Sets the allowable values in the Range, and clamps the range value to be between min and max.
void
setUpdatePolicy(UpdateType policy)
Sets the update policy for the Adjustment
void
setValue(double value)
Sets the current value of the range; if the value is outside the minimum or maximum range values, it will be clamped to fit inside them.

Methods inherited from class org.gnu.gtk.Widget

activate, addListener, addListener, addListener, addListener, addListener, addListener, addListener, addListener, canActivateAccel, createContext, createLayout, destroy, draw, drawArea, drawArea, findListener, finish, fireBooleanLifeCycleEvent, fireDragDestinationEvent, fireDragSourceEvent, fireExposeEvent, fireFocusEvent, fireKeyEvent, fireLifeCycleEvent, fireMouseEvent, fireMouseMotionEvent, getAccessible, getColormap, getContext, getData, getDisplay, getEventListenerClass, getEventType, getModifierStyle, getName, getParent, getParentWindow, getPointer, getRootWindow, getScreen, getSensitive, getStyle, getToplevel, getType, getWindow, grabDefault, grabFocus, gtk_drag_dest_set, gtk_drag_dest_unset, gtk_drag_finish, gtk_drag_get_data, gtk_drag_highlight, gtk_drag_source_set, gtk_drag_source_set_icon, gtk_drag_source_set_icon_pixbuf, gtk_drag_source_set_icon_stock, gtk_drag_source_unset, gtk_drag_unhighlight, gtk_widget_activate, gtk_widget_add_accelerator, gtk_widget_add_events, gtk_widget_add_mnemonic_label, gtk_widget_can_activate_accel, gtk_widget_child_focus, gtk_widget_child_notify, gtk_widget_class_path, gtk_widget_create_pango_context, gtk_widget_create_pango_layout, gtk_widget_destroy, gtk_widget_destroyed, gtk_widget_ensure_style, gtk_widget_event, gtk_widget_freeze_child_notify, gtk_widget_get_accessible, gtk_widget_get_ancestor, gtk_widget_get_child_requisition, gtk_widget_get_child_visible, gtk_widget_get_colormap, gtk_widget_get_composite_name, gtk_widget_get_default_colormap, gtk_widget_get_default_direction, gtk_widget_get_default_style, gtk_widget_get_default_visual, gtk_widget_get_direction, gtk_widget_get_display, gtk_widget_get_events, gtk_widget_get_extension_events, gtk_widget_get_modifier_style, gtk_widget_get_name, gtk_widget_get_pango_context, gtk_widget_get_parent, gtk_widget_get_parent_window, gtk_widget_get_pointer, gtk_widget_get_root_window, gtk_widget_get_screen, gtk_widget_get_sensitive, gtk_widget_get_settings, gtk_widget_get_size_request, gtk_widget_get_style, gtk_widget_get_toplevel, gtk_widget_get_type, gtk_widget_get_visual, gtk_widget_get_window, gtk_widget_grab_default, gtk_widget_grab_focus, gtk_widget_has_screen, gtk_widget_hide, gtk_widget_hide_all, gtk_widget_hide_on_delete, gtk_widget_intersect, gtk_widget_is_ancestor, gtk_widget_is_focus, gtk_widget_list_accel_closures, gtk_widget_list_mnemonic_labels, gtk_widget_map, gtk_widget_mnemonic_activate, gtk_widget_modify_base, gtk_widget_modify_bg, gtk_widget_modify_fg, gtk_widget_modify_font, gtk_widget_modify_style, gtk_widget_modify_text, gtk_widget_path, gtk_widget_pop_colormap, gtk_widget_pop_composite_child, gtk_widget_push_colormap, gtk_widget_push_composite_child, gtk_widget_queue_draw, gtk_widget_queue_draw_area, gtk_widget_queue_resize, gtk_widget_realize, gtk_widget_ref, gtk_widget_region_intersect, gtk_widget_remove_accelerator, gtk_widget_remove_mnemonic_label, gtk_widget_render_icon, gtk_widget_reparent, gtk_widget_reset_rc_styles, gtk_widget_send_expose, gtk_widget_set_accel_path, gtk_widget_set_app_paintable, gtk_widget_set_child_visible, gtk_widget_set_colormap, gtk_widget_set_composite_name, gtk_widget_set_default_colormap, gtk_widget_set_default_direction, gtk_widget_set_direction, gtk_widget_set_double_buffered, gtk_widget_set_events, gtk_widget_set_extension_events, gtk_widget_set_name, gtk_widget_set_parent, gtk_widget_set_parent_window, gtk_widget_set_redraw_on_allocate, gtk_widget_set_scroll_adjustments, gtk_widget_set_sensitive, gtk_widget_set_size_request, gtk_widget_set_state, gtk_widget_set_style, gtk_widget_shape_combine_mask, gtk_widget_show, gtk_widget_show_all, gtk_widget_show_now, gtk_widget_size_allocate, gtk_widget_size_request, gtk_widget_style_get_property, gtk_widget_thaw_child_notify, gtk_widget_translate_coordinates, gtk_widget_unmap, gtk_widget_unparent, gtk_widget_unrealize, gtk_widget_unref, handleButtonPressed, handleButtonReleased, handleDelete, handleDragDataGet, handleDragDestination, handleExpose, handleFocusIn, handleFocusOut, handleHide, handleKeyPressed, handleKeyReleased, handleMap, handleMouseEnter, handleMouseLeave, handleMouseMotion, handleNoExpose, handleRealize, handleScroll, handleShow, handleUnmap, hasFocus, hasScreen, hide, hideAll, highlight, intersect, isAncestor, makeWidget, modifyStyle, popColormap, pushColormap, realize, removeListener, removeListener, removeListener, removeListener, removeListener, removeListener, removeListener, removeListener, reparent, setBackgroundColor, setBaseColor, setColormap, setDoubleBuffered, setDragDestination, setDragIcon, setDragIconPixbuf, setDragIconStock, setDragSource, setFont, setForegroundColor, setMinimumSize, setName, setNoDragDestination, setNoDragSource, setSensitive, setTextColor, shapeCombineMask, show, showAll, unHighlight

Methods inherited from class org.gnu.gtk.GtkObject

destroy, getFlags, getType, gtk_object_destroy, gtk_object_get_type, gtk_object_sink, setFlags, sink

Methods inherited from class org.gnu.glib.GObject

addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addListener, equals, freezeNotify, getBooleanProperty, getData, getData, getDoubleProperty, getEventListenerClass, getEventType, getFloatProperty, getGObjectFromHandle, getHandle, getIntFromHandle, getIntProperty, getJavaObjectProperty, getLongProperty, getNullHandle, getPixbufProperty, getProperty, getStringFromHandle, getStringProperty, hasProperty, hashCode, instantiateJGObjectFromGType, notify, removeEventHandler, removeListener, retrieveGObject, setBooleanProperty, setData, setData, setDoubleProperty, setFloatProperty, setHandle, setIntProperty, setJavaObjectProperty, setLongProperty, setPixbufProperty, setProperty, setStringProperty, thawNotify

Constructor Details

Range

protected Range(Handle handle)
Create a new Widget with a handle to a native resource returned from a call to the native libraries.

Parameters:
handle - The handle that represents a pointer to a native resource.

Method Details

addListener

public void addListener(RangeListener listener)
Register an object to handle range events.

See Also:
RangeListener


addRangeListener

public void addRangeListener(RangeListener listener)
Register an object to handle range events.

See Also:
RangeListener


fireRangeEvent

protected void fireRangeEvent(RangeEvent event)


getAdjustment

public Adjustment getAdjustment()
Get the Adjustment which is the "model" object for Range.

Returns:
The adjustment model


getEventListenerClass

public Class getEventListenerClass(String signal)
Overrides:
getEventListenerClass in interface Widget


getEventType

public EventType getEventType(String signal)
Overrides:
getEventType in interface Widget


getInverted

public boolean getInverted()

Returns:
True of the slider is inverted


getType

public static Type getType()
Retrieve the runtime type used by the GLib library.
Overrides:
getType in interface Widget


getUpdatePolicy

public UpdateType getUpdatePolicy()
Gets the update policy

Returns:
The current update policy


getValue

public double getValue()
Gets the current value of the range.

Returns:
Current value of the range.


gtk_range_get_adjustment

protected static final Handle gtk_range_get_adjustment(Handle range)


gtk_range_get_inverted

protected static final boolean gtk_range_get_inverted(Handle range)


gtk_range_get_type

protected static final int gtk_range_get_type()


gtk_range_get_update_policy

protected static final int gtk_range_get_update_policy(Handle range)


gtk_range_get_value

protected static final double gtk_range_get_value(Handle range)


gtk_range_set_adjustment

protected static final void gtk_range_set_adjustment(Handle range,
                                                     Handle adjustment)


gtk_range_set_increments

protected static final void gtk_range_set_increments(Handle range,
                                                     double step,
                                                     double page)


gtk_range_set_inverted

protected static final void gtk_range_set_inverted(Handle range,
                                                   boolean setting)


gtk_range_set_range

protected static final void gtk_range_set_range(Handle range,
                                                double min,
                                                double max)


gtk_range_set_update_policy

protected static final void gtk_range_set_update_policy(Handle range,
                                                        int policy)


gtk_range_set_value

protected static final void gtk_range_set_value(Handle range,
                                                double value)


removeRangeListener

public void removeRangeListener(RangeListener listener)
Removes a listener

See Also:
addRangeListener(RangeListener)


setAdjustment

public void setAdjustment(Adjustment adjustment)
Sets the adjustment to be used as the "model" object for this range widget. The adjustment indicates the current range value, the minimum and maximum range values, the step/page increments used for keybindings and scrolling, and the page size. The page size is normally 0 for Scale and nonzero for ScrollBar, and indicates the size of the visible area of the widget being scrolled. The page size affects the size of the scrollbar slider.

Parameters:
adjustment - The model to use


setIncrements

public void setIncrements(double step,
                          double page)
Sets the step and page sizes for the range. The step size is used when the user clicks the ScrollBar arrows or moves Scale via arrow keys. The page size is used for example when moving via Page Up or Page Down keys.

Parameters:
step - Step size
page - Page size


setInverted

public void setInverted(boolean setting)
Ranges normally move from lower to higher values as the slider moves from top to bottom or left to right. Inverted ranges have higher values at the top or on the right rather than on the bottom or left.

Parameters:
setting - TRUE to invert the range


setRange

public void setRange(double min,
                     double max)
Sets the allowable values in the Range, and clamps the range value to be between min and max. (If the range has a non-zero page size, it is clamped between min and max - page-size.)

Parameters:
min - Minimum range value
max - Maximum range value


setUpdatePolicy

public void setUpdatePolicy(UpdateType policy)
Sets the update policy for the Adjustment


setValue

public void setValue(double value)
Sets the current value of the range; if the value is outside the minimum or maximum range values, it will be clamped to fit inside them. An event is called if the value changes.

Parameters:
value - The new value of the range