GtkDatabox

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

Properties

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

Signals

void selection-canceled Run First
void selection-changed Run First
void selection-finalized Run First
void selection-started Run First
void zoomed Run First

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkDatabox

Implemented Interfaces

GtkDatabox implements AtkImplementorIface and GtkBuildable.

Includes

#include <gtkdatabox.h>

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.

Functions

Types and Values

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;

Members

Property Details

The “adjustment-x” property

  “adjustment-x”             GtkAdjustment *

GtkAdjustment for horizontal scrolling.

Flags: Read / Write / Construct


The “adjustment-y” property

  “adjustment-y”             GtkAdjustment *

GtkAdjustment for vertical scrolling.

Flags: Read / Write / Construct


The “enable-selection” property

  “enable-selection”         gboolean

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

Flags: Read / Write / Construct

Default value: TRUE


The “enable-zoom” property

  “enable-zoom”              gboolean

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

Flags: Read / Write / Construct

Default value: TRUE


The “ruler-x” property

  “ruler-x”                  GtkDataboxRuler *

A horizontal GtkDataboxRuler or NULL.

Flags: Read / Write / Construct


The “ruler-y” property

  “ruler-y”                  GtkDataboxRuler *

A vertical GtkDataboxRuler or NULL.

Flags: Read / Write / Construct


The “scale-type-x” property

  “scale-type-x”             GtkDataboxScaleType

Horizontal scale type (linear or logarithmic).

Flags: Read / Write / Construct

Default value: GTK_DATABOX_SCALE_LINEAR


The “scale-type-y” property

  “scale-type-y”             GtkDataboxScaleType

Vertical scale type (linear or logarithmic).

Flags: Read / Write / Construct

Default value: GTK_DATABOX_SCALE_LINEAR

Signal Details

The “selection-canceled” signal

void
user_function (GtkDatabox *box,
               gpointer    user_data)

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

Parameters

box

The GtkDatabox widget which zoomed in or out.

 

user_data

user data set when the signal handler was connected.

 

Flags: Run First


The “selection-changed” signal

void
user_function (GtkDatabox *box,
               gpointer    selection_values,
               gpointer    user_data)

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 .

Parameters

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.

 

Flags: Run First


The “selection-finalized” signal

void
user_function (GtkDatabox *box,
               gpointer    selection_values,
               gpointer    user_data)

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

see_also : “selection-changed”

Parameters

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.

 

Flags: Run First


The “selection-started” signal

void
user_function (GtkDatabox *box,
               gpointer    selection_values,
               gpointer    user_data)

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”

Parameters

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.

 

Flags: Run First


The “zoomed” signal

void
user_function (GtkDatabox *box,
               gpointer    user_data)

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().

Parameters

box

The GtkDatabox widget which zoomed in or out.

 

user_data

user data set when the signal handler was connected.

 

Flags: Run First

See Also

GtkDataboxGraph, GtkDataboxPoints, GtkDataboxLines, GtkDataboxMarkers, GtkDataboxGrid