<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
<!ENTITY pi "&#960;">
<!ENTITY solidus "&#8260;">
]>
<refentry id="GtkLevelBar">
<refmeta>
<refentrytitle role="top_of_page" id="GtkLevelBar.top_of_page">GtkLevelBar</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkLevelBar</refname>
<refpurpose>A bar that can used as a level indicator</refpurpose>
</refnamediv>

<refsect1 id="GtkLevelBar.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-level-bar-new">gtk_level_bar_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-level-bar-new-for-interval">gtk_level_bar_new_for_interval</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-level-bar-set-mode">gtk_level_bar_set_mode</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkLevelBarMode"><returnvalue>GtkLevelBarMode</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-level-bar-get-mode">gtk_level_bar_get_mode</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-level-bar-set-value">gtk_level_bar_set_value</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-level-bar-get-value">gtk_level_bar_get_value</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-level-bar-set-min-value">gtk_level_bar_set_min_value</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-level-bar-get-min-value">gtk_level_bar_get_min_value</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-level-bar-set-max-value">gtk_level_bar_set_max_value</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-level-bar-get-max-value">gtk_level_bar_get_max_value</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-level-bar-set-inverted">gtk_level_bar_set_inverted</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-level-bar-get-inverted">gtk_level_bar_get_inverted</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-level-bar-add-offset-value">gtk_level_bar_add_offset_value</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-level-bar-remove-offset-value">gtk_level_bar_remove_offset_value</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-level-bar-get-offset-value">gtk_level_bar_get_offset_value</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkLevelBar.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkLevelBar--inverted">inverted</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gdouble"><type>gdouble</type></link></entry><entry role="property_name"><link linkend="GtkLevelBar--max-value">max-value</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gdouble"><type>gdouble</type></link></entry><entry role="property_name"><link linkend="GtkLevelBar--min-value">min-value</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkLevelBarMode"><type>GtkLevelBarMode</type></link></entry><entry role="property_name"><link linkend="GtkLevelBar--mode">mode</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gdouble"><type>gdouble</type></link></entry><entry role="property_name"><link linkend="GtkLevelBar--value">value</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkLevelBar.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signal_proto_type" colwidth="150px"/>
<colspec colname="signal_proto_name" colwidth="300px"/>
<colspec colname="signal_proto_flags" colwidth="200px"/>
<tbody>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkLevelBar-offset-changed">offset-changed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-DETAILED:CAPS">Has Details</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkLevelBar.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="GTK-LEVEL-BAR-OFFSET-LOW:CAPS">GTK_LEVEL_BAR_OFFSET_LOW</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="GTK-LEVEL-BAR-OFFSET-HIGH:CAPS">GTK_LEVEL_BAR_OFFSET_HIGH</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="GTK-LEVEL-BAR-OFFSET-FULL:CAPS">GTK_LEVEL_BAR_OFFSET_FULL</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GtkLevelBarMode">GtkLevelBarMode</link></entry></row>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="GtkLevelBar-struct">GtkLevelBar</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkLevelBar.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
        <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkWidget">GtkWidget</link>
            <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkLevelBar
</screen>
</refsect1>
<refsect1 id="GtkLevelBar.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkLevelBar implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link>,  <link linkend="GtkConstraintTarget">GtkConstraintTarget</link> and  <link linkend="GtkOrientable">GtkOrientable</link>.</para>

</refsect1>

<refsect1 id="GtkLevelBar.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtk.h&gt;
</synopsis></refsect1>

