Cppcheck report - ctk (cppcheck 2.15.0-1): ctk/deprecated/ctkmisc.c

/* CTK - 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 CTK+ Team and others 1997-2000.  See the AUTHORS
 * file for a list of people on the CTK+ Team.  See the ChangeLog
 * files for a list of changes.  These files are distributed with
 * CTK+ at ftp://ftp.ctk.org/pub/ctk/. 
 */

#include "config.h"
#include "ctkcontainer.h"
#include "ctkmisc.h"
#include "ctklabel.h"
#include "ctkintl.h"
#include "ctkprivate.h"


G_GNUC_BEGIN_IGNORE_DEPRECATIONS

/**
 * SECTION:ctkmisc
 * @Short_description: Base class for widgets with alignments and padding
 * @Title: CtkMisc
 *
 * The #CtkMisc widget is an abstract widget which is not useful itself, but
 * is used to derive subclasses which have alignment and padding attributes.
 *
 * The horizontal and vertical padding attributes allows extra space to be
 * added around the widget.
 *
 * The horizontal and vertical alignment attributes enable the widget to be
 * positioned within its allocated area. Note that if the widget is added to
 * a container in such a way that it expands automatically to fill its
 * allocated area, the alignment settings will not alter the widget's position.
 *
 * Note that the desired effect can in most cases be achieved by using the
 * #CtkWidget:halign, #CtkWidget:valign and #CtkWidget:margin properties
 * on the child widget, so CtkMisc should not be used in new code. To reflect
 * this fact, all #CtkMisc API has been deprecated.
 */

struct _CtkMiscPrivate
{
  gfloat        xalign;
  gfloat        yalign;

  guint16       xpad;
  guint16       ypad;
};

enum {
  PROP_0,
  PROP_XALIGN,
  PROP_YALIGN,
  PROP_XPAD,
  PROP_YPAD
};

static void ctk_misc_realize      (CtkWidget    *widget);
static void ctk_misc_set_property (GObject         *object,
				   guint            prop_id,
				   const GValue    *value,
				   GParamSpec      *pspec);
static void ctk_misc_get_property (GObject         *object,
				   guint            prop_id,
				   GValue          *value,
				   GParamSpec      *pspec);


G_DEFINE_ABSTRACT_TYPE_WITH_PRIVATE (CtkMisc, ctk_misc, CTK_TYPE_WIDGET)<--- There is an unknown macro here somewhere. Configuration is required. If G_DEFINE_ABSTRACT_TYPE_WITH_PRIVATE is a macro then please configure it.

static void
ctk_misc_class_init (CtkMiscClass *class)
{
  GObjectClass   *gobject_class;
  CtkWidgetClass *widget_class;

  gobject_class = G_OBJECT_CLASS (class);
  widget_class = (CtkWidgetClass*) class;

  gobject_class->set_property = ctk_misc_set_property;
  gobject_class->get_property = ctk_misc_get_property;
  
  widget_class->realize = ctk_misc_realize;

  /**
   * CtkMisc:xalign:
   *
   * The horizontal alignment. A value of 0.0 means left alignment (or right
   * on RTL locales); a value of 1.0 means right alignment (or left on RTL
   * locales).
   *
   * Deprecated: 3.14: Use ctk_widget_set_halign() instead. If you are using
   *   #CtkLabel, use #CtkLabel:xalign instead.
   */
  g_object_class_install_property (gobject_class,
                                   PROP_XALIGN,
                                   g_param_spec_float ("xalign",
						       P_("X align"),
						       P_("The horizontal alignment, from 0 (left) to 1 (right). Reversed for RTL layouts."),
						       0.0,
						       1.0,
						       0.5,
						       CTK_PARAM_READWRITE|G_PARAM_DEPRECATED));

  /**
   * CtkMisc:yalign:
   *
   * The vertical alignment. A value of 0.0 means top alignment;
   * a value of 1.0 means bottom alignment.
   *
   * Deprecated: 3.14: Use ctk_widget_set_valign() instead. If you are using
   *   #CtkLabel, use #CtkLabel:yalign instead.
   */
  g_object_class_install_property (gobject_class,
                                   PROP_YALIGN,
                                   g_param_spec_float ("yalign",
						       P_("Y align"),
						       P_("The vertical alignment, from 0 (top) to 1 (bottom)"),
						       0.0,
						       1.0,
						       0.5,
						       CTK_PARAM_READWRITE|G_PARAM_DEPRECATED));

  /**
   * CtkMisc:xpad:
   *
   * The amount of space to add on the left and right of the widget, in
   * pixels.
   *
   * Deprecated: 3.14: Use ctk_widget_set_margin_start() and
   *   ctk_widget_set_margin_end() instead
   */
  g_object_class_install_property (gobject_class,
                                   PROP_XPAD,
                                   g_param_spec_int ("xpad",
						     P_("X pad"),
						     P_("The amount of space to add on the left and right of the widget, in pixels"),
						     0,
						     G_MAXINT,
						     0,
						     CTK_PARAM_READWRITE|G_PARAM_DEPRECATED));

  /**
   * CtkMisc:ypad:
   *
   * The amount of space to add on the top and bottom of the widget, in
   * pixels.
   *
   * Deprecated: 3.14: Use ctk_widget_set_margin_top() and
   *   ctk_widget_set_margin_bottom() instead
   */
  g_object_class_install_property (gobject_class,
                                   PROP_YPAD,
                                   g_param_spec_int ("ypad",
						     P_("Y pad"),
						     P_("The amount of space to add on the top and bottom of the widget, in pixels"),
						     0,
						     G_MAXINT,
						     0,
						     CTK_PARAM_READWRITE|G_PARAM_DEPRECATED));
}

