gtktoolshell.c 6.17 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14
/* gtktoolshell.c
 * Copyright (C) 2007  Openismus GmbH
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
Javier Jardón's avatar
Javier Jardón committed
15
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
16 17 18 19 20
 *
 * Author:
 *   Mathias Hasselmann
 */

21
#include "config.h"
22 23 24
#include "gtktoolshell.h"
#include "gtkwidget.h"
#include "gtkintl.h"
25

26 27 28

/**
 * SECTION:gtktoolshell
29
 * @Short_description: Interface for containers containing GtkToolItem widgets
30
 * @Title: GtkToolShell
31
 * @see_also: #GtkToolbar, #GtkToolItem
32 33 34 35 36 37 38 39 40 41 42 43
 *
 * The #GtkToolShell interface allows container widgets to provide additional
 * information when embedding #GtkToolItem widgets.
 */

/**
 * GtkToolShell:
 *
 * Dummy structure for accessing instances of #GtkToolShellIface.
 */


44 45 46
typedef GtkToolShellIface GtkToolShellInterface;
G_DEFINE_INTERFACE (GtkToolShell, gtk_tool_shell, GTK_TYPE_WIDGET);

47 48 49
static GtkOrientation gtk_tool_shell_real_get_text_orientation (GtkToolShell *shell);
static gfloat gtk_tool_shell_real_get_text_alignment (GtkToolShell *shell);
static PangoEllipsizeMode gtk_tool_shell_real_get_ellipsize_mode (GtkToolShell *shell);
50

51 52 53
static void
gtk_tool_shell_default_init (GtkToolShellInterface *iface)
{
54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74
  iface->get_text_orientation = gtk_tool_shell_real_get_text_orientation;
  iface->get_text_alignment = gtk_tool_shell_real_get_text_alignment;
  iface->get_ellipsize_mode = gtk_tool_shell_real_get_ellipsize_mode;
}

static GtkOrientation
gtk_tool_shell_real_get_text_orientation (GtkToolShell *shell)
{
  return GTK_ORIENTATION_HORIZONTAL;
}

static gfloat
gtk_tool_shell_real_get_text_alignment (GtkToolShell *shell)
{
  return 0.5f;
}

static PangoEllipsizeMode
gtk_tool_shell_real_get_ellipsize_mode (GtkToolShell *shell)
{
  return PANGO_ELLIPSIZE_NONE;
75 76
}

77

78 79 80 81 82 83 84
/**
 * gtk_tool_shell_get_icon_size:
 * @shell: a #GtkToolShell
 *
 * Retrieves the icon size for the tool shell. Tool items must not call this
 * function directly, but rely on gtk_tool_item_get_icon_size() instead.
 *
85
 * Returns: (type int): the current size (#GtkIconSize) for icons of @shell
86
 *
87
 * Since: 2.14
88 89 90 91 92 93 94 95 96 97 98 99 100 101 102
 **/
GtkIconSize
gtk_tool_shell_get_icon_size (GtkToolShell *shell)
{
  return GTK_TOOL_SHELL_GET_IFACE (shell)->get_icon_size (shell);
}

/**
 * gtk_tool_shell_get_orientation:
 * @shell: a #GtkToolShell
 *
 * Retrieves the current orientation for the tool shell. Tool items must not
 * call this function directly, but rely on gtk_tool_item_get_orientation()
 * instead.
 *
103
 * Returns: the current orientation of @shell
104
 *
105
 * Since: 2.14
106 107 108 109 110 111 112 113 114 115 116 117
 **/
GtkOrientation
gtk_tool_shell_get_orientation (GtkToolShell *shell)
{
  return GTK_TOOL_SHELL_GET_IFACE (shell)->get_orientation (shell);
}

/**
 * gtk_tool_shell_get_style:
 * @shell: a #GtkToolShell
 *
 * Retrieves whether the tool shell has text, icons, or both. Tool items must
118
 * not call this function directly, but rely on gtk_tool_item_get_toolbar_style()
119 120
 * instead.
 *
121
 * Returns: the current style of @shell
122
 *
123
 * Since: 2.14
124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141
 **/