<refsect1 id="GtkLevelBar.description" role="desc">
<title role="desc.title">Description</title>
<para>The <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> is a bar widget that can be used
as a level indicator. Typical use cases are displaying the strength
of a password, or showing the charge level of a battery.</para>
<para>Use <link linkend="gtk-level-bar-set-value"><function>gtk_level_bar_set_value()</function></link> to set the current value, and
<link linkend="gtk-level-bar-add-offset-value"><function>gtk_level_bar_add_offset_value()</function></link> to set the value offsets at which
the bar will be considered in a different state. GTK will add a few
offsets by default on the level bar: <link linkend="GTK-LEVEL-BAR-OFFSET-LOW:CAPS"><type>GTK_LEVEL_BAR_OFFSET_LOW</type></link>,
<link linkend="GTK-LEVEL-BAR-OFFSET-HIGH:CAPS"><type>GTK_LEVEL_BAR_OFFSET_HIGH</type></link> and <link linkend="GTK-LEVEL-BAR-OFFSET-FULL:CAPS"><type>GTK_LEVEL_BAR_OFFSET_FULL</type></link>, with
values 0.25, 0.75 and 1.0 respectively.</para>
<para>Note that it is your responsibility to update preexisting offsets
when changing the minimum or maximum value. GTK+ will simply clamp
them to the new range.</para>
<refsect3><title>Adding a custom offset on the bar</title><informalexample><programlisting role="example"><![CDATA[

static GtkWidget *
create_level_bar (void)
{
  GtkWidget *widget;
  GtkLevelBar *bar;

  widget = gtk_level_bar_new ();
  bar = GTK_LEVEL_BAR (widget);

  // This changes the value of the default low offset

  gtk_level_bar_add_offset_value (bar,
                                  GTK_LEVEL_BAR_OFFSET_LOW,
                                  0.10);

  // This adds a new offset to the bar; the application will
  // be able to change its color CSS like this:
  //
  // levelbar block.my-offset {
  //   background-color: magenta;
  //   border-style: solid;
  //   border-color: black;
  //   border-style: 1px;
  // }

  gtk_level_bar_add_offset_value (bar, "my-offset", 0.60);

  return widget;
}
]]></programlisting></informalexample>
<para></para>
<para>The default interval of values is between zero and one, but it’s possible to
modify the interval using <link linkend="gtk-level-bar-set-min-value"><function>gtk_level_bar_set_min_value()</function></link> and
<link linkend="gtk-level-bar-set-max-value"><function>gtk_level_bar_set_max_value()</function></link>. The value will be always drawn in proportion to
the admissible interval, i.e. a value of 15 with a specified interval between
10 and 20 is equivalent to a value of 0.5 with an interval between 0 and 1.
When <link linkend="GTK-LEVEL-BAR-MODE-DISCRETE:CAPS"><type>GTK_LEVEL_BAR_MODE_DISCRETE</type></link> is used, the bar level is rendered
as a finite number of separated blocks instead of a single one. The number
of blocks that will be rendered is equal to the number of units specified by
the admissible interval.</para>
<para>For instance, to build a bar rendered with five blocks, it’s sufficient to
set the minimum value to 0 and the maximum value to 5 after changing the indicator
mode to discrete.</para>
<para>GtkLevelBar was introduced in GTK+ 3.6.</para>
</refsect3>
<refsect2><title>GtkLevelBar as GtkBuildable</title><para>The GtkLevelBar implementation of the GtkBuildable interface supports a
custom &lt;offsets> element, which can contain any number of &lt;offset> elements,
each of which must have name and value attributes.</para>
</refsect2>
<refsect2><title>CSS nodes</title><informalexample><programlisting role="example"><![CDATA[
levelbar[.discrete]
╰── trough
    ├── block.filled.level-name
    ┊
    ├── block.empty
    ┊
]]></programlisting></informalexample>
<para></para>
<para>GtkLevelBar has a main CSS node with name levelbar and one of the style
classes .discrete or .continuous and a subnode with name trough. Below the
trough node are a number of nodes with name block and style class .filled
or .empty. In continuous mode, there is exactly one node of each, in discrete
mode, the number of filled and unfilled nodes corresponds to blocks that are
drawn. The block.filled nodes also get a style class .level-name corresponding
to the level for the current value.</para>
<para>In horizontal orientation, the nodes are always arranged from left to right,
regardless of text direction.</para>
</refsect2>

</refsect1>
<refsect1 id="GtkLevelBar.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-level-bar-new" role="function">
<title>gtk_level_bar_new&#160;()</title>
<indexterm zone="gtk-level-bar-new"><primary>gtk_level_bar_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_level_bar_new (<parameter><type>void</type></parameter>);</programlisting>
<para>Creates a new <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link>.</para>
<refsect3 id="gtk-level-bar-new.returns" role="returns">
<title>Returns</title>
<para> a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link>.</para>
</refsect3></refsect2>
<refsect2 id="gtk-level-bar-new-for-interval" role="function">
<title>gtk_level_bar_new_for_interval&#160;()</title>
<indexterm zone="gtk-level-bar-new-for-interval"><primary>gtk_level_bar_new_for_interval</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_level_bar_new_for_interval (<parameter><link linkend="gdouble"><type>gdouble</type></link> min_value</parameter>,
                                <parameter><link linkend="gdouble"><type>gdouble</type></link> max_value</parameter>);</programlisting>
