Top | ![]() |
![]() |
![]() |
![]() |
GogPlot * | gog_plot_new_by_type () |
GogPlot * | gog_plot_new_by_name () |
void | gog_plot_request_cardinality_update () |
void | gog_plot_get_cardinality () |
void | gog_plot_update_cardinality () |
void | gog_plot_foreach_elem () |
GSList const * | gog_plot_get_series () |
GOData * | gog_plot_get_axis_bounds () |
gboolean | gog_plot_supports_vary_style_by_element () |
GogSeries * | gog_plot_new_series () |
GogPlotDesc const * | gog_plot_description () |
GogAxisSet | gog_plot_axis_set_pref () |
gboolean | gog_plot_axis_set_is_valid () |
gboolean | gog_plot_axis_set_assign () |
void | gog_plot_axis_clear () |
void | gog_plot_set_axis () |
GogAxis * | gog_plot_get_axis () |
void | gog_plot_update_3d () |
void | gog_plot_guru_helper () |
void | gog_plot_clear_series () |
int | gog_plot_view_get_data_at_point () |
gchar * | guru-hints | Read / Write |
gchar * | interpolation | Read / Write |
gchar * | plot-group | Read / Write |
gboolean | vary-style-by-element | Read / Write |
guint | x-axis | Read / Write |
guint | y-axis | Read / Write |
This is the object that visualizes data.
To manipulate the data shown in the plot, use gog_plot_new_series()
and
gog_plot_clear_series()
Plots are implemented as plug-ins, so make sure the plug-in system is
initialized before trying to create one. See go_plugins_init()
GOffice ships a number of common plot implementations by default.
void gog_plot_get_cardinality (GogPlot *plot
,unsigned *full
,unsigned *visible
);
Return the number of logical elements in the plot.
See gog_chart_get_cardinality
.
full
and visible
may be NULL.
void gog_plot_update_cardinality (GogPlot *plot
,int index_num
);
Update cardinality and cache result. See gog_chart_get_cardinality
.
void gog_plot_foreach_elem (GogPlot *plot
,gboolean only_visible
,GogEnumFunc handler
,gpointer data
);
GOData * gog_plot_get_axis_bounds (GogPlot *plot
,GogAxisType axis
,GogPlotBoundInfo *bounds
);
Queries plot
for its axis preferences for axis
and stores the results in
bounds
. All elements of bounds
are initialized to sane values before the
query _EXCEPT_ ::fmt. The caller is responsible for initializing it. This
is done so that once on plot has selected a format the others need not do
the lookup too if so desired.
Caller is responsible for unrefing ::fmt.
gboolean
gog_plot_supports_vary_style_by_element
(GogPlot const *plot
);
gboolean gog_plot_axis_set_is_valid (GogPlot const *plot
,GogAxisSet type
);
void gog_plot_axis_clear (GogPlot *plot
,GogAxisSet filter
);
A utility method to clear all existing axis associations flagged by filter
int gog_plot_view_get_data_at_point (GogPlotView *view
,double x
,double y
,GogSeries **series
);
Search a data represented at (x
,y
) in view
and set series
on success.
typedef struct { GogObjectClass base; GogPlotDesc desc; GType series_type; GogAxisSet axis_set; /* Virtuals */ GOData *(*axis_get_bounds) (GogPlot *plot, GogAxisType axis, GogPlotBoundInfo *bounds); gboolean (*supports_vary_style_by_element) (GogPlot const *plot); /* %TRUE if the plot prefers to display series in reverse order for * legends (e.g. stacked plots want top element to be the last series) */ gboolean (*enum_in_reverse) (GogPlot const *plot); void (*foreach_elem) (GogPlot *plot, gboolean only_visible, GogEnumFunc handler, gpointer data); void (*update_3d) (GogPlot *plot); void (*guru_helper) (GogPlot *plot, char const *hint); } GogPlotClass;
typedef struct { struct { double minima, maxima; } val, logical; gboolean is_discrete; gboolean center_on_ticks; GOFormat *fmt; const GODateConventions *date_conv; } GogPlotBoundInfo;
“guru-hints”
property“guru-hints” gchar *
Semicolon separated list of hints for automatic addition of objects in guru dialog.
Flags: Read / Write
Default value: NULL
“interpolation”
property“interpolation” gchar *
Default type of series line interpolation.
Flags: Read / Write
Default value: "linear"
“plot-group”
property“plot-group” gchar *
Name of plot group if any.
Flags: Read / Write
Default value: NULL
“vary-style-by-element”
property“vary-style-by-element” gboolean
Use a different style for each segments.
Flags: Read / Write
Default value: FALSE
“x-axis”
property“x-axis” guint
Reference to X axis.
Flags: Read / Write
Allowed values: <= G_MAXINT
Default value: 0
“y-axis”
property“y-axis” guint
Reference to Y axis.
Flags: Read / Write
Allowed values: <= G_MAXINT
Default value: 0