<?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="GtkShortcutsSection">
<refmeta>
<refentrytitle role="top_of_page" id="GtkShortcutsSection.top_of_page">GtkShortcutsSection</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkShortcutsSection</refname>
<refpurpose>Represents an application mode in a GtkShortcutsWindow</refpurpose>
</refnamediv>

<refsect1 id="GtkShortcutsSection.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="guint"><type>guint</type></link></entry><entry role="property_name"><link linkend="GtkShortcutsSection--max-height">max-height</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkShortcutsSection--section-name">section-name</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkShortcutsSection--title">title</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkShortcutsSection--view-name">view-name</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkShortcutsSection.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="gboolean"><returnvalue>gboolean</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkShortcutsSection-change-current-page">change-current-page</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkShortcutsSection.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="datatype_keyword"></entry><entry role="function_name"><link linkend="GtkShortcutsSection-struct">GtkShortcutsSection</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkShortcutsSection.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> <link linkend="GtkBox">GtkBox</link>
                <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkShortcutsSection
</screen>
</refsect1>
<refsect1 id="GtkShortcutsSection.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkShortcutsSection 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="GtkShortcutsSection.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtk.h&gt;
</synopsis></refsect1>

<refsect1 id="GtkShortcutsSection.description" role="desc">
<title role="desc.title">Description</title>
<para>A GtkShortcutsSection collects all the keyboard shortcuts and gestures
for a major application mode. If your application needs multiple sections,
you should give each section a unique <link linkend="GtkShortcutsSection--section-name"><type>“section-name”</type></link> and
a <link linkend="GtkShortcutsSection--title"><type>“title”</type></link> that can be shown in the section selector of
the GtkShortcutsWindow.</para>
<para>The <link linkend="GtkShortcutsSection--max-height"><type>“max-height”</type></link> property can be used to influence how
the groups in the section are distributed over pages and columns.</para>
<para>This widget is only meant to be used with <link linkend="GtkShortcutsWindow"><type>GtkShortcutsWindow</type></link>.</para>

</refsect1>
<refsect1 id="GtkShortcutsSection.functions_details" role="details">
<title role="details.title">Functions</title>
<para />
</refsect1>
<refsect1 id="GtkShortcutsSection.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkShortcutsSection-struct" role="struct">
<title>GtkShortcutsSection</title>
<indexterm zone="GtkShortcutsSection-struct"><primary>GtkShortcutsSection</primary></indexterm>
<programlisting language="C">typedef struct _GtkShortcutsSection GtkShortcutsSection;</programlisting>
</refsect2>

</refsect1>
<refsect1 id="GtkShortcutsSection.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkShortcutsSection--max-height" role="property"><title>The <literal>“max-height”</literal> property</title>
<indexterm zone="GtkShortcutsSection--max-height"><primary>GtkShortcutsSection:max-height</primary></indexterm>
<programlisting>  “max-height”               <link linkend="guint"><type>guint</type></link></programlisting>
<para>The maximum number of lines to allow per column. This property can
be used to influence how the groups in this section are distributed
across pages and columns. The default value of 15 should work in
most cases.</para>
<para>Owner: GtkShortcutsSection</para>
<para>Flags: Read / Write</para>
<para>Default value: 15</para>
</refsect2>
<refsect2 id="GtkShortcutsSection--section-name" role="property"><title>The <literal>“section-name”</literal> property</title>
<indexterm zone="GtkShortcutsSection--section-name"><primary>GtkShortcutsSection:section-name</primary></indexterm>
<programlisting>  “section-name”             <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>A unique name to identify this section among the sections
added to the GtkShortcutsWindow. Setting the <link linkend="GtkShortcutsWindow--section-name"><type>“section-name”</type></link>
property to this string will make this section shown in the
GtkShortcutsWindow.</para>
<para>Owner: GtkShortcutsSection</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkShortcutsSection--title" role="property"><title>The <literal>“title”</literal> property</title>
<indexterm zone="GtkShortcutsSection--title"><primary>GtkShortcutsSection:title</primary></indexterm>
<programlisting>  “title”                    <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The string to show in the section selector of the GtkShortcutsWindow
for this section. If there is only one section, you don't need to
set a title, since the section selector will not be shown in this case.</para>
<para>Owner: GtkShortcutsSection</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkShortcutsSection--view-name" role="property"><title>The <literal>“view-name”</literal> property</title>
<indexterm zone="GtkShortcutsSection--view-name"><primary>GtkShortcutsSection:view-name</primary></indexterm>
<programlisting>  “view-name”                <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>A view name to filter the groups in this section by.
See <link linkend="GtkShortcutsGroup--view"><type>“view”</type></link>.</para>
<para>Applications are expected to use the <link linkend="GtkShortcutsWindow--view-name"><type>“view-name”</type></link>
property for this purpose.</para>
<para>Owner: GtkShortcutsSection</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>

</refsect1>
<refsect1 id="GtkShortcutsSection.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkShortcutsSection-change-current-page" role="signal"><title>The <literal>“change-current-page”</literal> signal</title>
<indexterm zone="GtkShortcutsSection-change-current-page"><primary>GtkShortcutsSection::change-current-page</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
user_function (<link linkend="GtkShortcutsSection"><type>GtkShortcutsSection</type></link> *shortcutssection,
               <link linkend="gint"><type>gint</type></link>                 arg1,
               <link linkend="gpointer"><type>gpointer</type></link>             user_data)</programlisting>
<para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2>
</refsect1>

</refentry>
