W3cubDocs

/GTK 3.24

GtkSeparatorToolItem

GtkSeparatorToolItem — A toolbar item that separates groups of other toolbar items

Properties

gboolean draw Read / Write

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkToolItem
                        ╰── GtkSeparatorToolItem

Implemented Interfaces

GtkSeparatorToolItem implements AtkImplementorIface, GtkBuildable and GtkActivatable.

Includes

#include <gtk/gtk.h>

Description

A GtkSeparatorToolItem is a GtkToolItem that separates groups of other GtkToolItems. Depending on the theme, a GtkSeparatorToolItem will often look like a vertical line on horizontally docked toolbars.

If the GtkToolbar child property “expand” is TRUE and the property “draw” is FALSE, a GtkSeparatorToolItem will act as a “spring” that forces other items to the ends of the toolbar.

Use gtk_separator_tool_item_new() to create a new GtkSeparatorToolItem.

CSS nodes

GtkSeparatorToolItem has a single CSS node with name separator.

Functions

gtk_separator_tool_item_new ()

GtkToolItem *
gtk_separator_tool_item_new (void);

Create a new GtkSeparatorToolItem

Returns

the new GtkSeparatorToolItem

Since: 2.4

gtk_separator_tool_item_set_draw ()

void
gtk_separator_tool_item_set_draw (GtkSeparatorToolItem *item,
                                  gboolean draw);

Whether item is drawn as a vertical line, or just blank. Setting this to FALSE along with gtk_tool_item_set_expand() is useful to create an item that forces following items to the end of the toolbar.

Parameters

item

a GtkSeparatorToolItem

draw

whether item is drawn as a vertical line

Since: 2.4

gtk_separator_tool_item_get_draw ()

gboolean
gtk_separator_tool_item_get_draw (GtkSeparatorToolItem *item);

Returns whether item is drawn as a line, or just blank. See gtk_separator_tool_item_set_draw().

Parameters

Returns

TRUE if item is drawn as a line, or just blank.

Since: 2.4

Types and Values

struct GtkSeparatorToolItem

struct GtkSeparatorToolItem;

struct GtkSeparatorToolItemClass

struct GtkSeparatorToolItemClass {
  GtkToolItemClass parent_class;
};

Members

Property Details

The “draw” property

  “draw”                     gboolean

Whether the separator is drawn, or just blank.

Owner: GtkSeparatorToolItem

Flags: Read / Write

Default value: TRUE

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/GtkSeparatorToolItem.html