GtkToolbarStyle
gtk_tool_shell_get_style (GtkToolShell *shell)
{
  return GTK_TOOL_SHELL_GET_IFACE (shell)->get_style (shell);
}

/**
 * gtk_tool_shell_rebuild_menu:
 * @shell: a #GtkToolShell
 *
 * Calling this function signals the tool shell that the overflow menu item for
 * tool items have changed. If there is an overflow menu and if it is visible
 * when this function it called, the menu will be rebuilt.
 *
 * Tool items must not call this function directly, but rely on
 * gtk_tool_item_rebuild_menu() instead.
 *
142
 * Since: 2.14
143 144 145 146 147 148 149 150 151 152
 **/
void
gtk_tool_shell_rebuild_menu (GtkToolShell *shell)
{
  GtkToolShellIface *iface = GTK_TOOL_SHELL_GET_IFACE (shell);

  if (iface->rebuild_menu)
    iface->rebuild_menu (shell);
}

153 154 155 156 157 158 159 160
/**
 * gtk_tool_shell_get_text_orientation:
 * @shell: a #GtkToolShell
 *
 * Retrieves the current text orientation for the tool shell. Tool items must not
 * call this function directly, but rely on gtk_tool_item_get_text_orientation()
 * instead.
 *
161
 * Returns: the current text orientation of @shell
162
 *
163
 * Since: 2.20
164 165 166 167 168 169
 **/
GtkOrientation
gtk_tool_shell_get_text_orientation (GtkToolShell *shell)
{
  GtkToolShellIface *iface = GTK_TOOL_SHELL_GET_IFACE (shell);

170
  return iface->get_text_orientation (shell);
171 172 173 174 175 176 177 178 179 180
}

/**
 * gtk_tool_shell_get_text_alignment:
 * @shell: a #GtkToolShell
 *
 * Retrieves the current text alignment for the tool shell. Tool items must not
 * call this function directly, but rely on gtk_tool_item_get_text_alignment()
 * instead.
 *
181
 * Returns: the current text alignment of @shell
182
 *
183
 * Since: 2.20
184 185 186 187 188 189
 **/
gfloat
gtk_tool_shell_get_text_alignment (GtkToolShell *shell)
{
  GtkToolShellIface *iface = GTK_TOOL_SHELL_GET_IFACE (shell);

190
  return iface->get_text_alignment (shell);
191 192 193
}

/**
194
 * gtk_tool_shell_get_ellipsize_mode:
195 196 197 198 199 200
 * @shell: a #GtkToolShell
 *
 * Retrieves the current ellipsize mode for the tool shell. Tool items must not
 * call this function directly, but rely on gtk_tool_item_get_ellipsize_mode()
 * instead.
 *
201
 * Returns: the current ellipsize mode of @shell
202
 *
203
 * Since: 2.20
204 205 206 207 208 209
 **/
PangoEllipsizeMode
gtk_tool_shell_get_ellipsize_mode (GtkToolShell *shell)
{
  GtkToolShellIface *iface = GTK_TOOL_SHELL_GET_IFACE (shell);

210
  return iface->get_ellipsize_mode (shell);
211 212 213 214 215 216 217 218 219 220
}

/**
 * gtk_tool_shell_get_text_size_group:
 * @shell: a #GtkToolShell
 *
 * Retrieves the current text size group for the tool shell. Tool items must not
 * call this function directly, but rely on gtk_tool_item_get_text_size_group()
 * instead.
 *
221
 * Returns: (transfer none): the current text size group of @shell
222
 *
223
 * Since: 2.20
224 225 226 227 228 229 230 231 232 233 234
 **/
GtkSizeGroup *
gtk_tool_shell_get_text_size_group (GtkToolShell *shell)
{
  GtkToolShellIface *iface = GTK_TOOL_SHELL_GET_IFACE (shell);

  if (iface->get_text_size_group)
    return GTK_TOOL_SHELL_GET_IFACE (shell)->get_text_size_group (shell);

  return NULL;
}