GtkDatabox

GtkDatabox — A GTK+ widget to display large amounts of numerical data quickly and easily.

Synopsis

#include <gtkdatabox.h>

                    GtkDataboxPrivate;
                    GtkDatabox;

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkDatabox

Implemented Interfaces

GtkDatabox implements AtkImplementorIface and GtkBuildable.

Properties

  "adjustment-x"             GtkAdjustment*        : Read / Write / Construct
  "adjustment-y"             GtkAdjustment*        : Read / Write / Construct
  "enable-selection"         gboolean              : Read / Write / Construct
  "enable-zoom"              gboolean              : Read / Write / Construct
  "ruler-x"                  GtkDataboxRuler*      : Read / Write / Construct
  "ruler-y"                  GtkDataboxRuler*      : Read / Write / Construct
  "scale-type-x"             GtkDataboxScaleType   : Read / Write / Construct
  "scale-type-y"             GtkDataboxScaleType   : Read / Write / Construct

Signals

  "selection-canceled"                             : Run First
  "selection-changed"                              : Run First
  "selection-finalized"                            : Run First
  "selection-started"                              : Run First
  "zoomed"                                         : Run First

Description

GtkDatabox is a widget for the GTK+ library designed to display large amounts of numerical data quickly and easily. It allows for one or more data sets of thousands of data points (X and Y coordinates) to be displayed and updated in split seconds.

It offers the ability to zoom into and out of the data, and to navigate through your data by scrolling.

In addition to rulers and a simple coordinate cross, it allows you to add one (or even more) configurable grids like on an oscilloscope.

Data may be presented as dots, lines connecting the data, or vertical bars. The widget allows you to easily transform pixel coordinates into data coordinates, thus allowing you to easily create powerful applications for data analysis.

Details

GtkDataboxPrivate

typedef struct _GtkDataboxPrivate GtkDataboxPrivate;

A private data structure used by the GtkDatabox. It shields all internal things from developers who are just using the widget.


GtkDatabox

typedef struct _GtkDatabox GtkDatabox;

A GTK+ widget to display large amounts of numerical data quickly and easily. The numerical data is represented/displayed by GtkDataboxGraph objects, e.g. GtkDataboxPoints.

Implemented by _GtkDatabox;

Property Details

The "adjustment-x" property

  "adjustment-x"             GtkAdjustment*        : Read / Write / Construct

GtkAdjustment for horizontal scrolling.


The "adjustment-y" property

  "adjustment-y"             GtkAdjustment*        : Read / Write / Construct

GtkAdjustment for vertical scrolling.


The "enable-selection" property

  "enable-selection"         gboolean              : Read / Write / Construct

Defines whether the user can select rectangular areas with the mouse (TRUE) or not (FALSE).

Default value: TRUE


The "enable-zoom" property

  "enable-zoom"              gboolean              : Read / Write / Construct

Defines whether the user can use the mouse to zoom in or out (TRUE) or not (FALSE).

Default value: TRUE


The "ruler-x" property

  "ruler-x"                  GtkDataboxRuler*      : Read / Write / Construct

A horizontal GtkDataboxRuler or NULL.


The "ruler-y" property

  "ruler-y"                  GtkDataboxRuler*      : Read / Write / Construct

A vertical GtkDataboxRuler or NULL.


The "scale-type-x" property

  "scale-type-x"             GtkDataboxScaleType   : Read / Write / Construct

Horizontal scale type (linear or logarithmic).

Default value: GTK_DATABOX_SCALE_LINEAR


The "scale-type-y" property

  "scale-type-y"             GtkDataboxScaleType   : Read / Write / Construct

Vertical scale type (linear or logarithmic).

Default value: GTK_DATABOX_SCALE_LINEAR

Signal Details

The "selection-canceled" signal

void                user_function                      (GtkDatabox *box,
                                                        gpointer    user_data)      : Run First

This signal is emitted after a right click outside a selection rectangle.

box :

The GtkDatabox widget which zoomed in or out.

user_data :

user data set when the signal handler was connected.

The "selection-changed" signal

void                user_function                      (GtkDatabox *box,
                                                        gpointer    selection_values,
                                                        gpointer    user_data)             : Run First

This signal is emitted when the mouse is moved with the left button pressed (and the "enable-selection" property is set). The corners of the selection rectangle are stored in selection_values.

box :

The GtkDatabox widget in which the selection was changed.

selection_values :

The corners of the selection rectangle.

user_data :

user data set when the signal handler was connected.

The "selection-finalized" signal

void                user_function                      (GtkDatabox *box,
                                                        gpointer    selection_values,
                                                        gpointer    user_data)             : Run First

This signal is emitted when the left mouse button is released after a selection was started before.

see_also: "selection-changed"

box :

The GtkDatabox widget in which the selection has been stopped.

selection_values :

The corners of the selection rectangle.

user_data :

user data set when the signal handler was connected.

The "selection-started" signal

void                user_function                      (GtkDatabox *box,
                                                        gpointer    selection_values,
                                                        gpointer    user_data)             : Run First

This signal is emitted when the mouse is firstmoved with the left button pressed after the mouse-down (and the "enable-selection" property is set). The corners of the selection rectangle are stored in selection_values.

see_also: "selection-changed"

box :

The GtkDatabox widget in which the selection has been started.

selection_values :

The corners of the selection rectangle.

user_data :

user data set when the signal handler was connected.

The "zoomed" signal

void                user_function                      (GtkDatabox *box,
                                                        gpointer    user_data)      : Run First

This signal is emitted each time the zoom of the widget is changed, see for example gtk_databox_zoom_to_selection(), gtk_databox_set_visible_limits().

box :

The GtkDatabox widget which zoomed in or out.

user_data :

user data set when the signal handler was connected.

See Also

GtkDataboxGraph, GtkDataboxPoints, GtkDataboxLines, GtkDataboxMarkers, GtkDataboxGrid