![]() |
![]() |
Gwyddion Application Library Reference Manual | ![]() |
|
---|---|---|---|---|
enum GwyMenuSensFlags; GtkWidget* gwy_app_build_process_menu (GtkAccelGroup *accel_group); void gwy_app_process_menu_add_run_last (GtkWidget *menu); GwyRunType gwy_app_run_process_func (const gchar *name); void gwy_app_run_process_func_in_mode (const gchar *name, GwyRunType run); GtkWidget* gwy_app_build_graph_menu (GtkAccelGroup *accel_group); void gwy_app_run_graph_func (const gchar *name); void gwy_app_menu_recent_files_update (GList *recent_files); GtkTooltips* gwy_app_get_tooltips (void); GwySensitivityGroup* gwy_app_sensitivity_get_group (void); void gwy_app_sensitivity_add_widget (GtkWidget *widget, GwyMenuSensFlags mask); void gwy_app_sensitivity_set_state (GwyMenuSensFlags affected_mask, GwyMenuSensFlags state);
Menu and toolbox item sensitivity is updated by main application whenever its state changes. Possible states that may affect widget sesitivity are defined in GwyMenuSensFlags.
typedef enum { GWY_MENU_FLAG_DATA = 1 << 0, GWY_MENU_FLAG_UNDO = 1 << 1, GWY_MENU_FLAG_REDO = 1 << 2, GWY_MENU_FLAG_GRAPH = 1 << 3, GWY_MENU_FLAG_LAST_PROC = 1 << 4, GWY_MENU_FLAG_LAST_GRAPH = 1 << 5, GWY_MENU_FLAG_DATA_MASK = 1 << 6, GWY_MENU_FLAG_DATA_SHOW = 1 << 7, GWY_MENU_FLAG_3D = 1 << 8, GWY_MENU_FLAG_MASK = 0xff } GwyMenuSensFlags;
Global application sensitivity flags.
They represent various application states that may be preconditions for widgets to become sensitive.
GtkWidget* gwy_app_build_process_menu (GtkAccelGroup *accel_group);
accel_group : |
|
Returns : |
void gwy_app_process_menu_add_run_last (GtkWidget *menu);
menu : |
GwyRunType gwy_app_run_process_func (const gchar *name);
Runs a data processing function on current data.
From the run modes function name
supports, the most interactive one is
selected.
name : |
A data processing function name. |
Returns : | The actually used mode (nonzero), or 0 on failure. |
void gwy_app_run_process_func_in_mode (const gchar *name, GwyRunType run);
Runs a data processing function on
current data in specified mode.
name : |
A data processing function name. |
run : |
A run mode. |
GtkWidget* gwy_app_build_graph_menu (GtkAccelGroup *accel_group);
accel_group : |
|
Returns : |
void gwy_app_menu_recent_files_update (GList *recent_files);
Updates recent file menu to show recent_files
.
recent_files : |
A list of recent file names, in UTF-8. |
GtkTooltips* gwy_app_get_tooltips (void);
Gets the application-wide tooltips instance.
Returns : | The global tooltips instance. No reference is added, you can add yours, but the returned object will exist to the end of program anyway. |
GwySensitivityGroup* gwy_app_sensitivity_get_group (void);
Gets the application-wide widget sensitvity group.
The flags to be used with this sensitvity group are defined in GwyMenuSensFlags.
Returns : | The global sensitvity group instead. No reference is added, you can add yours, but the returned object will exist to the end of program anyway. |
void gwy_app_sensitivity_add_widget (GtkWidget *widget, GwyMenuSensFlags mask);
Adds a widget to the application-wide widget sensitvity group.
The semantics of this function is the same as
gwy_sensitivity_group_add_widget()
(in fact, it's a simple wrapper around
it).
widget : |
Widget to add. |
mask : |
Which flags the widget is sensitive to. |
void gwy_app_sensitivity_set_state (GwyMenuSensFlags affected_mask, GwyMenuSensFlags state);
Sets the state of application-wide widget sensitvity group.
The semantics of this function is the same as
gwy_sensitivity_group_set_state()
(in fact, it's a simple wrapper around
it).
affected_mask : |
Which bits in state to copy to state.
|
state : |
The new state (masked with affected_mask ).
|