forked from AuroraMiddleware/gtk
3377dc7d40
GtkBox is not going away, so there's not point in making things more confusing for those who are still porting their code from GTK2 to GTK3 10 years after GTK 3.0 was released. Fixes: #3854
105 lines
3.3 KiB
C
105 lines
3.3 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 "gtkboxprivate.h"
|
||
#include "gtkorientable.h"
|
||
|
||
#include "gtkvbox.h"
|
||
#include "gtkboxprivate.h"
|
||
|
||
G_GNUC_BEGIN_IGNORE_DEPRECATIONS
|
||
|
||
/**
|
||
* SECTION:gtkvbox
|
||
* @Short_description: A vertical container box
|
||
* @Title: GtkVBox
|
||
* @See_also: #GtkHBox
|
||
*
|
||
* A #GtkVBox is a container that organizes child widgets into a single column.
|
||
*
|
||
* Use the #GtkBox packing interface to determine the arrangement,
|
||
* spacing, height, and alignment of #GtkVBox children.
|
||
*
|
||
* All children are allocated the same width.
|
||
*
|
||
* GtkVBox has been deprecated. You can use #GtkBox with a #GtkOrientable:orientation
|
||
* set to %GTK_ORIENTATION_VERTICAL instead when calling gtk_box_new(),
|
||
* which is a very quick and easy change.
|
||
*
|
||
* If you have derived your own classes from GtkVBox, you can change the
|
||
* inheritance to derive directly from #GtkBox, and set the #GtkOrientable:orientation
|
||
* property to %GTK_ORIENTATION_VERTICAL in your instance init function,
|
||
* with a call like:
|
||
*
|
||
* |[<!-- language="C" -->
|
||
* gtk_orientable_set_orientation (GTK_ORIENTABLE (object),
|
||
* GTK_ORIENTATION_VERTICAL);
|
||
* ]|
|
||
*
|
||
* If you have a grid-like layout composed of nested boxes, and you don’t
|
||
* need first-child or last-child styling, the recommendation is to switch
|
||
* to #GtkGrid. For more information about migrating to #GtkGrid, see
|
||
* [Migrating from other containers to GtkGrid][gtk-migrating-GtkGrid].
|
||
*/
|
||
|
||
G_DEFINE_TYPE (GtkVBox, gtk_vbox, GTK_TYPE_BOX)
|
||
|
||
static void
|
||
gtk_vbox_class_init (GtkVBoxClass *class)
|
||
{
|
||
}
|
||
|
||
static void
|
||
gtk_vbox_init (GtkVBox *vbox)
|
||
{
|
||
gtk_orientable_set_orientation (GTK_ORIENTABLE (vbox),
|
||
GTK_ORIENTATION_VERTICAL);
|
||
|
||
_gtk_box_set_old_defaults (GTK_BOX (vbox));
|
||
}
|
||
|
||
/**
|
||
* gtk_vbox_new:
|
||
* @homogeneous: %TRUE if all children are to be given equal space allotments.
|
||
* @spacing: the number of pixels to place by default between children.
|
||
*
|
||
* Creates a new #GtkVBox.
|
||
*
|
||
* Returns: a new #GtkVBox.
|
||
*
|
||
* Deprecated: 3.2: You should use gtk_box_new() with a %GTK_ORIENTATION_VERTICAL
|
||
* #GtkOrientable:orientation instead
|
||
*/
|
||
GtkWidget *
|
||
gtk_vbox_new (gboolean homogeneous,
|
||
gint spacing)
|
||
{
|
||
return g_object_new (GTK_TYPE_VBOX,
|
||
"spacing", spacing,
|
||
"homogeneous", homogeneous ? TRUE : FALSE,
|
||
NULL);
|
||
}
|