GwyDataWindow

GwyDataWindow — Data display window

Synopsis




enum        GwyZoomMode;
            GwyDataWindow;
            GwyDataWindowClass;
GtkWidget*  gwy_data_window_new             (GwyDataView *data_view);
GtkWidget*  gwy_data_window_get_data_view   (GwyDataWindow *data_window);
GwyContainer* gwy_data_window_get_data      (GwyDataWindow *data_window);
void        gwy_data_window_set_zoom        (GwyDataWindow *data_window,
                                             gint izoom);
void        gwy_data_window_set_zoom_mode   (GwyDataWindow *data_window,
                                             GwyZoomMode zoom_mode);
GwyZoomMode gwy_data_window_get_zoom_mode   (GwyDataWindow *data_window);
void        gwy_data_window_update_title    (GwyDataWindow *data_window);
gchar*      gwy_data_window_get_base_name   (GwyDataWindow *data_window);
GtkWidget*  gwy_data_window_get_ul_corner_widget
                                            (GwyDataWindow *data_window);
void        gwy_data_window_set_ul_corner_widget
                                            (GwyDataWindow *data_window,
                                             GtkWidget *corner);

Object Hierarchy


  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBin
                           +----GtkWindow
                                 +----GwyDataWindow

Implemented Interfaces

GwyDataWindow implements AtkImplementorIface.

Signal Prototypes


"title-changed"
            void        user_function      (GwyDataWindow *gwydatawindow,
                                            gpointer user_data);

Description

Details

enum GwyZoomMode

typedef enum {
    GWY_ZOOM_MODE_SQRT2,
    GWY_ZOOM_MODE_CBRT2,
    GWY_ZOOM_MODE_PIX4PIX,
    GWY_ZOOM_MODE_HALFPIX
} GwyZoomMode;


GwyDataWindow

typedef struct _GwyDataWindow GwyDataWindow;


GwyDataWindowClass

typedef struct {
    GtkWindowClass parent_class;

    void (*title_changed)(GwyDataWindow *data_window);

    gpointer reserved1;
    gpointer reserved2;
} GwyDataWindowClass;


gwy_data_window_new ()

GtkWidget*  gwy_data_window_new             (GwyDataView *data_view);

Creates a new data displaying window.

data_view : A GwyDataView containing the data-displaying widget to show.
Returns : A newly created widget, as GtkWidget.

gwy_data_window_get_data_view ()

GtkWidget*  gwy_data_window_get_data_view   (GwyDataWindow *data_window);

Returns the data view widget this data window currently shows.

data_window : A data view window.
Returns : The currently shown GwyDataView.

gwy_data_window_get_data ()

GwyContainer* gwy_data_window_get_data      (GwyDataWindow *data_window);

Returns the data for the data view this data window currently shows.

data_window : A data view window.
Returns : The data as GwyContainer.

gwy_data_window_set_zoom ()

void        gwy_data_window_set_zoom        (GwyDataWindow *data_window,
                                             gint izoom);

Sets the zoom of a data window to izoom.

When izoom is -1 it zooms out; when izoom is 1 it zooms out. Otherwise the new zoom value is set to izoom/10000.

data_window : A data window.
izoom : The new zoom value (as an integer).

gwy_data_window_set_zoom_mode ()

void        gwy_data_window_set_zoom_mode   (GwyDataWindow *data_window,
                                             GwyZoomMode zoom_mode);

Sets the zoom mode data_window should use to zoom_mode.

It does not affect the current zoom in any way, only its changes in the future.

data_window : A data window.
zoom_mode : A zoom mode to use.

gwy_data_window_get_zoom_mode ()

GwyZoomMode gwy_data_window_get_zoom_mode   (GwyDataWindow *data_window);

Returns the current zoom mode of a data window data_window.

data_window : A data window.
Returns : The current zoom mode.

gwy_data_window_update_title ()

void        gwy_data_window_update_title    (GwyDataWindow *data_window);

Updates the title of data_window to reflect current state.

FIXME: (a) the window title format should be configurable (b) this should probably happen automatically(?).

data_window : A data window.

gwy_data_window_get_base_name ()

gchar*      gwy_data_window_get_base_name   (GwyDataWindow *data_window);

Creates a string usable as a data_window window name/title.

This is the prefered data window representation in option menus, infoboxes, etc.

data_window : A data window.
Returns : The window name as a newly allocated string. It should be freed when no longer needed.

gwy_data_window_get_ul_corner_widget ()

GtkWidget*  gwy_data_window_get_ul_corner_widget
                                            (GwyDataWindow *data_window);

Returns the upper left corner widget of data_window.

data_window : A data window.
Returns : The upper left corner widget as a GtkWidget, NULL if there is no such widget.

Since 1.5.


gwy_data_window_set_ul_corner_widget ()

void        gwy_data_window_set_ul_corner_widget
                                            (GwyDataWindow *data_window,
                                             GtkWidget *corner);

Sets the widget in upper left corner of a data window to corner.

data_window : A data window.
corner : A widget to set as upper left corner widget, many be NULL to just remove any eventual existing one.

Since 1.5.

Signals

The "title-changed" signal

void        user_function                  (GwyDataWindow *gwydatawindow,
                                            gpointer user_data);

The ::title-changed signal is emitted when the title of GwyDataWindow changes.

gwydatawindow : The GwyDataWindow which received the signal.
user_data : User data set when the signal handler was connected.
user_data : user data set when the signal handler was connected.