<para>Utility constructor that creates a new <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> for the specified
interval.</para>
<refsect3 id="gtk-level-bar-new-for-interval.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>min_value</para></entry>
<entry role="parameter_description"><para>a positive value</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>max_value</para></entry>
<entry role="parameter_description"><para>a positive value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-level-bar-new-for-interval.returns" role="returns">
<title>Returns</title>
<para> a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-level-bar-set-mode" role="function">
<title>gtk_level_bar_set_mode&#160;()</title>
<indexterm zone="gtk-level-bar-set-mode"><primary>gtk_level_bar_set_mode</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_level_bar_set_mode (<parameter><link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> *self</parameter>,
                        <parameter><link linkend="GtkLevelBarMode"><type>GtkLevelBarMode</type></link> mode</parameter>);</programlisting>
<para>Sets the value of the <link linkend="GtkLevelBar--mode"><type>“mode”</type></link> property.</para>
<refsect3 id="gtk-level-bar-set-mode.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>mode</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBarMode"><type>GtkLevelBarMode</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-level-bar-get-mode" role="function">
<title>gtk_level_bar_get_mode&#160;()</title>
<indexterm zone="gtk-level-bar-get-mode"><primary>gtk_level_bar_get_mode</primary></indexterm>
<programlisting language="C"><link linkend="GtkLevelBarMode"><returnvalue>GtkLevelBarMode</returnvalue></link>
gtk_level_bar_get_mode (<parameter><link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> *self</parameter>);</programlisting>
<para>Returns the value of the <link linkend="GtkLevelBar--mode"><type>“mode”</type></link> property.</para>
<refsect3 id="gtk-level-bar-get-mode.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-level-bar-get-mode.returns" role="returns">
<title>Returns</title>
<para> a <link linkend="GtkLevelBarMode"><type>GtkLevelBarMode</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-level-bar-set-value" role="function">
<title>gtk_level_bar_set_value&#160;()</title>
<indexterm zone="gtk-level-bar-set-value"><primary>gtk_level_bar_set_value</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_level_bar_set_value (<parameter><link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> *self</parameter>,
                         <parameter><link linkend="gdouble"><type>gdouble</type></link> value</parameter>);</programlisting>
<para>Sets the value of the <link linkend="GtkLevelBar--value"><type>“value”</type></link> property.</para>
<refsect3 id="gtk-level-bar-set-value.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a value in the interval between
<link linkend="GtkLevelBar--min-value"><type>“min-value”</type></link> and <link linkend="GtkLevelBar--max-value"><type>“max-value”</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-level-bar-get-value" role="function">
<title>gtk_level_bar_get_value&#160;()</title>
<indexterm zone="gtk-level-bar-get-value"><primary>gtk_level_bar_get_value</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_level_bar_get_value (<parameter><link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> *self</parameter>);</programlisting>
<para>Returns the value of the <link linkend="GtkLevelBar--value"><type>“value”</type></link> property.</para>
<refsect3 id="gtk-level-bar-get-value.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-level-bar-get-value.returns" role="returns">
<title>Returns</title>
<para> a value in the interval between
<link linkend="GtkLevelBar--min-value"><type>“min-value”</type></link> and <link linkend="GtkLevelBar--max-value"><type>“max-value”</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-level-bar-set-min-value" role="function">
<title>gtk_level_bar_set_min_value&#160;()</title>
<indexterm zone="gtk-level-bar-set-min-value"><primary>gtk_level_bar_set_min_value</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_level_bar_set_min_value (<parameter><link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> *self</parameter>,
                             <parameter><link linkend="gdouble"><type>gdouble</type></link> value</parameter>);</programlisting>
