GogSeries

GogSeries — Set of plot data

Synopsis




            GogSeries;
            GogSeriesElement;
gboolean    gog_series_is_valid             (GogSeries const *series);
gboolean    gog_series_has_legend           (GogSeries const *series);
GODataScalar* gog_series_get_name           (GogSeries const *series);
GogPlot*    gog_series_get_plot             (GogSeries const *series);
void        gog_series_set_name             (GogSeries *series,
                                             GODataScalar *name_src,
                                             GError **err);
void        gog_series_set_dim              (GogSeries *series,
                                             int dim_i,
                                             GOData *val,
                                             GError **err);
void        gog_series_set_index            (GogSeries *series,
                                             int ind,
                                             gboolean is_manual);
unsigned    gog_series_num_elements         (GogSeries const *series);
GListconst  	 * gog_series_get_overrides    (GogSeries const *series);


Object Hierarchy


  GObject
   +----GogObject
         +----GogStyledObject
               +----GogSeries

  GObject
   +----GogObject
         +----GogStyledObject
               +----GogSeriesElement

Implemented Interfaces

GogSeries implements GogDataset.

Properties


  "has-legend"           gboolean              : Read / Write
  "index"                gint                  : Read / Write

Description

Details

GogSeries

typedef struct _GogSeries GogSeries;


GogSeriesElement

typedef struct _GogSeriesElement GogSeriesElement;


gog_series_is_valid ()

gboolean    gog_series_is_valid             (GogSeries const *series);

series : GogSeries
Returns : the current cached validity. Does not recheck

gog_series_has_legend ()

gboolean    gog_series_has_legend           (GogSeries const *series);

series : GogSeries
Returns : TRUE if the series has a visible legend entry

gog_series_get_name ()

GODataScalar* gog_series_get_name           (GogSeries const *series);

Gets the _source_ of the name associated with the series. NOTE : this is _NOT_ the actual name.

series : a GogSeries
Returns : a GODataScalar, without added reference.

gog_series_get_plot ()

GogPlot*    gog_series_get_plot             (GogSeries const *series);

series : GogSeries
Returns : the possibly NULL plot that contains this series.

gog_series_set_name ()

void        gog_series_set_name             (GogSeries *series,
                                             GODataScalar *name_src,
                                             GError **err);

Absorbs a ref to name_src.

series : a GogSeries
name_src : a GODataScalar
err : a Gerror

gog_series_set_dim ()

void        gog_series_set_dim              (GogSeries *series,
                                             int dim_i,
                                             GOData *val,
                                             GError **err);

Absorbs a ref to val

series : GogSeries
dim_i :
val : GOData
err : optional Gerror pointer

gog_series_set_index ()

void        gog_series_set_index            (GogSeries *series,
                                             int ind,
                                             gboolean is_manual);

If index >= 0 attempt to assign the new index. Auto indicies (is_manual == FALSE) will not override the current index if it is manual. An index < 0, will reset the index to automatic and potentially queue a revaluation of the parent chart's cardinality.

series : GogSeries
ind :
is_manual :

gog_series_num_elements ()

unsigned    gog_series_num_elements         (GogSeries const *series);

series : GogSeries
Returns : the number of elements in the series

gog_series_get_overrides ()

GListconst  	 * gog_series_get_overrides    (GogSeries const *series);

series :
Returns :

Property Details

The "has-legend" property

  "has-legend"           gboolean              : Read / Write

Should the series show up in legends.

Default value: TRUE


The "index" property

  "index"                gint                  : Read / Write

Index of the corresponding data element.

Allowed values: >= 0

Default value: 0