static void
ctk_misc_init (CtkMisc *misc)
{
  CtkMiscPrivate *priv;

  misc->priv = ctk_misc_get_instance_private (misc); 
  priv = misc->priv;

  priv->xalign = 0.5;
  priv->yalign = 0.5;
  priv->xpad = 0;
  priv->ypad = 0;
}

static void
ctk_misc_set_property (GObject      *object,
		       guint         prop_id,
		       const GValue *value,
		       GParamSpec   *pspec)
{
  CtkMisc *misc = CTK_MISC (object);
  CtkMiscPrivate *priv = misc->priv;

  switch (prop_id)
    {
    case PROP_XALIGN:
      ctk_misc_set_alignment (misc, g_value_get_float (value), priv->yalign);
      break;
    case PROP_YALIGN:
      ctk_misc_set_alignment (misc, priv->xalign, g_value_get_float (value));
      break;
    case PROP_XPAD:
      ctk_misc_set_padding (misc, g_value_get_int (value), priv->ypad);
      break;
    case PROP_YPAD:
      ctk_misc_set_padding (misc, priv->xpad, g_value_get_int (value));
      break;
    default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
      break;
    }
}

static void
ctk_misc_get_property (GObject      *object,
		       guint         prop_id,
		       GValue       *value,
		       GParamSpec   *pspec)
{
  CtkMisc *misc = CTK_MISC (object);
  CtkMiscPrivate *priv = misc->priv;

  switch (prop_id)
    {
    case PROP_XALIGN:
      g_value_set_float (value, priv->xalign);
      break;
    case PROP_YALIGN:
      g_value_set_float (value, priv->yalign);
      break;
    case PROP_XPAD:
      g_value_set_int (value, priv->xpad);
      break;
    case PROP_YPAD:
      g_value_set_int (value, priv->ypad);
      break;
    default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
      break;
    }
}

/**
 * ctk_misc_set_alignment:
 * @misc: a #CtkMisc.
 * @xalign: the horizontal alignment, from 0 (left) to 1 (right).
 * @yalign: the vertical alignment, from 0 (top) to 1 (bottom).
 *
 * Sets the alignment of the widget.
 *
 * Deprecated: 3.14: Use #CtkWidget's alignment (#CtkWidget:halign and #CtkWidget:valign) and margin properties or #CtkLabel's #CtkLabel:xalign and #CtkLabel:yalign properties.
 */
void
ctk_misc_set_alignment (CtkMisc *misc,
			gfloat   xalign,
			gfloat   yalign)
{
  CtkMiscPrivate *priv;

  g_return_if_fail (CTK_IS_MISC (misc));

  priv = misc->priv;

  if (xalign < 0.0)
    xalign = 0.0;
  else if (xalign > 1.0)
    xalign = 1.0;

  if (yalign < 0.0)
    yalign = 0.0;
  else if (yalign > 1.0)
    yalign = 1.0;

  if ((xalign != priv->xalign) || (yalign != priv->yalign))
    {
      CtkWidget *widget;

      g_object_freeze_notify (G_OBJECT (misc));
      if (xalign != priv->xalign)
	g_object_notify (G_OBJECT (misc), "xalign");

      if (yalign != priv->yalign)
	g_object_notify (G_OBJECT (misc), "yalign");

      priv->xalign = xalign;
      priv->yalign = yalign;
      
      if (CTK_IS_LABEL (misc))
        {
          ctk_label_set_xalign (CTK_LABEL (misc), xalign);
          ctk_label_set_yalign (CTK_LABEL (misc), yalign);
        }

      /* clear the area that was allocated before the change
       */
      widget = CTK_WIDGET (misc);
      if (ctk_widget_is_drawable (widget))
        ctk_widget_queue_draw (widget);

      g_object_thaw_notify (G_OBJECT (misc));
    }
}

/**
 * ctk_misc_get_alignment:
 * @misc: a #CtkMisc
 * @xalign: (out) (allow-none): location to store X alignment of @misc, or %NULL
 * @yalign: (out) (allow-none): location to store Y alignment of @misc, or %NULL
 *
 * Gets the X and Y alignment of the widget within its allocation. 
 * See ctk_misc_set_alignment().
 *
 * Deprecated: 3.14: Use #CtkWidget alignment and margin properties.
 **/