<para>Sets the value of the <link linkend="GtkLevelBar--min-value"><type>“min-value”</type></link> property.</para>
<para>You probably want to update preexisting level offsets after calling
this function.</para>
<refsect3 id="gtk-level-bar-set-min-value.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a positive value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-level-bar-get-min-value" role="function">
<title>gtk_level_bar_get_min_value&#160;()</title>
<indexterm zone="gtk-level-bar-get-min-value"><primary>gtk_level_bar_get_min_value</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_level_bar_get_min_value (<parameter><link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> *self</parameter>);</programlisting>
<para>Returns the value of the <link linkend="GtkLevelBar--min-value"><type>“min-value”</type></link> property.</para>
<refsect3 id="gtk-level-bar-get-min-value.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-level-bar-get-min-value.returns" role="returns">
<title>Returns</title>
<para> a positive value</para>
</refsect3></refsect2>
<refsect2 id="gtk-level-bar-set-max-value" role="function">
<title>gtk_level_bar_set_max_value&#160;()</title>
<indexterm zone="gtk-level-bar-set-max-value"><primary>gtk_level_bar_set_max_value</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_level_bar_set_max_value (<parameter><link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> *self</parameter>,
                             <parameter><link linkend="gdouble"><type>gdouble</type></link> value</parameter>);</programlisting>
<para>Sets the value of the <link linkend="GtkLevelBar--max-value"><type>“max-value”</type></link> property.</para>
<para>You probably want to update preexisting level offsets after calling
this function.</para>
<refsect3 id="gtk-level-bar-set-max-value.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a positive value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-level-bar-get-max-value" role="function">
<title>gtk_level_bar_get_max_value&#160;()</title>
<indexterm zone="gtk-level-bar-get-max-value"><primary>gtk_level_bar_get_max_value</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_level_bar_get_max_value (<parameter><link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> *self</parameter>);</programlisting>
<para>Returns the value of the <link linkend="GtkLevelBar--max-value"><type>“max-value”</type></link> property.</para>
<refsect3 id="gtk-level-bar-get-max-value.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-level-bar-get-max-value.returns" role="returns">
<title>Returns</title>
<para> a positive value</para>
</refsect3></refsect2>
<refsect2 id="gtk-level-bar-set-inverted" role="function">
<title>gtk_level_bar_set_inverted&#160;()</title>
<indexterm zone="gtk-level-bar-set-inverted"><primary>gtk_level_bar_set_inverted</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_level_bar_set_inverted (<parameter><link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> *self</parameter>,
                            <parameter><link linkend="gboolean"><type>gboolean</type></link> inverted</parameter>);</programlisting>
<para>Sets the value of the <link linkend="GtkLevelBar--inverted"><type>“inverted”</type></link> property.</para>
<refsect3 id="gtk-level-bar-set-inverted.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>inverted</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> to invert the level bar</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-level-bar-get-inverted" role="function">
<title>gtk_level_bar_get_inverted&#160;()</title>
<indexterm zone="gtk-level-bar-get-inverted"><primary>gtk_level_bar_get_inverted</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_level_bar_get_inverted (<parameter><link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> *self</parameter>);</programlisting>
<para>Return the value of the <link linkend="GtkLevelBar--inverted"><type>“inverted”</type></link> property.</para>
<refsect3 id="gtk-level-bar-get-inverted.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-level-bar-get-inverted.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the level bar is inverted</para>
</refsect3></refsect2>
<refsect2 id="gtk-level-bar-add-offset-value" role="function">
<title>gtk_level_bar_add_offset_value&#160;()</title>
<indexterm zone="gtk-level-bar-add-offset-value"><primary>gtk_level_bar_add_offset_value</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_level_bar_add_offset_value (<parameter><link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> *self</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                                <parameter><link linkend="gdouble"><type>gdouble</type></link> value</parameter>);</programlisting>
<para>Adds a new offset marker on <parameter>self</parameter>
 at the position specified by <parameter>value</parameter>
.
When the bar value is in the interval topped by <parameter>value</parameter>
 (or between <parameter>value</parameter>

and <link linkend="GtkLevelBar--max-value"><type>“max-value”</type></link> in case the offset is the last one on the bar)
a style class named <literal>level-</literal><parameter>name</parameter>
 will be applied
when rendering the level bar fill.
If another offset marker named <parameter>name</parameter>
 exists, its value will be
replaced by <parameter>value</parameter>
.</para>
<refsect3 id="gtk-level-bar-add-offset-value.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>the name of the new offset</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>the value for the new offset</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-level-bar-remove-offset-value" role="function">
<title>gtk_level_bar_remove_offset_value&#160;()</title>
<indexterm zone="gtk-level-bar-remove-offset-value"><primary>gtk_level_bar_remove_offset_value</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_level_bar_remove_offset_value (<parameter><link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> *self</parameter>,
                                   <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>);</programlisting>
