1a05542005-07-28Martin Nilsson class GTK2.Adjustment; inherit GTK2.Data; //! The GTK2.Adjustment object represents a value which has an associated //! lower and upper bound, together with step and page increments, and //! a page size. It is used within several GTK2+ widgets, including //! GtkSpinButton, GtkViewport, and GtkRange (which is a base class for //! GtkHScrollbar, GtkVScrollbar, GtkHScale, and GtkVScale). //! <p> //! The GtkAdjustment object does not update the value itself. Instead //! it is left up to the owner of the GtkAdjustment to control the //! value. //! </p><p> //! The owner of the GtkAdjustment typically calls the value_changed() //! and changed() functions after changing the value or its //! bounds. This results in the emission of the "value_changed" or //! "changed" signal respectively. //! </p> //! Properties: //! float lower //! float page-increment //! float page-size //! float step-increment //! float upper //! float value signal changed; //! The adjustment changed in some way signal value_changed; //! The value changed void create(?float value, ?float lower, ?float upper, ?float step_increment, ?float page_increment, ?float page_size ); //! The value argument is the initial value you want to give to the //! adjustment, usually corresponding to the topmost or leftmost //! position of an adjustable widget. The lower argument specifies the //! lowest value which the adjustment can hold. The step_increment //! argument specifies the "smaller" of the two increments by which //! the user can change the value, while the page_increment is the //! "larger" one. The page_size argument usually corresponds somehow //! to the visible area of a panning widget. The upper argument is //! used to represent the bottom most or right most coordinate in a //! panning widget's child. Therefore it is not always the largest //! number that value can take, since the page_size of such widgets is //! usually non-zero. //! //! All values are optional, they default to 0.0. //! For most widgets the unit is pixels. float get_value(); //! Gets the current value. void set_value(float to); //! Sets the value. The value is clamped to lie between lower and upper. //! <p> //! Note that for adjustments which are used in a W(Scrollbar), the effective //! range of allowed values goes from lower to upper-page_size. void clamp_page(float lower, float upper); //! Updates the W(Adjustment) value to ensure that the range between lower and //! upper is in the current page (i.e. between value and value+page_size). If //! the range is larger than the page size, then only the start of it will be //! in the current page. A "changed" signal will be emitted if the value is //! changed. void changed(); //! Emites a "changed" signal. void value_changed(); //! Emits a "value-changed" signal.