gtkassistant.html

最新gtk中文资料集

<td><p><span class="term"><em class="parameter"><code>assistant</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkAssistant.html" title="GtkAssistant"><span class="type">GtkAssistant</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3430105"></a><h3>
<a name="gtk-assistant-remove-action-widget"></a>gtk_assistant_remove_action_widget ()</h3>
<a class="indexterm" name="id3430122"></a><pre class="programlisting">void                gtk_assistant_remove_action_widget  (<a class="link" href="GtkAssistant.html" title="GtkAssistant">GtkAssistant</a> *assistant,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);</pre>
<p>
Removes a widget from the action area of a <a class="link" href="GtkAssistant.html" title="GtkAssistant"><span class="type">GtkAssistant</span></a>.</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>assistant</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkAssistant.html" title="GtkAssistant"><span class="type">GtkAssistant</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3430225"></a><h3>
<a name="gtk-assistant-update-buttons-state"></a>gtk_assistant_update_buttons_state ()</h3>
<a class="indexterm" name="id3430241"></a><pre class="programlisting">void                gtk_assistant_update_buttons_state  (<a class="link" href="GtkAssistant.html" title="GtkAssistant">GtkAssistant</a> *assistant);</pre>
<p>
Forces <em class="parameter"><code>assistant</code></em> to recompute the buttons state.
</p>
<p>
GTK+ automatically takes care of this in most situations, 
e.g. when the user goes to a different page, or when the
visibility or completeness of a page changes.
</p>
<p>
One situation where it can be necessary to call this
function is when changing a value on the current page
affects the future page flow of the assistant.</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>assistant</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkAssistant.html" title="GtkAssistant"><span class="type">GtkAssistant</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3430326"></a><h2>Child Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3430337"></a><h3>
<a name="GtkAssistant--complete"></a>The <code class="literal">"complete"</code> child property</h3>
<a class="indexterm" name="id3430353"></a><pre class="programlisting">  "complete"                 <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>
Setting the "complete" child property to <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> marks a page as complete
(i.e.: all the required fields are filled out). GTK+ uses this information
to control the sensitivity of the navigation buttons.</p>
<p>

</p>
<p>Default value: FALSE</p>
<p>Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3430402"></a><h3>
<a name="GtkAssistant--header-image"></a>The <code class="literal">"header-image"</code> child property</h3>
<a class="indexterm" name="id3430418"></a><pre class="programlisting">  "header-image"             <a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a>             : Read / Write</pre>
<p>
The image that is displayed next to the page. 
</p>
<p>
Set this to <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> to make the sidebar disappear.</p>
<p>

</p>
<p>Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3430464"></a><h3>
<a name="GtkAssistant--page-type"></a>The <code class="literal">"page-type"</code> child property</h3>
<a class="indexterm" name="id3430480"></a><pre class="programlisting">  "page-type"                <a class="link" href="GtkAssistant.html#GtkAssistantPageType">GtkAssistantPageType</a>  : Read / Write</pre>
<p>
The type of the assistant page.</p>
<p>

</p>
<p>Default value: GTK_ASSISTANT_PAGE_CONTENT</p>
<p>Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3430517"></a><h3>
<a name="GtkAssistant--sidebar-image"></a>The <code class="literal">"sidebar-image"</code> child property</h3>
<a class="indexterm" name="id3430534"></a><pre class="programlisting">  "sidebar-image"            <a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a>             : Read / Write</pre>
<p>Sidebar image for the assistant page.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3430557"></a><h3>
<a name="GtkAssistant--title"></a>The <code class="literal">"title"</code> child property</h3>
<a class="indexterm" name="id3430572"></a><pre class="programlisting">  "title"                    <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write</pre>
<p>
The title that is displayed in the page header. 
</p>
<p>
If title and header-image are both <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, no header is displayed.</p>
<p>

</p>
<p>Default value: NULL</p>
<p>Since  2.10
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3430625"></a><h2>Style Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3430636"></a><h3>
<a name="GtkAssistant--content-padding"></a>The <code class="literal">"content-padding"</code> style property</h3>
<a class="indexterm" name="id3430653"></a><pre class="programlisting">  "content-padding"          <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>Number of pixels around the content pages.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 1</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3430684"></a><h3>
<a name="GtkAssistant--header-padding"></a>The <code class="literal">"header-padding"</code> style property</h3>
<a class="indexterm" name="id3430700"></a><pre class="programlisting">  "header-padding"           <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>Number of pixels around the header.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 6</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3430732"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id3430742"></a><h3>
<a name="GtkAssistant-apply"></a>The <code class="literal">"apply"</code> signal</h3>
<a class="indexterm" name="id3430758"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkAssistant.html" title="GtkAssistant">GtkAssistant</a> *assistant,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)      : Run Last</pre>
<p>
The ::apply signal is emitted when the apply button is clicked. The default
behavior of the <a class="link" href="GtkAssistant.html" title="GtkAssistant"><span class="type">GtkAssistant</span></a> is to switch to the page after the current page,
unless the current page is the last one.
</p>
<p>
A handler for the ::apply signal should carry out the actions for which the
wizard has collected data. If the action takes a long time to complete, you
might consider to put a page of type GTK_ASSISTANT_PAGE_PROGRESS after the
confirmation page and handle this operation within the ::prepare signal of
the progress page.</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>assistant</code></em>&#160;:</span></p></td>
<td> the <em class="parameter"><code>GtkAssistant</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3430860"></a><h3>
<a name="GtkAssistant-cancel"></a>The <code class="literal">"cancel"</code> signal</h3>
<a class="indexterm" name="id3430876"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkAssistant.html" title="GtkAssistant">GtkAssistant</a> *assistant,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)      : Run Last</pre>
<p>
The ::cancel signal is emitted when then the cancel button is clicked.</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>assistant</code></em>&#160;:</span></p></td>
<td> the <a class="link" href="GtkAssistant.html" title="GtkAssistant"><span class="type">GtkAssistant</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3430962"></a><h3>
<a name="GtkAssistant-close"></a>The <code class="literal">"close"</code> signal</h3>
<a class="indexterm" name="id3430978"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkAssistant.html" title="GtkAssistant">GtkAssistant</a> *assistant,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)      : Run Last</pre>
<p>
The ::close signal is emitted either when the close button of
a summary page is clicked, or when the apply button in the last
page in the flow (of type GTK_ASSISTANT_PAGE_CONFIRM) is clicked.</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>assistant</code></em>&#160;:</span></p></td>
<td> the <a class="link" href="GtkAssistant.html" title="GtkAssistant"><span class="ty