gtkdialog.html

最新gtk中文资料集

<tr>
<td><p><span class="term"><em class="parameter"><code>setting</code></em>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> for sensitive
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3362520"></a><h3>
<a name="gtk-dialog-get-response-for-widget"></a>gtk_dialog_get_response_for_widget ()</h3>
<a class="indexterm" name="id3362537"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gtk_dialog_get_response_for_widget  (<a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
<p>
Gets the response id of a widget in the action area
of a dialog.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>dialog</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></p></td>
<td> a widget in the action area of <em class="parameter"><code>dialog</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the response id of <em class="parameter"><code>widget</code></em>, or <a class="link" href="GtkDialog.html#GTK-RESPONSE-NONE:CAPS"><code class="literal">GTK_RESPONSE_NONE</code></a>
 if <em class="parameter"><code>widget</code></em> doesn't have a response id set.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.8
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3362664"></a><h3>
<a name="gtk-alternative-dialog-button-order"></a>gtk_alternative_dialog_button_order ()</h3>
<a class="indexterm" name="id3362680"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_alternative_dialog_button_order (<a
href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"
>GdkScreen</a> *screen);</pre>
<p>
Returns <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if dialogs are expected to use an alternative
button order on the screen <em class="parameter"><code>screen</code></em>. See 
<a class="link" href="GtkDialog.html#gtk-dialog-set-alternative-button-order"><code class="function">gtk_dialog_set_alternative_button_order()</code></a> for more details
about alternative button order. 
</p>
<p>
If you need to use this function, you should probably connect
to the ::notify:gtk-alternative-button-order signal on the
<a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> object associated to <em class="parameter"><code>screen</code></em>, in order to be 
notified if the button order setting changes.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"
><span class="type">GdkScreen</span></a>, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> to use the default screen
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> Whether the alternative button order should be used

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3362816"></a><h3>
<a name="gtk-dialog-set-alternative-button-order"></a>gtk_dialog_set_alternative_button_order ()</h3>
<a class="indexterm" name="id3362832"></a><pre class="programlisting">void                gtk_dialog_set_alternative_button_order
                                                        (<a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> first_response_id,
                                                         ...);</pre>
<p>
Sets an alternative button order. If the 
<a class="link" href="GtkSettings.html#GtkSettings--gtk-alternative-button-order"><span class="type">"gtk-alternative-button-order"</span></a> setting is set to <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, 
the dialog buttons are reordered according to the order of the 
response ids passed to this function.
</p>
<p>
By default, GTK+ dialogs use the button order advocated by the Gnome 
<a class="ulink" href="http://developer.gnome.org/projects/gup/hig/2.0/" target="_top">Human 
Interface Guidelines</a> with the affirmative button at the far 
right, and the cancel button left of it. But the builtin GTK+ dialogs
and <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>s do provide an alternative button order,
which is more suitable on some platforms, e.g. Windows.
</p>
<p>
Use this function after adding all the buttons to your dialog, as the 
following example shows:
</p>
<div class="informalexample"><pre class="programlisting">
cancel_button = gtk_dialog_add_button (GTK_DIALOG (dialog),
                                       GTK_STOCK_CANCEL,
                                       GTK_RESPONSE_CANCEL);
 
ok_button = gtk_dialog_add_button (GTK_DIALOG (dialog),
                                   GTK_STOCK_OK,
                                   GTK_RESPONSE_OK);
  
gtk_widget_grab_default (ok_button);
  
help_button = gtk_dialog_add_button (GTK_DIALOG (dialog),
                                     GTK_STOCK_HELP,
                                     GTK_RESPONSE_HELP);
 
gtk_dialog_set_alternative_button_order (GTK_DIALOG (dialog),
                                         GTK_RESPONSE_OK,
                                         GTK_RESPONSE_CANCEL,
                                         GTK_RESPONSE_HELP,
                                         -1);
</pre></div>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>dialog</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>first_response_id</code></em>&#160;:</span></p></td>
<td> a response id used by one <em class="parameter"><code>dialog</code></em>'s buttons
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></p></td>
<td> a list of more response ids of <em class="parameter"><code>dialog</code></em>'s buttons, terminated by -1
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3363018"></a><h3>
<a name="gtk-dialog-set-alternative-button-order-from-array"></a>gtk_dialog_set_alternative_button_order_from_array ()</h3>
<a class="indexterm" name="id3363035"></a><pre class="programlisting">void                gtk_dialog_set_alternative_button_order_from_array
                                                        (<a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_params,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *new_order);</pre>
<p>
Sets an alternative button order. If the 
<a class="link" href="GtkSettings.html#GtkSettings--gtk-alternative-button-order"><span class="type">"gtk-alternative-button-order"</span></a> setting is set to <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, 
the dialog buttons are reordered according to the order of the 
response ids in <em class="parameter"><code>new_order</code></em>.
</p>
<p>
See <a class="link" href="GtkDialog.html#gtk-dialog-set-alternative-button-order"><code class="function">gtk_dialog_set_alternative_button_order()</code></a> for more information.
</p>
<p>
This function is for use by language bindings.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>dialog</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_params</code></em>&#160;:</span></p></td>
<td> the number of response ids in <em class="parameter"><code>new_order</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>new_order</code></em>&#160;:</span></p></td>
<td> an array of response ids of <em class="parameter"><code>dialog</code></em>'s buttons
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.6
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3363205"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3363216"></a><h3>
<a name="GtkDialog--has-separator"></a>The <code class="literal">"has-separator"</code> property</h3>
<a class="indexterm" name="id3363232"></a><pre class="programlisting">  "has-separator"            <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>The dialog has a separator bar above its buttons.</p>
<p>Default value: TRUE</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3363260"></a><h2>Style Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3363272"></a><h3>
<a name="GtkDialog--action-area-border"></a>The <code class="literal">"action-area-border"</code> style property</h3>
<a class="indexterm" name="id3363289"></a><pre class="programlisting">  "action-area-border"       <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>Width of border around the button area at the bottom of the dialog.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 5</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3363320"></a><h3>
<a name="GtkDialog--button-spacing"></a>The <code class="literal">"button-spacing"</code> style property</h3>
<a class="indexterm" name="id3363337"></a><pre class="programlisting