_
ButtonA Gtk_Spin_Button is a single line text editing widget for text that represents a number. At the right hand side of the text line there are small up- and down arrow buttons for incrementing or decrementing (spinning) the number within a given range. It allows the value to have zero or a number of decimal places and to be incremented/decremented in configurable steps. The action of holding down one of the buttons optionally results in an acceleration of change in the value according to how long it is depressed.
see section Package Gtk.GEntry for a text editing widget without spin buttons.
Widget Hierarchy |
---|
GObject (see section Package Glib.Object)
Gtk_Object (see section Package Gtk.Object)
\___ Gtk_Widget (see section Package Gtk.Widget)
\___ Gtk_Editable (see section Package Gtk.Editable)
\___ Gtk_Entry (see section Package Gtk.GEntry)
\___ Gtk_Spin_Button (see section Package Gtk.Spin
|
Types |
---|
type Gtk_Spin_Button_Update_Policy is (Update_Always, -- Update always, errors are ignored while converting text into a -- numeric value. Update_If_Valid -- The spin button's value gets changed if the text input is a numeric -- value that is within the range specified by the adjustment. ); | |
Determine the update policy of the spin button which affects the
behaviour when parsing inserted text and syncing its value with the
values of the adjustment.
pragma Convention (C, Gtk_Spin_Button_Update_Policy);
| |
type Gtk_Spin_Type is (Spin_Step_Forward, Spin_Step_Backward, Spin_Page_Forward, Spin_Page_Backward, Spin_Home, Spin_End, Spin_User_Defined); | |
Determine how manual spinning should be done.
See also the Spin procedure.
pragma Convention (C, Gtk_Spin_Type);
|
Subprograms |
---|
procedure Gtk_New (Spin_Button : out Gtk_Spin_Button; Adjustment : Gtk.Adjustment.Gtk_Adjustment; Climb_Rate : Gdouble; The_Digits : Gint); | ||
Create a spin button with the given parameters. | ||
procedure Gtk_New (Spin_Button : out Gtk_Spin_Button; Min : Gdouble; Max : Gdouble; Step : Gdouble); | ||
Same as above, but with explicit range instead of an adjustment. | ||
function Get_Type return Gtk.Gtk_Type; | ||
Return the internal value associated with a Gtk_Spin_Button.
| ||
procedure Set_Adjustment (Spin_Button : access Gtk_Spin_Button_Record; Adjustment : Gtk.Adjustment.Gtk_Adjustment); | ||
Set the adjustment settings of the spin button.
| ||
function Get_Adjustment (Spin_Button : access Gtk_Spin_Button_Record) return Gtk.Adjustment.Gtk_Adjustment; | ||
Return the adjustment settings of the spin button.
| ||
procedure Set_Digits (Spin_Button : access Gtk_Spin_Button_Record; The_Digits : Guint); | ||
Set number of decimals of the spin button.
| ||
function Get_Digits (Spin_Button : access Gtk_Spin_Button_Record) return Guint; | ||
Return the number of decimals of the spin button.
| ||
procedure Set_Increments (Spin_Button : access Gtk_Spin_Button_Record; Step : Gdouble; Page : Gdouble); | ||
Set increments for a single step and a page move.
| ||
procedure Get_Increments (Spin_Button : access Gtk_Spin_Button_Record; Step : out Gdouble; Page : out Gdouble); | ||
Return increments for a single step and a page move.
| ||
procedure Set_Range (Spin_Button : access Gtk_Spin_Button_Record; Min : Gdouble; Max : Gdouble); | ||
Set range of the spin button.
| ||
procedure Get_Range (Spin_Button : access Gtk_Spin_Button_Record; Min : out Gdouble; Max : out Gdouble); | ||
Return range of the spin button.
| ||
function Get_Value (Spin_Button : access Gtk_Spin_Button_Record) return Gdouble; | ||
Return the current value of the spin button in a float.
| ||
function Get_Value_As_Int (Spin_Button : access Gtk_Spin_Button_Record) return Gint; | ||
Return the current value of the spin button in an integer.
| ||
procedure Set_Value (Spin_Button : access Gtk_Spin_Button_Record; Value : Gdouble); | ||
Set the current value of the spin button.
| ||
procedure Set_Update_Policy (Spin_Button : access Gtk_Spin_Button_Record; Policy : Gtk_Spin_Button_Update_Policy); | ||
Set the update policy of the spin button. | ||
function Get_Update_Policy (Spin_Button : access Gtk_Spin_Button_Record) return Gtk_Spin_Button_Update_Policy; | ||
Return the update policy of the spin button.
| ||
procedure Set_Numeric (Spin_Button : access Gtk_Spin_Button_Record; Numeric : Boolean); | ||
If Numeric is True, then only a numeric value can be typed in the | ||
function Get_Numeric (Spin_Button : access Gtk_Spin_Button_Record) return Boolean; | ||
Return whether only numeric values can be typedin the text entry.
| ||
procedure Spin (Spin_Button : access Gtk_Spin_Button_Record; Direction : Gtk_Spin_Type; Step : Gdouble); | ||
Set the value of the spin button relative to its current value. | ||
procedure Set_Wrap (Spin_Button : access Gtk_Spin_Button_Record; Wrap : Boolean); | ||
Set whether the spin button should "wrap around" when exceeding the | ||
function Get_Wrap (Spin_Button : access Gtk_Spin_Button_Record) return Boolean; | ||
Return whether the spin button will "wrap around" when exceeding the | ||
procedure Set_Snap_To_Ticks (Spin_Button : access Gtk_Spin_Button_Record; Snap_To_Ticks : Boolean); | ||
Set the spin button to round the value to the nearest step value | ||
function Get_Snap_To_Ticks (Spin_Button : access Gtk_Spin_Button_Record) return Boolean; | ||
Return whether the spin button rounds the value to the nearest step | ||
procedure Update (Spin_Button : access Gtk_Spin_Button_Record); | ||
Manually force an update of the spin button.
|