org.gnu.gtk

Class Scale

public abstract class Scale extends Range

Deprecated: This class is part of the java-gnome 2.x family of libraries, which, due to their inefficiency and complexity, are no longer being maintained and have been abandoned by the java-gnome project. This class may in the future have an equivalent in java-gnome 4.0, try looking for org.gnome.gtk.Scale. You should be aware that there is a considerably different API in the new library: the architecture is completely different and most notably internals are no longer exposed to public view.

A Scale is a slider control used to select a numeric value. To use it, you'll probably want to investigate the methods on its base class, Range, in addition to the methods for Scale itself. To set the value of a scale, you would normally use Range. To detect changes to the value, add RangeListener object to the widget.

The GtkScale widget is an abstract class, used only for deriving the subclasses HScale and VScale.

See Also: HScale

Method Summary
booleangetDrawValue()
Returns whether the current value is displayed as a string next to the slider.
ClassgetEventListenerClass(String signal)
EventTypegetEventType(String signal)
LayoutgetLayout()
Gets the Layout used to display the scale.
intgetLayoutOffsetX()
Obtains the X coordinate where the scale will draw the Layout representing the text in the scale.
intgetLayoutOffsetY()
Obtains the Y coordinate where the scale will draw the Layout representing the text in the scale.
static TypegetType()
Retrieve the runtime type used by the GLib library.
voidremoveFormatListener()
Removes the format listener
voidsetDigits(int digits)
Sets the number of decimal places that are displayed in the value.
voidsetDrawValue(boolean setting)
Specifies whether the current value is displayed as a string next to the slider.
voidsetFormatListener(ScaleListener listener)
Sets a listener to be used when a format-value request is called.
voidsetValuePosition(PositionType pos)
Sets the position in which the current value is displayed.

Method Detail

getDrawValue

public boolean getDrawValue()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Returns whether the current value is displayed as a string next to the slider.

getEventListenerClass

public Class getEventListenerClass(String signal)

getEventType

public EventType getEventType(String signal)

getLayout

public Layout getLayout()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Gets the Layout used to display the scale.

Returns: The Layout for this scale, or NULL if the Scale is FALSE.

getLayoutOffsetX

public int getLayoutOffsetX()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Obtains the X coordinate where the scale will draw the Layout representing the text in the scale.

If Scale is FALSE, the return value is undefined.

getLayoutOffsetY

public int getLayoutOffsetY()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Obtains the Y coordinate where the scale will draw the Layout representing the text in the scale.

If Scale is FALSE, the return value is undefined.

getType

public static Type getType()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Retrieve the runtime type used by the GLib library.

removeFormatListener

public void removeFormatListener()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Removes the format listener

setDigits

public void setDigits(int digits)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Sets the number of decimal places that are displayed in the value. Also causes the value of the adjustment to be rounded off to this number of digits, so the retrieved value matches the value the user saw.

Parameters: digits The number of decimal places to display, e.g. use 1 to display 1.0, 2 to display 1.00 etc.

setDrawValue

public void setDrawValue(boolean setting)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Specifies whether the current value is displayed as a string next to the slider.

Parameters: setting If true, the value is displayed.

setFormatListener

public void setFormatListener(ScaleListener listener)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Sets a listener to be used when a format-value request is called.

setValuePosition

public void setValuePosition(PositionType pos)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Sets the position in which the current value is displayed.

Parameters: pos The position in which the current value is displayed.