| Top |  |
 |
 |
 |
gimpuigimpui — Common user interface functions. This header includes all other GIMP User Interface Library headers. |
Functions
| 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 () |
Description
Common user interface functions. This header includes all other GIMP User Interface Library headers.
Functions
gimp_ui_init ()
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.
Parameters
prog_name |
The name of the plug-in which will be passed as argv[0] to
|
|
preview |
This parameter is unused and exists for historical reasons only. |
gimp_ui_get_display_window ()
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.
Returns
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
gimp_ui_get_progress_window ()
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.
Returns
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
gimp_window_set_transient ()
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
gimp_window_set_transient_for_display ()
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().
Parameters
window |
the GtkWindow that should become transient |
|
gdisp_ID |
display ID of the image window that should become the parent |
Since: 2.4