void
ctk_misc_get_alignment (CtkMisc *misc,
		        gfloat  *xalign,
			gfloat  *yalign)
{
  CtkMiscPrivate *priv;

  g_return_if_fail (CTK_IS_MISC (misc));

  priv = misc->priv;

  if (xalign)
    *xalign = priv->xalign;
  if (yalign)
    *yalign = priv->yalign;
}

/**
 * ctk_misc_set_padding:
 * @misc: a #CtkMisc.
 * @xpad: the amount of space to add on the left and right of the widget,
 *   in pixels.
 * @ypad: the amount of space to add on the top and bottom of the widget,
 *   in pixels.
 *
 * Sets the amount of space to add around the widget.
 *
 * Deprecated: 3.14: Use #CtkWidget alignment and margin properties.
 */
void
ctk_misc_set_padding (CtkMisc *misc,
		      gint     xpad,
		      gint     ypad)
{
  CtkMiscPrivate *priv;

  g_return_if_fail (CTK_IS_MISC (misc));

  priv = misc->priv;

  if (xpad < 0)
    xpad = 0;
  if (ypad < 0)
    ypad = 0;

  if ((xpad != priv->xpad) || (ypad != priv->ypad))
    {
      g_object_freeze_notify (G_OBJECT (misc));
      if (xpad != priv->xpad)
	g_object_notify (G_OBJECT (misc), "xpad");

      if (ypad != priv->ypad)
	g_object_notify (G_OBJECT (misc), "ypad");

      priv->xpad = xpad;
      priv->ypad = ypad;

      if (ctk_widget_is_drawable (CTK_WIDGET (misc)))
	ctk_widget_queue_resize (CTK_WIDGET (misc));

      g_object_thaw_notify (G_OBJECT (misc));
    }
}

/**
 * ctk_misc_get_padding:
 * @misc: a #CtkMisc
 * @xpad: (out) (allow-none): location to store padding in the X
 *        direction, or %NULL
 * @ypad: (out) (allow-none): location to store padding in the Y
 *        direction, or %NULL
 *
 * Gets the padding in the X and Y directions of the widget. 
 * See ctk_misc_set_padding().
 *
 * Deprecated: 3.14: Use #CtkWidget alignment and margin properties.
 **/
void
ctk_misc_get_padding (CtkMisc *misc,
		      gint    *xpad,
		      gint    *ypad)
{
  CtkMiscPrivate *priv;

  g_return_if_fail (CTK_IS_MISC (misc));

  priv = misc->priv;

  if (xpad)
    *xpad = priv->xpad;
  if (ypad)
    *ypad = priv->ypad;
}

static void
ctk_misc_realize (CtkWidget *widget)
{
  CtkAllocation allocation;
  CdkWindow *window;
  CdkWindowAttr attributes;
  gint attributes_mask;

  ctk_widget_set_realized (widget, TRUE);

  if (!ctk_widget_get_has_window (widget))
    {
      window = ctk_widget_get_parent_window (widget);
      ctk_widget_set_window (widget, window);
      g_object_ref (window);
    }
  else
    {
      ctk_widget_get_allocation (widget, &allocation);

      attributes.window_type = CDK_WINDOW_CHILD;
      attributes.x = allocation.x;
      attributes.y = allocation.y;
      attributes.width = allocation.width;
      attributes.height = allocation.height;
      attributes.wclass = CDK_INPUT_OUTPUT;
      attributes.visual = ctk_widget_get_visual (widget);
      attributes.event_mask = ctk_widget_get_events (widget);
      attributes_mask = CDK_WA_X | CDK_WA_Y | CDK_WA_VISUAL;

      window = cdk_window_new (ctk_widget_get_parent_window (widget), &attributes, attributes_mask);
      ctk_widget_set_window (widget, window);
      ctk_widget_register_window (widget, window);
      cdk_window_set_background_pattern (window, NULL);
    }
}

/* Semi-private function used by ctk widgets inheriting from
 * CtkMisc that takes into account both css padding and border
 * and the padding specified with the CtkMisc properties.
 */
void
_ctk_misc_get_padding_and_border (CtkMisc   *misc,
                                  CtkBorder *border)
{
  CtkStyleContext *context;
  CtkStateFlags state;
  CtkBorder tmp;
  gint xpad, ypad;

  g_return_if_fail (CTK_IS_MISC (misc));

  context = ctk_widget_get_style_context (CTK_WIDGET (misc));
  state = ctk_widget_get_state_flags (CTK_WIDGET (misc));

  ctk_style_context_get_padding (context, state, border);

  ctk_misc_get_padding (misc, &xpad, &ypad);
  border->top += ypad;
  border->left += xpad;
  border->bottom += ypad;
  border->right += xpad;

  ctk_style_context_get_border (context, state, &tmp);
  border->top += tmp.top;
  border->right += tmp.right;
  border->bottom += tmp.bottom;
  border->left += tmp.left;
}