gtk2/gtk/gtktoolshell.c
Javier Jardón e4ece66c9c gtktoolshell: Fix some "Since" tags
get_ellipsize_mode(), get_text_alignment(), get_text_orientation()
and get_text_size_group() were added in GTK+ 2.20,  not 2.14.

Reported by Stanislas Marquis on IRC.
2010-06-04 17:55:38 +02:00

253 lines
6.5 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, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*
* Author:
* Mathias Hasselmann
*/
#include "config.h"
#include "gtktoolshell.h"
#include "gtkwidget.h"
#include "gtkintl.h"
#include "gtkalias.h"
/**
* SECTION:gtktoolshell
* @Short_description: Interface for containers containing GtkToolItem widgets
* @Title: GtkToolShell
*
* The #GtkToolShell interface allows container widgets to provide additional
* information when embedding #GtkToolItem widgets.
*
* @see_also: #GtkToolbar, #GtkToolItem
*/
/**
* GtkToolShell:
*
* Dummy structure for accessing instances of #GtkToolShellIface.
*/
GType
gtk_tool_shell_get_type (void)
{
static GType type = 0;
if (!type)
{
type = g_type_register_static_simple (G_TYPE_INTERFACE, I_("GtkToolShell"),
sizeof (GtkToolShellIface),
NULL, 0, NULL, 0);
g_type_interface_add_prerequisite (type, GTK_TYPE_WIDGET);
}
return type;
}
/**
* 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_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);
if (iface->get_relief_style)
return iface->get_relief_style (shell);
return GTK_RELIEF_NONE;
}
/**
* 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);
if (iface->get_text_orientation)
return GTK_TOOL_SHELL_GET_IFACE (shell)->get_text_orientation (shell);
return GTK_ORIENTATION_HORIZONTAL;
}
/**
* 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);
if (iface->get_text_alignment)
return GTK_TOOL_SHELL_GET_IFACE (shell)->get_text_alignment (shell);
return 0.5f;
}
/**
* 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);
if (iface->get_ellipsize_mode)
return GTK_TOOL_SHELL_GET_IFACE (shell)->get_ellipsize_mode (shell);
return PANGO_ELLIPSIZE_NONE;
}
/**
* 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: 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;
}
#define __GTK_TOOL_SHELL_C__
#include "gtkaliasdef.c"