256 lines
14 KiB
XML
256 lines
14 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
|
|
|
|
<refentry id="GimpDialog">
|
|
<refmeta>
|
|
<refentrytitle>GimpDialog</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo>LIBGIMPWIDGETS Library</refmiscinfo>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>GimpDialog</refname><refpurpose>Constructors for <link linkend="GtkDialog"><type>GtkDialog</type></link>'s and action_areas as well as other
|
|
dialog-related stuff.</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv><title>Synopsis</title>
|
|
|
|
<synopsis>
|
|
|
|
|
|
|
|
<link linkend="GimpDialog-struct">GimpDialog</link>;
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-dialog-new">gimp_dialog_new</link> (const <link linkend="gchar">gchar</link> *title,
|
|
const <link linkend="gchar">gchar</link> *role,
|
|
<link linkend="GtkWidget">GtkWidget</link> *parent,
|
|
<link linkend="GtkDialogFlags">GtkDialogFlags</link> flags,
|
|
<link linkend="GimpHelpFunc">GimpHelpFunc</link> help_func,
|
|
const <link linkend="gchar">gchar</link> *help_id,
|
|
...);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-dialog-new-valist">gimp_dialog_new_valist</link> (const <link linkend="gchar">gchar</link> *title,
|
|
const <link linkend="gchar">gchar</link> *role,
|
|
<link linkend="GtkWidget">GtkWidget</link> *parent,
|
|
<link linkend="GtkDialogFlags">GtkDialogFlags</link> flags,
|
|
<link linkend="GimpHelpFunc">GimpHelpFunc</link> help_func,
|
|
const <link linkend="gchar">gchar</link> *help_id,
|
|
<link linkend="va-list">va_list</link> args);
|
|
<link linkend="void">void</link> <link linkend="gimp-dialog-add-buttons-valist">gimp_dialog_add_buttons_valist</link> (<link linkend="GimpDialog">GimpDialog</link> *dialog,
|
|
<link linkend="va-list">va_list</link> args);
|
|
<link linkend="gint">gint</link> <link linkend="gimp-dialog-run">gimp_dialog_run</link> (<link linkend="GimpDialog">GimpDialog</link> *dialog);
|
|
<link linkend="void">void</link> <link linkend="gimp-dialogs-show-help-button">gimp_dialogs_show_help_button</link> (<link linkend="gboolean">gboolean</link> show);
|
|
|
|
</synopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>Object Hierarchy</title>
|
|
<synopsis>
|
|
|
|
<link linkend="GObject">GObject</link>
|
|
+----<link linkend="GtkObject">GtkObject</link>
|
|
+----<link linkend="GtkWidget">GtkWidget</link>
|
|
+----<link linkend="GtkContainer">GtkContainer</link>
|
|
+----<link linkend="GtkBin">GtkBin</link>
|
|
+----<link linkend="GtkWindow">GtkWindow</link>
|
|
+----<link linkend="GtkDialog">GtkDialog</link>
|
|
+----GimpDialog
|
|
</synopsis>
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1>
|
|
<title>Implemented Interfaces</title>
|
|
<para>
|
|
GimpDialog implements
|
|
<link linkend="AtkImplementorIface">AtkImplementorIface</link>.</para>
|
|
|
|
</refsect1>
|
|
|
|
|
|
<refsect1>
|
|
<title>Properties</title>
|
|
<synopsis>
|
|
|
|
"<link linkend="GimpDialog--help-func">help-func</link>" <link linkend="gpointer">gpointer</link> : Read / Write / Construct Only
|
|
"<link linkend="GimpDialog--help-id">help-id</link>" <link linkend="gchararray">gchararray</link> : Read / Write / Construct Only
|
|
</synopsis>
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<para>
|
|
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Details</title>
|
|
<refsect2>
|
|
<title><anchor id="GimpDialog-struct"/>GimpDialog</title>
|
|
<indexterm><primary>GimpDialog</primary></indexterm><programlisting>typedef struct _GimpDialog GimpDialog;</programlisting>
|
|
<para>
|
|
|
|
</para></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-dialog-new"/>gimp_dialog_new ()</title>
|
|
<indexterm><primary>gimp_dialog_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_dialog_new (const <link linkend="gchar">gchar</link> *title,
|
|
const <link linkend="gchar">gchar</link> *role,
|
|
<link linkend="GtkWidget">GtkWidget</link> *parent,
|
|
<link linkend="GtkDialogFlags">GtkDialogFlags</link> flags,
|
|
<link linkend="GimpHelpFunc">GimpHelpFunc</link> help_func,
|
|
const <link linkend="gchar">gchar</link> *help_id,
|
|
...);</programlisting>
|
|
<para>
|
|
Creates a new <parameter>GimpDialog</parameter> widget.
|
|
</para>
|
|
<para>
|
|
This function simply packs the action_area arguments passed in "..."
|
|
into a <parameter>va_list</parameter> variable and passes everything to <link linkend="gimp-dialog-new-valist"><function>gimp_dialog_new_valist()</function></link>.
|
|
</para>
|
|
<para>
|
|
For a description of the format of the <parameter>va_list</parameter> describing the
|
|
action_area buttons see <link linkend="gtk-dialog-new-with-buttons"><function>gtk_dialog_new_with_buttons()</function></link>.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>title</parameter> :</term>
|
|
<listitem><simpara> The dialog's title which will be set with
|
|
<link linkend="gtk-window-set-title"><function>gtk_window_set_title()</function></link>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>role</parameter> :</term>
|
|
<listitem><simpara> The dialog's <parameter>role</parameter> which will be set with
|
|
<link linkend="gtk-window-set-role"><function>gtk_window_set_role()</function></link>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>parent</parameter> :</term>
|
|
<listitem><simpara> The <parameter>parent</parameter> widget of this dialog.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>flags</parameter> :</term>
|
|
<listitem><simpara> The <parameter>flags</parameter> (see the <link linkend="GtkDialog"><type>GtkDialog</type></link> documentation).
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>help_func</parameter> :</term>
|
|
<listitem><simpara> The function which will be called if the user presses "F1".
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>help_id</parameter> :</term>
|
|
<listitem><simpara> The help_id which will be passed to <parameter>help_func</parameter>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>...</parameter> :</term>
|
|
<listitem><simpara> A <literal>NULL</literal>-terminated <parameter>va_list</parameter> destribing the
|
|
action_area buttons.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A <link linkend="GimpDialog"><type>GimpDialog</type></link>.
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-dialog-new-valist"/>gimp_dialog_new_valist ()</title>
|
|
<indexterm><primary>gimp_dialog_new_valist</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_dialog_new_valist (const <link linkend="gchar">gchar</link> *title,
|
|
const <link linkend="gchar">gchar</link> *role,
|
|
<link linkend="GtkWidget">GtkWidget</link> *parent,
|
|
<link linkend="GtkDialogFlags">GtkDialogFlags</link> flags,
|
|
<link linkend="GimpHelpFunc">GimpHelpFunc</link> help_func,
|
|
const <link linkend="gchar">gchar</link> *help_id,
|
|
<link linkend="va-list">va_list</link> args);</programlisting>
|
|
<para>
|
|
Creates a new <parameter>GimpDialog</parameter> widget. If a GtkWindow is specified as
|
|
<parameter>parent</parameter> then the dialog will be made transient for this window.
|
|
</para>
|
|
<para>
|
|
For a description of the format of the <parameter>va_list</parameter> describing the
|
|
action_area buttons see <link linkend="gtk-dialog-new-with-buttons"><function>gtk_dialog_new_with_buttons()</function></link>.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>title</parameter> :</term>
|
|
<listitem><simpara> The dialog's title which will be set with
|
|
<link linkend="gtk-window-set-title"><function>gtk_window_set_title()</function></link>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>role</parameter> :</term>
|
|
<listitem><simpara> The dialog's <parameter>role</parameter> which will be set with
|
|
<link linkend="gtk-window-set-role"><function>gtk_window_set_role()</function></link>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>parent</parameter> :</term>
|
|
<listitem><simpara> The <parameter>parent</parameter> widget of this dialog or <literal>NULL</literal>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>flags</parameter> :</term>
|
|
<listitem><simpara> The <parameter>flags</parameter> (see the <link linkend="GtkDialog"><type>GtkDialog</type></link> documentation).
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>help_func</parameter> :</term>
|
|
<listitem><simpara> The function which will be called if the user presses "F1".
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>help_id</parameter> :</term>
|
|
<listitem><simpara> The help_id which will be passed to <parameter>help_func</parameter>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>args</parameter> :</term>
|
|
<listitem><simpara> A <parameter>va_list</parameter> destribing the action_area buttons.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A <link linkend="GimpDialog"><type>GimpDialog</type></link>.
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-dialog-add-buttons-valist"/>gimp_dialog_add_buttons_valist ()</title>
|
|
<indexterm><primary>gimp_dialog_add_buttons_valist</primary></indexterm><programlisting><link linkend="void">void</link> gimp_dialog_add_buttons_valist (<link linkend="GimpDialog">GimpDialog</link> *dialog,
|
|
<link linkend="va-list">va_list</link> args);</programlisting>
|
|
<para>
|
|
This function is essentially the same as <link linkend="gtk-dialog-add-buttons"><function>gtk_dialog_add_buttons()</function></link>
|
|
except it takes a va_list instead of '...'</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>dialog</parameter> :</term>
|
|
<listitem><simpara> The <parameter>dialog</parameter> to add buttons to.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>args</parameter> :</term>
|
|
<listitem><simpara> The buttons as va_list.
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-dialog-run"/>gimp_dialog_run ()</title>
|
|
<indexterm><primary>gimp_dialog_run</primary></indexterm><programlisting><link linkend="gint">gint</link> gimp_dialog_run (<link linkend="GimpDialog">GimpDialog</link> *dialog);</programlisting>
|
|
<para>
|
|
This function does exactly the same as <link linkend="gtk-dialog-run"><function>gtk_dialog_run()</function></link> except it
|
|
does not make the dialog modal while the <link linkend="GMainLoop"><type>GMainLoop</type></link> is running.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>dialog</parameter> :</term>
|
|
<listitem><simpara> a <link linkend="GimpDialog"><type>GimpDialog</type></link>
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> response ID
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-dialogs-show-help-button"/>gimp_dialogs_show_help_button ()</title>
|
|
<indexterm role="GIMP 2.2"><primary>gimp_dialogs_show_help_button</primary></indexterm><programlisting><link linkend="void">void</link> gimp_dialogs_show_help_button (<link linkend="gboolean">gboolean</link> show);</programlisting>
|
|
<para>
|
|
This function is for internal use only.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>show</parameter> :</term>
|
|
<listitem><simpara> whether a help button should be added when creating a GimpDialog
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist><para>Since GIMP 2.2
|
|
</para></refsect2>
|
|
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>Properties</title>
|
|
<refsect2><title><anchor id="GimpDialog--help-func"/>The "<literal>help-func</literal>" property</title>
|
|
<programlisting> "help-func" <link linkend="gpointer">gpointer</link> : Read / Write / Construct Only</programlisting>
|
|
<para></para></refsect2>
|
|
<refsect2><title><anchor id="GimpDialog--help-id"/>The "<literal>help-id</literal>" property</title>
|
|
<programlisting> "help-id" <link linkend="gchararray">gchararray</link> : Read / Write / Construct Only</programlisting>
|
|
<para></para><para>Default value: NULL</para>
|
|
</refsect2>
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
|
|
</refentry>
|