org.gnu.gtk

Class Scale

public abstract class Scale extends Range

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, {@link Range}, in addition to the methods for Scale itself. To set the value of a scale, you would normally use {@link Range#setValue(double)}. 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 {@link HScale} and {@link VScale}.

See Also: HScale VScale

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 {@link org.gnu.pango.Layout} used to display the scale.
intgetLayoutOffsetX()
Obtains the X coordinate where the scale will draw the {@link org.gnu.pango.Layout} representing the text in the scale.
intgetLayoutOffsetY()
Obtains the Y coordinate where the scale will draw the {@link org.gnu.pango.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()
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()
Gets the {@link org.gnu.pango.Layout} used to display the scale.

Returns: The {@link org.gnu.pango.Layout} for this scale, or NULL if the {@link #getDrawValue} is FALSE.

getLayoutOffsetX

public int getLayoutOffsetX()
Obtains the X coordinate where the scale will draw the {@link org.gnu.pango.Layout} representing the text in the scale.

If {@link #getDrawValue} is FALSE, the return value is undefined.

getLayoutOffsetY

public int getLayoutOffsetY()
Obtains the Y coordinate where the scale will draw the {@link org.gnu.pango.Layout} representing the text in the scale.

If {@link #getDrawValue} is FALSE, the return value is undefined.

getType

public static Type getType()
Retrieve the runtime type used by the GLib library.

removeFormatListener

public void removeFormatListener()
Removes the format listener

setDigits

public void setDigits(int digits)
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)
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)
Sets a listener to be used when a format-value request is called.

setValuePosition

public void setValuePosition(PositionType pos)
Sets the position in which the current value is displayed.

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