<para>Removes an offset marker previously added with
<link linkend="gtk-level-bar-add-offset-value"><function>gtk_level_bar_add_offset_value()</function></link>.</para>
<refsect3 id="gtk-level-bar-remove-offset-value.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>the name of an offset in the bar. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-level-bar-get-offset-value" role="function">
<title>gtk_level_bar_get_offset_value&#160;()</title>
<indexterm zone="gtk-level-bar-get-offset-value"><primary>gtk_level_bar_get_offset_value</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_level_bar_get_offset_value (<parameter><link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> *self</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                                <parameter><link linkend="gdouble"><type>gdouble</type></link> *value</parameter>);</programlisting>
<para>Fetches the value specified for the offset marker <parameter>name</parameter>
 in <parameter>self</parameter>
,
returning <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> in case an offset named <parameter>name</parameter>
 was found.</para>
<refsect3 id="gtk-level-bar-get-offset-value.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>the name of an offset in the bar. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>location where to store the value. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-level-bar-get-offset-value.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the specified offset is found</para>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkLevelBar.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GTK-LEVEL-BAR-OFFSET-LOW:CAPS" role="macro">
<title>GTK_LEVEL_BAR_OFFSET_LOW</title>
<indexterm zone="GTK-LEVEL-BAR-OFFSET-LOW:CAPS"><primary>GTK_LEVEL_BAR_OFFSET_LOW</primary></indexterm>
<programlisting language="C">#define GTK_LEVEL_BAR_OFFSET_LOW  "low"
</programlisting>
<para>The name used for the stock low offset included by <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link>.</para>
</refsect2>
<refsect2 id="GTK-LEVEL-BAR-OFFSET-HIGH:CAPS" role="macro">
<title>GTK_LEVEL_BAR_OFFSET_HIGH</title>
<indexterm zone="GTK-LEVEL-BAR-OFFSET-HIGH:CAPS"><primary>GTK_LEVEL_BAR_OFFSET_HIGH</primary></indexterm>
<programlisting language="C">#define GTK_LEVEL_BAR_OFFSET_HIGH "high"
</programlisting>
<para>The name used for the stock high offset included by <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link>.</para>
</refsect2>
<refsect2 id="GTK-LEVEL-BAR-OFFSET-FULL:CAPS" role="macro">
<title>GTK_LEVEL_BAR_OFFSET_FULL</title>
<indexterm zone="GTK-LEVEL-BAR-OFFSET-FULL:CAPS"><primary>GTK_LEVEL_BAR_OFFSET_FULL</primary></indexterm>
<programlisting language="C">#define GTK_LEVEL_BAR_OFFSET_FULL "full"
</programlisting>
<para>The name used for the stock full offset included by <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link>.</para>
</refsect2>
<refsect2 id="GtkLevelBarMode" role="enum">
<title>enum GtkLevelBarMode</title>
<indexterm zone="GtkLevelBarMode"><primary>GtkLevelBarMode</primary></indexterm>
<para>Describes how <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> contents should be rendered.
Note that this enumeration could be extended with additional modes
in the future.</para>
<refsect3 id="GtkLevelBarMode.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="GTK-LEVEL-BAR-MODE-CONTINUOUS:CAPS">GTK_LEVEL_BAR_MODE_CONTINUOUS</para></entry>
<entry role="enum_member_description"><para>the bar has a continuous mode</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-LEVEL-BAR-MODE-DISCRETE:CAPS">GTK_LEVEL_BAR_MODE_DISCRETE</para></entry>
<entry role="enum_member_description"><para>the bar has a discrete mode</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="GtkLevelBar-struct" role="struct">
<title>GtkLevelBar</title>
<indexterm zone="GtkLevelBar-struct"><primary>GtkLevelBar</primary></indexterm>
<programlisting language="C">typedef struct _GtkLevelBar GtkLevelBar;</programlisting>
</refsect2>

