forked from AuroraMiddleware/gtk
996 lines
31 KiB
C
996 lines
31 KiB
C
/* GTK - The GIMP Toolkit
|
||
* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
|
||
*
|
||
* This library is free software; you can redistribute it and/or
|
||
* modify it under the terms of the GNU Lesser 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
|
||
* Lesser General Public License for more details.
|
||
*
|
||
* You should have received a copy of the GNU Lesser General Public
|
||
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
||
*/
|
||
|
||
/*
|
||
* Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
|
||
* file for a list of people on the GTK+ Team. See the ChangeLog
|
||
* files for a list of changes. These files are distributed with
|
||
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
|
||
*/
|
||
|
||
#include "config.h"
|
||
#include <string.h>
|
||
#include "gtkframe.h"
|
||
#include "gtklabel.h"
|
||
#include "gtkprivate.h"
|
||
#include "gtktypebuiltins.h"
|
||
#include "gtkintl.h"
|
||
#include "gtkbuildable.h"
|
||
#include "gtkwidgetpath.h"
|
||
#include "gtkcssnodeprivate.h"
|
||
#include "gtkcsscustomgadgetprivate.h"
|
||
#include "gtkwidgetprivate.h"
|
||
#include "gtkcontainerprivate.h"
|
||
#include "gtkstylecontextprivate.h"
|
||
#include "gtkcssstylepropertyprivate.h"
|
||
#include "gtklabel.h"
|
||
|
||
#include "a11y/gtkframeaccessible.h"
|
||
|
||
/**
|
||
* SECTION:gtkframe
|
||
* @Short_description: A bin with a decorative frame and optional label
|
||
* @Title: GtkFrame
|
||
*
|
||
* The frame widget is a bin that surrounds its child with a decorative
|
||
* frame and an optional label. If present, the label is drawn in a gap
|
||
* in the top side of the frame. The position of the label can be
|
||
* controlled with gtk_frame_set_label_align().
|
||
*
|
||
* # GtkFrame as GtkBuildable
|
||
*
|
||
* The GtkFrame implementation of the GtkBuildable interface supports
|
||
* placing a child in the label position by specifying “label” as the
|
||
* “type” attribute of a <child> element. A normal content child can
|
||
* be specified without specifying a <child> type attribute.
|
||
*
|
||
* An example of a UI definition fragment with GtkFrame:
|
||
* |[
|
||
* <object class="GtkFrame">
|
||
* <child type="label">
|
||
* <object class="GtkLabel" id="frame-label"/>
|
||
* </child>
|
||
* <child>
|
||
* <object class="GtkEntry" id="frame-content"/>
|
||
* </child>
|
||
* </object>
|
||
* ]|
|
||
*
|
||
* # CSS nodes
|
||
*
|
||
* |[<!-- language="plain" -->
|
||
* frame
|
||
* ├── border
|
||
* ├── <label widget>
|
||
* ╰── <child>
|
||
* ]|
|
||
*
|
||
* GtkFrame has a main CSS node with name frame and a subnode with
|
||
* name border. The border node is used to render the visible border.
|
||
* The style class .flat can appear with the main node.
|
||
*/
|
||
|
||
struct _GtkFramePrivate
|
||
{
|
||
/* Properties */
|
||
GtkWidget *label_widget;
|
||
|
||
GtkCssGadget *gadget;
|
||
GtkCssGadget *border_gadget;
|
||
|
||
gint16 shadow_type;
|
||
gfloat label_xalign;
|
||
gfloat label_yalign;
|
||
/* Properties */
|
||
|
||
GtkAllocation child_allocation;
|
||
GtkAllocation label_allocation;
|
||
};
|
||
|
||
enum {
|
||
PROP_0,
|
||
PROP_LABEL,
|
||
PROP_LABEL_XALIGN,
|
||
PROP_LABEL_YALIGN,
|
||
PROP_SHADOW_TYPE,
|
||
PROP_LABEL_WIDGET,
|
||
LAST_PROP
|
||
};
|
||
|
||
static GParamSpec *frame_props[LAST_PROP];
|
||
|
||
static void gtk_frame_finalize (GObject *object);
|
||
static void gtk_frame_set_property (GObject *object,
|
||
guint param_id,
|
||
const GValue *value,
|
||
GParamSpec *pspec);
|
||
static void gtk_frame_get_property (GObject *object,
|
||
guint param_id,
|
||
GValue *value,
|
||
GParamSpec *pspec);
|
||
static GskRenderNode * gtk_frame_get_render_node (GtkWidget *widget,
|
||
GskRenderer *renderer);
|
||
static void gtk_frame_size_allocate (GtkWidget *widget,
|
||
GtkAllocation *allocation);
|
||
static void gtk_frame_remove (GtkContainer *container,
|
||
GtkWidget *child);
|
||
static void gtk_frame_forall (GtkContainer *container,
|
||
gboolean include_internals,
|
||
GtkCallback callback,
|
||
gpointer callback_data);
|
||
|
||
static void gtk_frame_compute_child_allocation (GtkFrame *frame,
|
||
GtkAllocation *child_allocation);
|
||
static void gtk_frame_real_compute_child_allocation (GtkFrame *frame,
|
||
GtkAllocation *child_allocation);
|
||
|
||
/* GtkBuildable */
|
||
static void gtk_frame_buildable_init (GtkBuildableIface *iface);
|
||
static void gtk_frame_buildable_add_child (GtkBuildable *buildable,
|
||
GtkBuilder *builder,
|
||
GObject *child,
|
||
const gchar *type);
|
||
static void gtk_frame_measure_ (GtkWidget *widget,
|
||
GtkOrientation orientation,
|
||
gint for_size,
|
||
gint *minimum_size,
|
||
gint *natural_size,
|
||
gint *minimum_baseline,
|
||
gint *natural_baseline);
|
||
static void gtk_frame_state_flags_changed (GtkWidget *widget,
|
||
GtkStateFlags previous_state);
|
||
|
||
static void gtk_frame_measure (GtkCssGadget *gadget,
|
||
GtkOrientation orientation,
|
||
gint for_size,
|
||
gint *minimum_size,
|
||
gint *natural_size,
|
||
gint *minimum_baseline,
|
||
gint *natural_baseline,
|
||
gpointer data);
|
||
static void gtk_frame_measure_border (GtkCssGadget *gadget,
|
||
GtkOrientation orientation,
|
||
gint for_size,
|
||
gint *minimum_size,
|
||
gint *natural_size,
|
||
gint *minimum_baseline,
|
||
gint *natural_baseline,
|
||
gpointer data);
|
||
static void gtk_frame_allocate (GtkCssGadget *gadget,
|
||
const GtkAllocation *allocation,
|
||
int baseline,
|
||
GtkAllocation *out_clip,
|
||
gpointer data);
|
||
static void gtk_frame_allocate_border (GtkCssGadget *gadget,
|
||
const GtkAllocation *allocation,
|
||
int baseline,
|
||
GtkAllocation *out_clip,
|
||
gpointer data);
|
||
|
||
|
||
G_DEFINE_TYPE_WITH_CODE (GtkFrame, gtk_frame, GTK_TYPE_BIN,
|
||
G_ADD_PRIVATE (GtkFrame)
|
||
G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
|
||
gtk_frame_buildable_init))
|
||
|
||
static void
|
||
gtk_frame_class_init (GtkFrameClass *class)
|
||
{
|
||
GObjectClass *gobject_class;
|
||
GtkWidgetClass *widget_class;
|
||
GtkContainerClass *container_class;
|
||
|
||
gobject_class = (GObjectClass*) class;
|
||
widget_class = GTK_WIDGET_CLASS (class);
|
||
container_class = GTK_CONTAINER_CLASS (class);
|
||
|
||
gobject_class->finalize = gtk_frame_finalize;
|
||
gobject_class->set_property = gtk_frame_set_property;
|
||
gobject_class->get_property = gtk_frame_get_property;
|
||
|
||
frame_props[PROP_LABEL] =
|
||
g_param_spec_string ("label",
|
||
P_("Label"),
|
||
P_("Text of the frame's label"),
|
||
NULL,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
frame_props[PROP_LABEL_XALIGN] =
|
||
g_param_spec_float ("label-xalign",
|
||
P_("Label xalign"),
|
||
P_("The horizontal alignment of the label"),
|
||
0.0, 1.0,
|
||
0.0,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
frame_props[PROP_LABEL_YALIGN] =
|
||
g_param_spec_float ("label-yalign",
|
||
P_("Label yalign"),
|
||
P_("The vertical alignment of the label"),
|
||
0.0, 1.0,
|
||
0.5,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
frame_props[PROP_SHADOW_TYPE] =
|
||
g_param_spec_enum ("shadow-type",
|
||
P_("Frame shadow"),
|
||
P_("Appearance of the frame border"),
|
||
GTK_TYPE_SHADOW_TYPE,
|
||
GTK_SHADOW_ETCHED_IN,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
frame_props[PROP_LABEL_WIDGET] =
|
||
g_param_spec_object ("label-widget",
|
||
P_("Label widget"),
|
||
P_("A widget to display in place of the usual frame label"),
|
||
GTK_TYPE_WIDGET,
|
||
GTK_PARAM_READWRITE);
|
||
|
||
g_object_class_install_properties (gobject_class, LAST_PROP, frame_props);
|
||
|
||
widget_class->get_render_node = gtk_frame_get_render_node;
|
||
widget_class->size_allocate = gtk_frame_size_allocate;
|
||
widget_class->measure = gtk_frame_measure_;
|
||
widget_class->state_flags_changed = gtk_frame_state_flags_changed;
|
||
|
||
container_class->remove = gtk_frame_remove;
|
||
container_class->forall = gtk_frame_forall;
|
||
|
||
class->compute_child_allocation = gtk_frame_real_compute_child_allocation;
|
||
|
||
gtk_widget_class_set_accessible_type (widget_class, GTK_TYPE_FRAME_ACCESSIBLE);
|
||
gtk_widget_class_set_css_name (widget_class, "frame");
|
||
}
|
||
|
||
static void
|
||
gtk_frame_buildable_init (GtkBuildableIface *iface)
|
||
{
|
||
iface->add_child = gtk_frame_buildable_add_child;
|
||
}
|
||
|
||
static void
|
||
gtk_frame_buildable_add_child (GtkBuildable *buildable,
|
||
GtkBuilder *builder,
|
||
GObject *child,
|
||
const gchar *type)
|
||
{
|
||
if (type && strcmp (type, "label") == 0)
|
||
gtk_frame_set_label_widget (GTK_FRAME (buildable), GTK_WIDGET (child));
|
||
else if (!type)
|
||
gtk_container_add (GTK_CONTAINER (buildable), GTK_WIDGET (child));
|
||
else
|
||
GTK_BUILDER_WARN_INVALID_CHILD_TYPE (GTK_FRAME (buildable), type);
|
||
}
|
||
|
||
static void
|
||
gtk_frame_init (GtkFrame *frame)
|
||
{
|
||
GtkFramePrivate *priv;
|
||
GtkCssNode *widget_node;
|
||
|
||
frame->priv = gtk_frame_get_instance_private (frame);
|
||
priv = frame->priv;
|
||
|
||
priv->label_widget = NULL;
|
||
priv->shadow_type = GTK_SHADOW_ETCHED_IN;
|
||
priv->label_xalign = 0.0;
|
||
priv->label_yalign = 0.5;
|
||
|
||
widget_node = gtk_widget_get_css_node (GTK_WIDGET (frame));
|
||
priv->gadget = gtk_css_custom_gadget_new_for_node (widget_node,
|
||
GTK_WIDGET (frame),
|
||
gtk_frame_measure,
|
||
gtk_frame_allocate,
|
||
NULL,
|
||
NULL,
|
||
NULL,
|
||
NULL);
|
||
priv->border_gadget = gtk_css_custom_gadget_new ("border",
|
||
GTK_WIDGET (frame),
|
||
priv->gadget,
|
||
NULL,
|
||
gtk_frame_measure_border,
|
||
gtk_frame_allocate_border,
|
||
NULL,
|
||
NULL,
|
||
NULL,
|
||
NULL);
|
||
|
||
gtk_css_gadget_set_state (priv->border_gadget, gtk_widget_get_state_flags (GTK_WIDGET (frame)));
|
||
}
|
||
|
||
static void
|
||
gtk_frame_finalize (GObject *object)
|
||
{
|
||
GtkFrame *frame = GTK_FRAME (object);
|
||
GtkFramePrivate *priv = frame->priv;
|
||
|
||
g_clear_object (&priv->border_gadget);
|
||
g_clear_object (&priv->gadget);
|
||
|
||
G_OBJECT_CLASS (gtk_frame_parent_class)->finalize (object);
|
||
}
|
||
|
||
static void
|
||
gtk_frame_set_property (GObject *object,
|
||
guint prop_id,
|
||
const GValue *value,
|
||
GParamSpec *pspec)
|
||
{
|
||
GtkFrame *frame = GTK_FRAME (object);
|
||
GtkFramePrivate *priv = frame->priv;
|
||
|
||
switch (prop_id)
|
||
{
|
||
case PROP_LABEL:
|
||
gtk_frame_set_label (frame, g_value_get_string (value));
|
||
break;
|
||
case PROP_LABEL_XALIGN:
|
||
gtk_frame_set_label_align (frame, g_value_get_float (value),
|
||
priv->label_yalign);
|
||
break;
|
||
case PROP_LABEL_YALIGN:
|
||
gtk_frame_set_label_align (frame, priv->label_xalign,
|
||
g_value_get_float (value));
|
||
break;
|
||
case PROP_SHADOW_TYPE:
|
||
gtk_frame_set_shadow_type (frame, g_value_get_enum (value));
|
||
break;
|
||
case PROP_LABEL_WIDGET:
|
||
gtk_frame_set_label_widget (frame, g_value_get_object (value));
|
||
break;
|
||
default:
|
||
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
||
break;
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_frame_get_property (GObject *object,
|
||
guint prop_id,
|
||
GValue *value,
|
||
GParamSpec *pspec)
|
||
{
|
||
GtkFrame *frame = GTK_FRAME (object);
|
||
GtkFramePrivate *priv = frame->priv;
|
||
|
||
switch (prop_id)
|
||
{
|
||
case PROP_LABEL:
|
||
g_value_set_string (value, gtk_frame_get_label (frame));
|
||
break;
|
||
case PROP_LABEL_XALIGN:
|
||
g_value_set_float (value, priv->label_xalign);
|
||
break;
|
||
case PROP_LABEL_YALIGN:
|
||
g_value_set_float (value, priv->label_yalign);
|
||
break;
|
||
case PROP_SHADOW_TYPE:
|
||
g_value_set_enum (value, priv->shadow_type);
|
||
break;
|
||
case PROP_LABEL_WIDGET:
|
||
g_value_set_object (value,
|
||
priv->label_widget ?
|
||
G_OBJECT (priv->label_widget) : NULL);
|
||
break;
|
||
default:
|
||
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
||
break;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_frame_new:
|
||
* @label: (allow-none): the text to use as the label of the frame
|
||
*
|
||
* Creates a new #GtkFrame, with optional label @label.
|
||
* If @label is %NULL, the label is omitted.
|
||
*
|
||
* Returns: a new #GtkFrame widget
|
||
**/
|
||
GtkWidget*
|
||
gtk_frame_new (const gchar *label)
|
||
{
|
||
return g_object_new (GTK_TYPE_FRAME, "label", label, NULL);
|
||
}
|
||
|
||
static void
|
||
gtk_frame_remove (GtkContainer *container,
|
||
GtkWidget *child)
|
||
{
|
||
GtkFrame *frame = GTK_FRAME (container);
|
||
GtkFramePrivate *priv = frame->priv;
|
||
|
||
if (priv->label_widget == child)
|
||
gtk_frame_set_label_widget (frame, NULL);
|
||
else
|
||
GTK_CONTAINER_CLASS (gtk_frame_parent_class)->remove (container, child);
|
||
}
|
||
|
||
static void
|
||
gtk_frame_forall (GtkContainer *container,
|
||
gboolean include_internals,
|
||
GtkCallback callback,
|
||
gpointer callback_data)
|
||
{
|
||
GtkBin *bin = GTK_BIN (container);
|
||
GtkFrame *frame = GTK_FRAME (container);
|
||
GtkFramePrivate *priv = frame->priv;
|
||
GtkWidget *child;
|
||
|
||
child = gtk_bin_get_child (bin);
|
||
if (child)
|
||
(* callback) (child, callback_data);
|
||
|
||
if (priv->label_widget)
|
||
(* callback) (priv->label_widget, callback_data);
|
||
}
|
||
|
||
/**
|
||
* gtk_frame_set_label:
|
||
* @frame: a #GtkFrame
|
||
* @label: (allow-none): the text to use as the label of the frame
|
||
*
|
||
* Sets the text of the label. If @label is %NULL,
|
||
* the current label is removed.
|
||
**/
|
||
void
|
||
gtk_frame_set_label (GtkFrame *frame,
|
||
const gchar *label)
|
||
{
|
||
g_return_if_fail (GTK_IS_FRAME (frame));
|
||
|
||
if (!label)
|
||
{
|
||
gtk_frame_set_label_widget (frame, NULL);
|
||
}
|
||
else
|
||
{
|
||
GtkWidget *child = gtk_label_new (label);
|
||
gtk_widget_show (child);
|
||
|
||
gtk_frame_set_label_widget (frame, child);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_frame_get_label:
|
||
* @frame: a #GtkFrame
|
||
*
|
||
* If the frame’s label widget is a #GtkLabel, returns the
|
||
* text in the label widget. (The frame will have a #GtkLabel
|
||
* for the label widget if a non-%NULL argument was passed
|
||
* to gtk_frame_new().)
|
||
*
|
||
* Returns: (nullable): the text in the label, or %NULL if there
|
||
* was no label widget or the lable widget was not
|
||
* a #GtkLabel. This string is owned by GTK+ and
|
||
* must not be modified or freed.
|
||
**/
|
||
const gchar *
|
||
gtk_frame_get_label (GtkFrame *frame)
|
||
{
|
||
GtkFramePrivate *priv;
|
||
|
||
g_return_val_if_fail (GTK_IS_FRAME (frame), NULL);
|
||
|
||
priv = frame->priv;
|
||
|
||
if (GTK_IS_LABEL (priv->label_widget))
|
||
return gtk_label_get_text (GTK_LABEL (priv->label_widget));
|
||
else
|
||
return NULL;
|
||
}
|
||
|
||
/**
|
||
* gtk_frame_set_label_widget:
|
||
* @frame: a #GtkFrame
|
||
* @label_widget: (nullable): the new label widget
|
||
*
|
||
* Sets the label widget for the frame. This is the widget that
|
||
* will appear embedded in the top edge of the frame as a
|
||
* title.
|
||
**/
|
||
void
|
||
gtk_frame_set_label_widget (GtkFrame *frame,
|
||
GtkWidget *label_widget)
|
||
{
|
||
GtkFramePrivate *priv;
|
||
gboolean need_resize = FALSE;
|
||
|
||
g_return_if_fail (GTK_IS_FRAME (frame));
|
||
g_return_if_fail (label_widget == NULL || GTK_IS_WIDGET (label_widget));
|
||
g_return_if_fail (label_widget == NULL || gtk_widget_get_parent (label_widget) == NULL);
|
||
|
||
priv = frame->priv;
|
||
|
||
if (priv->label_widget == label_widget)
|
||
return;
|
||
|
||
if (priv->label_widget)
|
||
{
|
||
need_resize = gtk_widget_get_visible (priv->label_widget);
|
||
gtk_widget_unparent (priv->label_widget);
|
||
}
|
||
|
||
priv->label_widget = label_widget;
|
||
|
||
if (label_widget)
|
||
{
|
||
priv->label_widget = label_widget;
|
||
gtk_widget_set_parent (label_widget, GTK_WIDGET (frame));
|
||
need_resize |= gtk_widget_get_visible (label_widget);
|
||
}
|
||
|
||
if (gtk_widget_get_visible (GTK_WIDGET (frame)) && need_resize)
|
||
gtk_widget_queue_resize (GTK_WIDGET (frame));
|
||
|
||
g_object_freeze_notify (G_OBJECT (frame));
|
||
g_object_notify_by_pspec (G_OBJECT (frame), frame_props[PROP_LABEL_WIDGET]);
|
||
g_object_notify_by_pspec (G_OBJECT (frame), frame_props[PROP_LABEL]);
|
||
g_object_thaw_notify (G_OBJECT (frame));
|
||
}
|
||
|
||
/**
|
||
* gtk_frame_get_label_widget:
|
||
* @frame: a #GtkFrame
|
||
*
|
||
* Retrieves the label widget for the frame. See
|
||
* gtk_frame_set_label_widget().
|
||
*
|
||
* Returns: (nullable) (transfer none): the label widget, or %NULL if
|
||
* there is none.
|
||
**/
|
||
GtkWidget *
|
||
gtk_frame_get_label_widget (GtkFrame *frame)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_FRAME (frame), NULL);
|
||
|
||
return frame->priv->label_widget;
|
||
}
|
||
|
||
/**
|
||
* gtk_frame_set_label_align:
|
||
* @frame: a #GtkFrame
|
||
* @xalign: The position of the label along the top edge
|
||
* of the widget. A value of 0.0 represents left alignment;
|
||
* 1.0 represents right alignment.
|
||
* @yalign: The y alignment of the label. A value of 0.0 aligns under
|
||
* the frame; 1.0 aligns above the frame. If the values are exactly
|
||
* 0.0 or 1.0 the gap in the frame won’t be painted because the label
|
||
* will be completely above or below the frame.
|
||
*
|
||
* Sets the alignment of the frame widget’s label. The
|
||
* default values for a newly created frame are 0.0 and 0.5.
|
||
**/
|
||
void
|
||
gtk_frame_set_label_align (GtkFrame *frame,
|
||
gfloat xalign,
|
||
gfloat yalign)
|
||
{
|
||
GtkFramePrivate *priv;
|
||
|
||
g_return_if_fail (GTK_IS_FRAME (frame));
|
||
|
||
priv = frame->priv;
|
||
|
||
xalign = CLAMP (xalign, 0.0, 1.0);
|
||
yalign = CLAMP (yalign, 0.0, 1.0);
|
||
|
||
g_object_freeze_notify (G_OBJECT (frame));
|
||
if (xalign != priv->label_xalign)
|
||
{
|
||
priv->label_xalign = xalign;
|
||
g_object_notify_by_pspec (G_OBJECT (frame), frame_props[PROP_LABEL_XALIGN]);
|
||
}
|
||
|
||
if (yalign != priv->label_yalign)
|
||
{
|
||
priv->label_yalign = yalign;
|
||
g_object_notify_by_pspec (G_OBJECT (frame), frame_props[PROP_LABEL_YALIGN]);
|
||
}
|
||
|
||
g_object_thaw_notify (G_OBJECT (frame));
|
||
gtk_widget_queue_resize (GTK_WIDGET (frame));
|
||
}
|
||
|
||
/**
|
||
* gtk_frame_get_label_align:
|
||
* @frame: a #GtkFrame
|
||
* @xalign: (out) (allow-none): location to store X alignment of
|
||
* frame’s label, or %NULL
|
||
* @yalign: (out) (allow-none): location to store X alignment of
|
||
* frame’s label, or %NULL
|
||
*
|
||
* Retrieves the X and Y alignment of the frame’s label. See
|
||
* gtk_frame_set_label_align().
|
||
**/
|
||
void
|
||
gtk_frame_get_label_align (GtkFrame *frame,
|
||
gfloat *xalign,
|
||
gfloat *yalign)
|
||
{
|
||
GtkFramePrivate *priv;
|
||
|
||
g_return_if_fail (GTK_IS_FRAME (frame));
|
||
|
||
priv = frame->priv;
|
||
|
||
if (xalign)
|
||
*xalign = priv->label_xalign;
|
||
if (yalign)
|
||
*yalign = priv->label_yalign;
|
||
}
|
||
|
||
/**
|
||
* gtk_frame_set_shadow_type:
|
||
* @frame: a #GtkFrame
|
||
* @type: the new #GtkShadowType
|
||
*
|
||
* Sets the shadow type for @frame.
|
||
**/
|
||
void
|
||
gtk_frame_set_shadow_type (GtkFrame *frame,
|
||
GtkShadowType type)
|
||
{
|
||
GtkFramePrivate *priv;
|
||
|
||
g_return_if_fail (GTK_IS_FRAME (frame));
|
||
|
||
priv = frame->priv;
|
||
|
||
if ((GtkShadowType) priv->shadow_type != type)
|
||
{
|
||
priv->shadow_type = type;
|
||
|
||
if (type == GTK_SHADOW_NONE)
|
||
gtk_css_gadget_add_class (priv->border_gadget, GTK_STYLE_CLASS_FLAT);
|
||
else
|
||
gtk_css_gadget_remove_class (priv->border_gadget, GTK_STYLE_CLASS_FLAT);
|
||
|
||
g_object_notify_by_pspec (G_OBJECT (frame), frame_props[PROP_SHADOW_TYPE]);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_frame_get_shadow_type:
|
||
* @frame: a #GtkFrame
|
||
*
|
||
* Retrieves the shadow type of the frame. See
|
||
* gtk_frame_set_shadow_type().
|
||
*
|
||
* Returns: the current shadow type of the frame.
|
||
**/
|
||
GtkShadowType
|
||
gtk_frame_get_shadow_type (GtkFrame *frame)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_FRAME (frame), GTK_SHADOW_ETCHED_IN);
|
||
|
||
return frame->priv->shadow_type;
|
||
}
|
||
|
||
static GskRenderNode *
|
||
gtk_frame_get_render_node (GtkWidget *widget,
|
||
GskRenderer *renderer)
|
||
{
|
||
GtkFramePrivate *priv = GTK_FRAME (widget)->priv;
|
||
GtkAllocation allocation;
|
||
GskRenderNode *node;
|
||
cairo_t *cr;
|
||
int xc, yc, w, h;
|
||
|
||
gtk_widget_get_allocation (widget, &allocation);
|
||
|
||
node = gtk_css_gadget_get_render_node (priv->gadget, renderer, FALSE);
|
||
|
||
cr = gsk_render_node_get_draw_context (node, renderer);
|
||
|
||
/* We want to use the standard gadget drawing for the border,
|
||
* so we clip out the label allocation in order to get the
|
||
* frame gap.
|
||
*/
|
||
xc = priv->label_allocation.x - allocation.x;
|
||
yc = allocation.y;
|
||
w = priv->label_allocation.width;
|
||
h = priv->label_allocation.height;
|
||
|
||
if (GTK_IS_LABEL (priv->label_widget))
|
||
{
|
||
PangoRectangle ink_rect;
|
||
|
||
/* Shrink the clip area for labels, so we get unclipped
|
||
* frames for the yalign 0.0 and 1.0 cases.
|
||
*/
|
||
pango_layout_get_pixel_extents (gtk_label_get_layout (GTK_LABEL (priv->label_widget)), &ink_rect, NULL);
|
||
yc += (h - ink_rect.height) / 2;
|
||
h = ink_rect.height;
|
||
}
|
||
|
||
cairo_rectangle (cr, 0, 0, allocation.width, allocation.height);
|
||
cairo_rectangle (cr, xc + w, yc, - w, h);
|
||
cairo_set_fill_rule (cr, CAIRO_FILL_RULE_WINDING);
|
||
cairo_clip (cr);
|
||
|
||
gtk_css_gadget_draw (priv->border_gadget, cr);
|
||
|
||
cairo_destroy (cr);
|
||
|
||
gtk_container_propagate_render_node (GTK_CONTAINER (widget), renderer, node);
|
||
|
||
return node;
|
||
}
|
||
|
||
static void
|
||
gtk_frame_size_allocate (GtkWidget *widget,
|
||
GtkAllocation *allocation)
|
||
{
|
||
GtkAllocation clip;
|
||
|
||
gtk_widget_set_allocation (widget, allocation);
|
||
|
||
gtk_css_gadget_allocate (GTK_FRAME (widget)->priv->gadget,
|
||
allocation,
|
||
gtk_widget_get_allocated_baseline (widget),
|
||
&clip);
|
||
|
||
gtk_widget_set_clip (widget, &clip);
|
||
}
|
||
|
||
static void
|
||
gtk_frame_allocate (GtkCssGadget *gadget,
|
||
const GtkAllocation *allocation,
|
||
int baseline,
|
||
GtkAllocation *out_clip,
|
||
gpointer data)
|
||
{
|
||
GtkWidget *widget;
|
||
GtkFrame *frame;
|
||
GtkFramePrivate *priv;
|
||
GtkAllocation new_allocation;
|
||
GtkAllocation frame_allocation;
|
||
gint height_extra;
|
||
GtkAllocation clip;
|
||
|
||
widget = gtk_css_gadget_get_owner (gadget);
|
||
frame = GTK_FRAME (widget);
|
||
priv = frame->priv;
|
||
|
||
gtk_frame_compute_child_allocation (frame, &new_allocation);
|
||
priv->child_allocation = new_allocation;
|
||
|
||
if (priv->label_widget &&
|
||
gtk_widget_get_visible (priv->label_widget))
|
||
{
|
||
gint nat_width, width, height;
|
||
gfloat xalign;
|
||
|
||
if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_LTR)
|
||
xalign = priv->label_xalign;
|
||
else
|
||
xalign = 1 - priv->label_xalign;
|
||
|
||
gtk_widget_get_preferred_width (priv->label_widget, NULL, &nat_width);
|
||
width = MIN (new_allocation.width, nat_width);
|
||
gtk_widget_get_preferred_height_for_width (priv->label_widget, width, &height, NULL);
|
||
|
||
priv->label_allocation.x = new_allocation.x + (new_allocation.width - width) * xalign;
|
||
priv->label_allocation.y = new_allocation.y - height;
|
||
priv->label_allocation.height = height;
|
||
priv->label_allocation.width = width;
|
||
|
||
gtk_widget_size_allocate (priv->label_widget, &priv->label_allocation);
|
||
|
||
height_extra = (1 - priv->label_yalign) * height;
|
||
}
|
||
else
|
||
height_extra = 0;
|
||
|
||
frame_allocation.x = priv->child_allocation.x;
|
||
frame_allocation.y = priv->child_allocation.y - height_extra;
|
||
frame_allocation.width = priv->child_allocation.width;
|
||
frame_allocation.height = priv->child_allocation.height + height_extra;
|
||
|
||
gtk_css_gadget_allocate (priv->border_gadget,
|
||
&frame_allocation,
|
||
-1,
|
||
&clip);
|
||
|
||
gtk_container_get_children_clip (GTK_CONTAINER (widget), out_clip);
|
||
gdk_rectangle_union (out_clip, &clip, out_clip);
|
||
}
|
||
|
||
static void
|
||
gtk_frame_allocate_border (GtkCssGadget *gadget,
|
||
const GtkAllocation *allocation,
|
||
int baseline,
|
||
GtkAllocation *out_clip,
|
||
gpointer data)
|
||
{
|
||
GtkWidget *widget;
|
||
GtkFramePrivate *priv;
|
||
GtkWidget *child;
|
||
GtkAllocation child_allocation;
|
||
gint height_extra;
|
||
|
||
widget = gtk_css_gadget_get_owner (gadget);
|
||
priv = GTK_FRAME (widget)->priv;
|
||
|
||
if (priv->label_widget &&
|
||
gtk_widget_get_visible (priv->label_widget))
|
||
height_extra = priv->label_allocation.height * (1 - priv->label_yalign);
|
||
else
|
||
height_extra = 0;
|
||
|
||
child_allocation = *allocation;
|
||
child_allocation.y += height_extra;
|
||
child_allocation.height -= height_extra;
|
||
|
||
child = gtk_bin_get_child (GTK_BIN (widget));
|
||
if (child && gtk_widget_get_visible (child))
|
||
gtk_widget_size_allocate (child, &child_allocation);
|
||
|
||
*out_clip = *allocation;
|
||
}
|
||
|
||
static void
|
||
gtk_frame_compute_child_allocation (GtkFrame *frame,
|
||
GtkAllocation *child_allocation)
|
||
{
|
||
g_return_if_fail (GTK_IS_FRAME (frame));
|
||
g_return_if_fail (child_allocation != NULL);
|
||
|
||
GTK_FRAME_GET_CLASS (frame)->compute_child_allocation (frame, child_allocation);
|
||
}
|
||
|
||
static void
|
||
gtk_frame_real_compute_child_allocation (GtkFrame *frame,
|
||
GtkAllocation *child_allocation)
|
||
{
|
||
GtkFramePrivate *priv = frame->priv;
|
||
GtkAllocation allocation;
|
||
gint height;
|
||
|
||
gtk_css_gadget_get_content_allocation (priv->gadget, &allocation, NULL);
|
||
|
||
if (priv->label_widget)
|
||
{
|
||
gint nat_width, width;
|
||
|
||
gtk_widget_get_preferred_width (priv->label_widget, NULL, &nat_width);
|
||
width = MIN (allocation.width, nat_width);
|
||
gtk_widget_get_preferred_height_for_width (priv->label_widget, width, &height, NULL);
|
||
}
|
||
else
|
||
height = 0;
|
||
|
||
child_allocation->x = allocation.x;
|
||
child_allocation->y = allocation.y + height;
|
||
child_allocation->width = MAX (1, allocation.width);
|
||
child_allocation->height = MAX (1, allocation.height - height);
|
||
}
|
||
|
||
static void
|
||
gtk_frame_measure (GtkCssGadget *gadget,
|
||
GtkOrientation orientation,
|
||
int for_size,
|
||
int *minimum,
|
||
int *natural,
|
||
int *minimum_baseline,
|
||
int *natural_baseline,
|
||
gpointer data)
|
||
{
|
||
GtkWidget *widget;
|
||
GtkFrame *frame;
|
||
GtkFramePrivate *priv;
|
||
gint child_min, child_nat;
|
||
|
||
widget = gtk_css_gadget_get_owner (gadget);
|
||
frame = GTK_FRAME (widget);
|
||
priv = frame->priv;
|
||
|
||
gtk_css_gadget_get_preferred_size (priv->border_gadget,
|
||
orientation,
|
||
for_size,
|
||
&child_min,
|
||
&child_nat,
|
||
NULL, NULL);
|
||
|
||
*minimum = child_min;
|
||
*natural = child_nat;
|
||
|
||
if (priv->label_widget && gtk_widget_get_visible (priv->label_widget))
|
||
{
|
||
if (orientation == GTK_ORIENTATION_HORIZONTAL)
|
||
{
|
||
gtk_widget_get_preferred_width (priv->label_widget, &child_min, &child_nat);
|
||
*minimum = MAX (child_min, *minimum);
|
||
*natural = MAX (child_nat, *natural);
|
||
}
|
||
else
|
||
{
|
||
gtk_widget_measure (priv->label_widget, orientation, for_size, &child_min, &child_nat, NULL, NULL);
|
||
|
||
*minimum += child_min;
|
||
*natural += child_nat;
|
||
}
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_frame_measure_border (GtkCssGadget *gadget,
|
||
GtkOrientation orientation,
|
||
int for_size,
|
||
int *minimum,
|
||
int *natural,
|
||
int *minimum_baseline,
|
||
int *natural_baseline,
|
||
gpointer data)
|
||
{
|
||
GtkWidget *widget = gtk_css_gadget_get_owner (gadget);
|
||
GtkWidget *child;
|
||
int child_min, child_nat;
|
||
|
||
child = gtk_bin_get_child (GTK_BIN (widget));
|
||
if (child && gtk_widget_get_visible (child))
|
||
{
|
||
if (orientation == GTK_ORIENTATION_HORIZONTAL)
|
||
{
|
||
gtk_widget_get_preferred_width (child, &child_min, &child_nat);
|
||
}
|
||
else
|
||
{
|
||
if (for_size > 0)
|
||
gtk_widget_get_preferred_height_for_width (child, for_size, &child_min, &child_nat);
|
||
else
|
||
gtk_widget_get_preferred_height (child, &child_min, &child_nat);
|
||
}
|
||
|
||
*minimum = child_min;
|
||
*natural = child_nat;
|
||
}
|
||
else
|
||
{
|
||
*minimum = 0;
|
||
*natural = 0;
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_frame_measure_ (GtkWidget *widget,
|
||
GtkOrientation orientation,
|
||
gint for_size,
|
||
gint *minimum,
|
||
gint *natural,
|
||
gint *minimum_baseline,
|
||
gint *natural_baseline)
|
||
{
|
||
gtk_css_gadget_get_preferred_size (GTK_FRAME (widget)->priv->gadget,
|
||
orientation,
|
||
for_size,
|
||
minimum, natural,
|
||
minimum_baseline, natural_baseline);
|
||
}
|
||
|
||
static void
|
||
gtk_frame_state_flags_changed (GtkWidget *widget,
|
||
GtkStateFlags previous_state)
|
||
{
|
||
gtk_css_gadget_set_state (GTK_FRAME (widget)->priv->border_gadget, gtk_widget_get_state_flags (widget));
|
||
|
||
GTK_WIDGET_CLASS (gtk_frame_parent_class)->state_flags_changed (widget, previous_state);
|
||
}
|