forked from AuroraMiddleware/gtk
f65e2a2a1e
2004-02-24 Federico Mena Quintero <federico@ximian.com> * gtk/tmpl/gtkexpander.sgml: Added a section about usage when you want to manage the expanded widgets yourself.
247 lines
3.9 KiB
Plaintext
247 lines
3.9 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkExpander
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
A container which can hide its child
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
A #GtkExpander allows the user to hide or show its child by clicking on an expander triangle similar to
|
|
the triangles used in a #GtkTreeView.
|
|
</para>
|
|
|
|
<para>
|
|
Normally you use an expander as you would use any other descendant
|
|
of #GtkBin; you create the child widget and use
|
|
gtk_container_add() to add it to the expander. When the expander
|
|
is toggled, it will take care of showing and hiding the child
|
|
automatically.
|
|
</para>
|
|
|
|
<section id="expander-special-usage">
|
|
<title>Special Usage</title>
|
|
|
|
<para>
|
|
There there are situations in which you may prefer to show and
|
|
hide the expanded widget yourself, such as when you want to
|
|
actually create the widget at expansion time. In this case,
|
|
create a #GtkExpander but do not add a child to it. The
|
|
expander widget has an <literal>expanded</literal> property
|
|
which can be used to monitor its expansion state. You should
|
|
watch this property with a signal connection as follows:
|
|
</para>
|
|
|
|
<programlisting id="expander-callback-example">
|
|
expander = gtk_expander_new_with_mnemonic ("_More Options");
|
|
g_signal_connect (expander, "notify::expanded",
|
|
G_CALLBACK (expander_callback), NULL);
|
|
|
|
...
|
|
|
|
static void
|
|
expander_callback (GObject *object,
|
|
GParamSpec *param_spec,
|
|
gpointer user_data)
|
|
{
|
|
GtkExpander *expander;
|
|
|
|
expander = GTK_EXPANDER (object);
|
|
|
|
if (gtk_expander_get_expanded (expander))
|
|
{
|
|
/* Show or create widgets */
|
|
}
|
|
else
|
|
{
|
|
/* Hide or destroy widgets */
|
|
}
|
|
}
|
|
|
|
</programlisting>
|
|
</section>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GtkExpander ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
|
<!-- ##### SIGNAL GtkExpander::activate ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@expander: the object which received the signal.
|
|
|
|
<!-- ##### ARG GtkExpander:expanded ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkExpander:label ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkExpander:label-widget ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkExpander:spacing ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkExpander:use-markup ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkExpander:use-underline ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkExpander:expander-size ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkExpander:expander-spacing ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### FUNCTION gtk_expander_new ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@label:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_expander_new_with_mnemonic ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@label:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_expander_set_expanded ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@expander:
|
|
@expanded:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_expander_get_expanded ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@expander:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_expander_set_spacing ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@expander:
|
|
@spacing:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_expander_get_spacing ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@expander:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_expander_set_label ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@expander:
|
|
@label:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_expander_get_label ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@expander:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_expander_set_use_underline ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@expander:
|
|
@use_underline:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_expander_get_use_underline ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@expander:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_expander_set_use_markup ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@expander:
|
|
@use_markup:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_expander_get_use_markup ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@expander:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_expander_set_label_widget ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@expander:
|
|
@label_widget:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_expander_get_label_widget ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@expander:
|
|
@Returns:
|
|
|
|
|