GtkShortcutsSection: GTK+ 3 Reference Manual

## GtkShortcutsSection GtkShortcutsSection — Represents an application mode in a GtkShortcutsWindow |

## Properties

guint | max-height | Read / Write
gchar * | section-name | Read / Write
gchar * | title | Read / Write
gchar * | view-name | Read / Write

## Signals

gboolean | change-current-page | Action

## Types and Values

| GtkShortcutsSection

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBox
                        ╰── GtkShortcutsSection

## Implemented Interfaces

GtkShortcutsSection implements AtkImplementorIface, GtkBuildable and GtkOrientable.

## Includes

    #include <gtk/gtk.h>

## Description

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 “section-name” and a “title” that can be shown in the section selector of the GtkShortcutsWindow.

The “max-height” property can be used to influence how the groups in the section are distributed over pages and columns.

This widget is only meant to be used with GtkShortcutsWindow.

## Functions

## Types and Values

### GtkShortcutsSection

    typedef struct _GtkShortcutsSection GtkShortcutsSection;

## Property Details

### The `“max-height”` property

      “max-height”               guint

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 for most cases.

Flags: Read / Write

Default value: 15

### The `“section-name”` property

      “section-name”             gchar *

A unique name to identify this section among the sections added to the GtkShortcutsWindow. Setting the “section-name” property to this string will make this section shown in the GtkShortcutsWindow.

Flags: Read / Write

Default value: NULL

### The `“title”` property

      “title”                    gchar *

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.

Flags: Read / Write

Default value: NULL

### The `“view-name”` property

      “view-name”                gchar *

A view name to filter the groups in this section by. See “view”.

Applications are expected to use the “view-name” property for this purpose.

Flags: Read / Write

Default value: NULL

## Signal Details

### The `“change-current-page”` signal

    gboolean
    user_function (GtkShortcutsSection *shortcutssection,
                   gint                 arg1,
                   gpointer             user_data)

Flags: Action