Top |
gimpuigimpui — Common user interface functions. This header includes all other GIMP User Interface Library headers. |
void | gimp_ui_init () |
GdkWindow * | gimp_ui_get_display_window () |
GdkWindow * | gimp_ui_get_progress_window () |
void | gimp_window_set_transient () |
void | gimp_window_set_transient_for_display () |
Common user interface functions. This header includes all other GIMP User Interface Library headers.
void gimp_ui_init (const gchar *prog_name
,gboolean preview
);
This function initializes GTK+ with gtk_init()
and initializes GDK's
image rendering subsystem (GdkRGB) to follow the GIMP main program's
colormap allocation/installation policy.
It also sets up various other things so that the plug-in user looks and behaves like the GIMP core. This includes selecting the GTK+ theme and setting up the help system as chosen in the GIMP preferences. Any plug-in that provides a user interface should call this function.
GdkWindow *
gimp_ui_get_display_window (guint32 gdisp_ID
);
Returns the GdkWindow of a display window. The purpose is to allow
to make plug-in dialogs transient to the image display as explained
with gdk_window_set_transient_for()
.
You shouldn't have to call this function directly. Use
gimp_window_set_transient_for_display()
instead.
A reference to a GdkWindow or NULL
. You should
unref the window using g_object_unref()
as soon as
you don't need it any longer.
Since: 2.4
GdkWindow *
gimp_ui_get_progress_window (void
);
Returns the GdkWindow of the window this plug-in's progress bar is
shown in. Use it to make plug-in dialogs transient to this window
as explained with gdk_window_set_transient_for()
.
You shouldn't have to call this function directly. Use
gimp_window_set_transient()
instead.
A reference to a GdkWindow or NULL
. You should
unref the window using g_object_unref()
as soon as
you don't need it any longer.
Since: 2.4
void
gimp_window_set_transient (GtkWindow *window
);
Indicates to the window manager that window
is a transient dialog
associated with the GIMP window that the plug-in has been
started from. See also gimp_window_set_transient_for_display()
.
Since: 2.4
void gimp_window_set_transient_for_display (GtkWindow *window
,guint32 gdisp_ID
);
Indicates to the window manager that window
is a transient dialog
associated with the GIMP image window that is identified by it's
display ID. See gdk_window_set_transient_for()
for more information.
Most of the time you will want to use the convenience function
gimp_window_set_transient()
.
window |
the GtkWindow that should become transient |
|
gdisp_ID |
display ID of the image window that should become the parent |
Since: 2.4