mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-11-17 06:10:15 +00:00
050cba6a31
Most of these are forgotten :'s and similar details which gtk-doc now warns about.
262 lines
6.9 KiB
C
262 lines
6.9 KiB
C
/* 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
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* Author:
|
|
* Mathias Hasselmann
|
|
*/
|
|
|
|
#include "config.h"
|
|
#include "gtktoolshell.h"
|
|
#include "gtkwidget.h"
|
|
#include "gtkintl.h"
|
|
|
|
|
|
/**
|
|
* SECTION:gtktoolshell
|
|
* @Short_description: Interface for containers containing GtkToolItem widgets
|
|
* @Title: GtkToolShell
|
|
* @see_also: #GtkToolbar, #GtkToolItem
|
|
*
|
|
* The #GtkToolShell interface allows container widgets to provide additional
|
|
* information when embedding #GtkToolItem widgets.
|
|
*/
|
|
|
|
/**
|
|
* GtkToolShell:
|
|
*
|
|
* Dummy structure for accessing instances of #GtkToolShellIface.
|
|
*/
|
|
|
|
|
|
typedef GtkToolShellIface GtkToolShellInterface;
|
|
G_DEFINE_INTERFACE (GtkToolShell, gtk_tool_shell, GTK_TYPE_WIDGET);
|
|
|
|
static GtkReliefStyle gtk_tool_shell_real_get_relief_style (GtkToolShell *shell);
|
|
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);
|
|
|
|
static void
|
|
gtk_tool_shell_default_init (GtkToolShellInterface *iface)
|
|
{
|
|
iface->get_relief_style = gtk_tool_shell_real_get_relief_style;
|
|
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 GtkReliefStyle
|
|
gtk_tool_shell_real_get_relief_style (GtkToolShell *shell)
|
|
{
|
|
return GTK_RELIEF_NONE;
|
|
}
|
|
|
|
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;
|
|
}
|
|
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* Return value: (type int): the current size for icons of @shell
|
|
*
|
|
* Since: 2.14
|
|
**/
|
|
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.
|
|
*
|
|
* Return value: the current orientation of @shell
|
|
*
|
|
* Since: 2.14
|
|
**/
|
|
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
|
|
* not call this function directly, but rely on gtk_tool_item_get_toolbar_style()
|
|
* instead.
|
|
*
|
|
* Return value: the current style of @shell
|
|
*
|
|
* Since: 2.14
|
|
**/
|
|
GtkToolbarStyle
|
|
gtk_tool_shell_get_style (GtkToolShell *shell)
|
|
{
|
|
return GTK_TOOL_SHELL_GET_IFACE (shell)->get_style (shell);
|
|
}
|
|
|
|
/**
|
|
* gtk_tool_shell_get_relief_style:
|
|
* @shell: a #GtkToolShell
|
|
*
|
|
* Returns the relief style of buttons on @shell. Tool items must not call this
|
|
* function directly, but rely on gtk_tool_item_get_relief_style() instead.
|
|
*
|
|
* Return value: The relief style of buttons on @shell.
|
|
*
|
|
* Since: 2.14
|
|
**/
|
|
GtkReliefStyle
|
|
gtk_tool_shell_get_relief_style (GtkToolShell *shell)
|
|
{
|
|
GtkToolShellIface *iface = GTK_TOOL_SHELL_GET_IFACE (shell);
|
|
|
|
return iface->get_relief_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.
|
|
*
|
|
* Since: 2.14
|
|
**/
|
|
void
|
|
gtk_tool_shell_rebuild_menu (GtkToolShell *shell)
|
|
{
|
|
GtkToolShellIface *iface = GTK_TOOL_SHELL_GET_IFACE (shell);
|
|
|
|
if (iface->rebuild_menu)
|
|
iface->rebuild_menu (shell);
|
|
}
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* Return value: the current text orientation of @shell
|
|
*
|
|
* Since: 2.20
|
|
**/
|
|
GtkOrientation
|
|
gtk_tool_shell_get_text_orientation (GtkToolShell *shell)
|
|
{
|
|
GtkToolShellIface *iface = GTK_TOOL_SHELL_GET_IFACE (shell);
|
|
|
|
return iface->get_text_orientation (shell);
|
|
}
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* Return value: the current text alignment of @shell
|
|
*
|
|
* Since: 2.20
|
|
**/
|
|
gfloat
|
|
gtk_tool_shell_get_text_alignment (GtkToolShell *shell)
|
|
{
|
|
GtkToolShellIface *iface = GTK_TOOL_SHELL_GET_IFACE (shell);
|
|
|
|
return iface->get_text_alignment (shell);
|
|
}
|
|
|
|
/**
|
|
* gtk_tool_shell_get_ellipsize_mode:
|
|
* @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.
|
|
*
|
|
* Return value: the current ellipsize mode of @shell
|
|
*
|
|
* Since: 2.20
|
|
**/
|
|
PangoEllipsizeMode
|
|
gtk_tool_shell_get_ellipsize_mode (GtkToolShell *shell)
|
|
{
|
|
GtkToolShellIface *iface = GTK_TOOL_SHELL_GET_IFACE (shell);
|
|
|
|
return iface->get_ellipsize_mode (shell);
|
|
}
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* Return value: (transfer none): the current text size group of @shell
|
|
*
|
|
* Since: 2.20
|
|
**/
|
|
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;
|
|
}
|