</refsect1>
<refsect1 id="GtkLevelBar.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkLevelBar--inverted" role="property"><title>The <literal>“inverted”</literal> property</title>
<indexterm zone="GtkLevelBar--inverted"><primary>GtkLevelBar:inverted</primary></indexterm>
<programlisting>  “inverted”                 <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Level bars normally grow from top to bottom or left to right.
Inverted level bars grow in the opposite direction.</para>
<para>Owner: GtkLevelBar</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkLevelBar--max-value" role="property"><title>The <literal>“max-value”</literal> property</title>
<indexterm zone="GtkLevelBar--max-value"><primary>GtkLevelBar:max-value</primary></indexterm>
<programlisting>  “max-value”                <link linkend="gdouble"><type>gdouble</type></link></programlisting>
<para>The <link linkend="GtkLevelBar--max-value"><type>“max-value”</type></link> property determaxes the maximum value of
the interval that can be displayed by the bar.</para>
<para>Owner: GtkLevelBar</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 1</para>
</refsect2>
<refsect2 id="GtkLevelBar--min-value" role="property"><title>The <literal>“min-value”</literal> property</title>
<indexterm zone="GtkLevelBar--min-value"><primary>GtkLevelBar:min-value</primary></indexterm>
<programlisting>  “min-value”                <link linkend="gdouble"><type>gdouble</type></link></programlisting>
<para>The <link linkend="GtkLevelBar--min-value"><type>“min-value”</type></link> property determines the minimum value of
the interval that can be displayed by the bar.</para>
<para>Owner: GtkLevelBar</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkLevelBar--mode" role="property"><title>The <literal>“mode”</literal> property</title>
<indexterm zone="GtkLevelBar--mode"><primary>GtkLevelBar:mode</primary></indexterm>
<programlisting>  “mode”                     <link linkend="GtkLevelBarMode"><type>GtkLevelBarMode</type></link></programlisting>
<para>The <link linkend="GtkLevelBar--mode"><type>“mode”</type></link> property determines the way <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link>
interprets the value properties to draw the level fill area.
Specifically, when the value is <link linkend="GTK-LEVEL-BAR-MODE-CONTINUOUS:CAPS"><type>GTK_LEVEL_BAR_MODE_CONTINUOUS</type></link>,
<link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> will draw a single block representing the current value in
that area; when the value is <link linkend="GTK-LEVEL-BAR-MODE-DISCRETE:CAPS"><type>GTK_LEVEL_BAR_MODE_DISCRETE</type></link>,
the widget will draw a succession of separate blocks filling the
draw area, with the number of blocks being equal to the units separating
the integral roundings of <link linkend="GtkLevelBar--min-value"><type>“min-value”</type></link> and <link linkend="GtkLevelBar--max-value"><type>“max-value”</type></link>.</para>
<para>Owner: GtkLevelBar</para>
<para>Flags: Read / Write</para>
<para>Default value: GTK_LEVEL_BAR_MODE_CONTINUOUS</para>
</refsect2>
<refsect2 id="GtkLevelBar--value" role="property"><title>The <literal>“value”</literal> property</title>
<indexterm zone="GtkLevelBar--value"><primary>GtkLevelBar:value</primary></indexterm>
<programlisting>  “value”                    <link linkend="gdouble"><type>gdouble</type></link></programlisting>
<para>The <link linkend="GtkLevelBar--value"><type>“value”</type></link> property determines the currently
filled value of the level bar.</para>
<para>Owner: GtkLevelBar</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>

</refsect1>
<refsect1 id="GtkLevelBar.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkLevelBar-offset-changed" role="signal"><title>The <literal>“offset-changed”</literal> signal</title>
<indexterm zone="GtkLevelBar-offset-changed"><primary>GtkLevelBar::offset-changed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkLevelBar"><type>GtkLevelBar</type></link> *self,
               <link linkend="gchar"><type>gchar</type></link>       *name,
               <link linkend="gpointer"><type>gpointer</type></link>     user_data)</programlisting>
<para>Emitted when an offset specified on the bar changes value as an
effect to <link linkend="gtk-level-bar-add-offset-value"><function>gtk_level_bar_add_offset_value()</function></link> being called.</para>
<para>The signal supports detailed connections; you can connect to the
detailed signal "changed::x" in order to only receive callbacks when
the value of offset "x" changes.</para>
<refsect3 id="GtkLevelBar-offset-changed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLevelBar"><type>GtkLevelBar</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>the name of the offset that changed value</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-DETAILED:CAPS">Has Details</link></para>
</refsect2>
</refsect1>

</refentry>
