MxKineticScrollView

MxKineticScrollView — A kinetic scrolling container widget

Synopsis

struct              MxKineticScrollView;
ClutterActor *      mx_kinetic_scroll_view_new          (void);
void                mx_kinetic_scroll_view_stop         (MxKineticScrollView *scroll);
void                mx_kinetic_scroll_view_set_deceleration
                                                        (MxKineticScrollView *scroll,
                                                         gdouble rate);
gdouble             mx_kinetic_scroll_view_get_deceleration
                                                        (MxKineticScrollView *scroll);
void                mx_kinetic_scroll_view_set_use_captured
                                                        (MxKineticScrollView *scroll,
                                                         gboolean use_captured);
gboolean            mx_kinetic_scroll_view_get_use_captured
                                                        (MxKineticScrollView *scroll);
void                mx_kinetic_scroll_view_set_mouse_button
                                                        (MxKineticScrollView *scroll,
                                                         guint32 button);
guint32             mx_kinetic_scroll_view_get_mouse_button
                                                        (MxKineticScrollView *scroll);
void                mx_kinetic_scroll_view_set_overshoot
                                                        (MxKineticScrollView *scroll,
                                                         gdouble overshoot);
gdouble             mx_kinetic_scroll_view_get_overshoot
                                                        (MxKineticScrollView *scroll);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----ClutterActor
               +----MxWidget
                     +----MxBin
                           +----MxKineticScrollView

Implemented Interfaces

MxKineticScrollView implements ClutterScriptable, ClutterAnimatable, AtkImplementorIface, MxStylable, ClutterContainer, MxFocusable and MxScrollable.

Properties

  "deceleration"             gdouble               : Read / Write
  "mouse-button"             guint                 : Read / Write
  "overshoot"                gdouble               : Read / Write
  "use-captured"             gboolean              : Read / Write

Description

MxKineticScrollView is a single child container for actors that implements MxScrollable. It allows the contained child to be dragged to scroll, and maintains the momentum once the drag is complete. Deceleration after dragging is configurable, and it will always snap to the "step-increment" boundary.

MxKineticScrollView also implements MxScrollable itself, allowing it to be embedded in an MxScrollView to provide scroll-bars.

Details

struct MxKineticScrollView

struct MxKineticScrollView;

The contents of this structure is private and should only be accessed using the provided API.


mx_kinetic_scroll_view_new ()

ClutterActor *      mx_kinetic_scroll_view_new          (void);

Creates a new MxKineticScrollView.

Returns :

a newly allocated MxKineticScrollView

mx_kinetic_scroll_view_stop ()

void                mx_kinetic_scroll_view_stop         (MxKineticScrollView *scroll);

Stops any current movement due to kinetic scrolling.

scroll :

A MxKineticScrollView

mx_kinetic_scroll_view_set_deceleration ()

void                mx_kinetic_scroll_view_set_deceleration
                                                        (MxKineticScrollView *scroll,
                                                         gdouble rate);

Sets the deceleration rate when a drag is finished on the kinetic scroll-view. This is the value that the momentum is divided by every 60th of a second.

scroll :

A MxKineticScrollView

rate :

The deceleration rate

mx_kinetic_scroll_view_get_deceleration ()

gdouble             mx_kinetic_scroll_view_get_deceleration
                                                        (MxKineticScrollView *scroll);

Retrieves the deceleration rate of the kinetic scroll-view.

scroll :

A MxKineticScrollView

Returns :

The deceleration rate of the kinetic scroll-view

mx_kinetic_scroll_view_set_use_captured ()

void                mx_kinetic_scroll_view_set_use_captured
                                                        (MxKineticScrollView *scroll,
                                                         gboolean use_captured);

Sets whether to use captured events to initiate drag events. This can be used to block events that would initiate scrolling from reaching the child actor.

scroll :

A MxKineticScrollView

use_captured :

TRUE to use captured events

mx_kinetic_scroll_view_get_use_captured ()

gboolean            mx_kinetic_scroll_view_get_use_captured
                                                        (MxKineticScrollView *scroll);

Gets the "use-captured" property.

scroll :

A MxKineticScrollView

Returns :

TRUE if captured-events should be used to initiate scrolling

mx_kinetic_scroll_view_set_mouse_button ()

void                mx_kinetic_scroll_view_set_mouse_button
                                                        (MxKineticScrollView *scroll,
                                                         guint32 button);

Sets the mouse button number used to initiate drag events on the kinetic scroll-view.

scroll :

A MxKineticScrollView

button :

A mouse button number

mx_kinetic_scroll_view_get_mouse_button ()

guint32             mx_kinetic_scroll_view_get_mouse_button
                                                        (MxKineticScrollView *scroll);

Gets the "mouse-button" property

scroll :

A MxKineticScrollView

Returns :

The mouse button number used to initiate drag events on the kinetic scroll-view

mx_kinetic_scroll_view_set_overshoot ()

void                mx_kinetic_scroll_view_set_overshoot
                                                        (MxKineticScrollView *scroll,
                                                         gdouble overshoot);

Sets the rate at which the view will decelerate when scrolling beyond its boundaries. The deceleration rate will be multiplied by this value every 60th of a second when the view is scrolling outside of the range set by its adjustments.

See mx_kinetic_scroll_view_set_deceleration()

scroll :

A MxKineticScrollView

overshoot :

The rate at which the view will decelerate when scrolling beyond its boundaries.

mx_kinetic_scroll_view_get_overshoot ()

gdouble             mx_kinetic_scroll_view_get_overshoot
                                                        (MxKineticScrollView *scroll);

Retrieves the deceleration rate multiplier used when the scroll-view is scrolling beyond its boundaries.

scroll :

A MxKineticScrollView

Property Details

The "deceleration" property

  "deceleration"             gdouble               : Read / Write

Rate at which the view will decelerate in.

Allowed values: >= 1.1

Default value: 1.1


The "mouse-button" property

  "mouse-button"             guint                 : Read / Write

The mouse button used to control scrolling.

Default value: 1


The "overshoot" property

  "overshoot"                gdouble               : Read / Write

The rate at which the view will decelerate when scrolled beyond its boundaries.

Allowed values: [0,1]

Default value: 0


The "use-captured" property

  "use-captured"             gboolean              : Read / Write

Use captured events to initiate scrolling.

Default value: FALSE