HildonSeekbar

HildonSeekbar — A widget used to identify a place from a content.

Synopsis




            HildonSeekbar;
GtkWidget*  hildon_seekbar_new              (void);
gint        hildon_seekbar_get_total_time   (HildonSeekbar *seekbar);
void        hildon_seekbar_set_total_time   (HildonSeekbar *seekbar,
                                             gint time);
gint        hildon_seekbar_get_position     (HildonSeekbar *seekbar);
void        hildon_seekbar_set_position     (HildonSeekbar *seekbar,
                                             gint time);
void        hildon_seekbar_set_fraction     (HildonSeekbar *seekbar,
                                             guint fraction);
guint       hildon_seekbar_get_fraction     (HildonSeekbar *seekbar);

Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkRange
                           +----GtkScale
                                 +----HildonSeekbar

Implemented Interfaces

HildonSeekbar implements GtkBuildable and AtkImplementorIface.

Properties


  "fraction"             gdouble               : Read / Write
  "position"             gdouble               : Read / Write
  "total-time"           gdouble               : Read / Write

Description

HildonSeekbar allows seeking in media with a range widget. It supports for setting or getting the length (total time) of the media, the position within it and the fraction (maximum position in a stream/the amount currently downloaded). The position is clamped between zero and the total time, or zero and the fraction in case of a stream.

Details

HildonSeekbar

typedef struct _HildonSeekbar HildonSeekbar;

hildon_seekbar_new ()

GtkWidget*  hildon_seekbar_new              (void);

Create a new HildonSeekbar widget.

Returns : a GtkWidget pointer of HildonSeekbar widget

hildon_seekbar_get_total_time ()

gint        hildon_seekbar_get_total_time   (HildonSeekbar *seekbar);

seekbar : pointer to HildonSeekbar widget
Returns : total playing time of media in seconds.

hildon_seekbar_set_total_time ()

void        hildon_seekbar_set_total_time   (HildonSeekbar *seekbar,
                                             gint time);

Set total playing time of media in seconds.

seekbar : pointer to HildonSeekbar widget
time : integer greater than zero

hildon_seekbar_get_position ()

gint        hildon_seekbar_get_position     (HildonSeekbar *seekbar);

Get current position in stream in seconds.

seekbar : pointer to HildonSeekbar widget
Returns : current position in stream in seconds

hildon_seekbar_set_position ()

void        hildon_seekbar_set_position     (HildonSeekbar *seekbar,
                                             gint time);

Set current position in stream in seconds.

seekbar : pointer to HildonSeekbar widget
time : time within range of >= 0 && < G_MAXINT

hildon_seekbar_set_fraction ()

void        hildon_seekbar_set_fraction     (HildonSeekbar *seekbar,
                                             guint fraction);

Set current fraction value of the range. It should be between the minimal and maximal values of the range in seekbar.

seekbar : pointer to HildonSeekbar widget
fraction : the new position of the progress indicator

hildon_seekbar_get_fraction ()

guint       hildon_seekbar_get_fraction     (HildonSeekbar *seekbar);

Get current fraction value of the rage.

seekbar : pointer to HildonSeekbar widget
Returns : current fraction

Property Details

The "fraction" property

  "fraction"             gdouble               : Read / Write

Current fraction related to the progress indicator.

Allowed values: >= 0

Default value: 0

The "position" property

  "position"             gdouble               : Read / Write

Current position in this media file.

Allowed values: >= 0

Default value: 0

The "total-time" property

  "total-time"           gdouble               : Read / Write

Total playing time of this media file.

Allowed values: >= 0

Default value: 0