forked from AuroraMiddleware/gtk
1995 lines
55 KiB
C
1995 lines
55 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"
|
|
|
|
#define GDK_DISABLE_DEPRECATION_WARNINGS
|
|
|
|
#include "gtktable.h"
|
|
|
|
#include "gtktypebuiltins.h"
|
|
#include "gtkprivate.h"
|
|
#include "gtkintl.h"
|
|
|
|
|
|
/**
|
|
* SECTION:gtktable
|
|
* @Short_description: Pack widgets in regular patterns
|
|
* @Title: GtkTable
|
|
* @See_also: #GtkGrid
|
|
*
|
|
* The #GtkTable functions allow the programmer to arrange widgets in rows and
|
|
* columns, making it easy to align many widgets next to each other,
|
|
* horizontally and vertically.
|
|
*
|
|
* Tables are created with a call to gtk_table_new(), the size of which can
|
|
* later be changed with gtk_table_resize().
|
|
*
|
|
* Widgets can be added to a table using gtk_table_attach() or the more
|
|
* convenient (but slightly less flexible) gtk_table_attach_defaults().
|
|
*
|
|
* To alter the space next to a specific row, use gtk_table_set_row_spacing(),
|
|
* and for a column, gtk_table_set_col_spacing().
|
|
* The gaps between all rows or columns can be changed by
|
|
* calling gtk_table_set_row_spacings() or gtk_table_set_col_spacings()
|
|
* respectively. Note that spacing is added between the
|
|
* children, while padding added by gtk_table_attach() is added on
|
|
* either side of the widget it belongs to.
|
|
*
|
|
* gtk_table_set_homogeneous(), can be used to set whether all cells in the
|
|
* table will resize themselves to the size of the largest widget in the table.
|
|
*
|
|
* <note>
|
|
* #GtkTable has been deprecated. Use #GtkGrid instead. It provides the same
|
|
* capabilities as GtkTable for arranging widgets in a rectangular grid, but
|
|
* does support height-for-width geometry management.
|
|
* </note>
|
|
*/
|
|
|
|
|
|
struct _GtkTablePrivate
|
|
{
|
|
GtkTableRowCol *cols;
|
|
GtkTableRowCol *rows;
|
|
|
|
GList *children;
|
|
|
|
guint16 column_spacing;
|
|
guint16 ncols;
|
|
guint16 nrows;
|
|
guint16 row_spacing;
|
|
|
|
guint homogeneous : 1;
|
|
};
|
|
|
|
enum
|
|
{
|
|
PROP_0,
|
|
PROP_N_ROWS,
|
|
PROP_N_COLUMNS,
|
|
PROP_COLUMN_SPACING,
|
|
PROP_ROW_SPACING,
|
|
PROP_HOMOGENEOUS
|
|
};
|
|
|
|
enum
|
|
{
|
|
CHILD_PROP_0,
|
|
CHILD_PROP_LEFT_ATTACH,
|
|
CHILD_PROP_RIGHT_ATTACH,
|
|
CHILD_PROP_TOP_ATTACH,
|
|
CHILD_PROP_BOTTOM_ATTACH,
|
|
CHILD_PROP_X_OPTIONS,
|
|
CHILD_PROP_Y_OPTIONS,
|
|
CHILD_PROP_X_PADDING,
|
|
CHILD_PROP_Y_PADDING
|
|
};
|
|
|
|
|
|
static void gtk_table_finalize (GObject *object);
|
|
static void gtk_table_get_preferred_width (GtkWidget *widget,
|
|
gint *minimum,
|
|
gint *natural);
|
|
static void gtk_table_get_preferred_height (GtkWidget *widget,
|
|
gint *minimum,
|
|
gint *natural);
|
|
static void gtk_table_size_allocate (GtkWidget *widget,
|
|
GtkAllocation *allocation);
|
|
static void gtk_table_compute_expand (GtkWidget *widget,
|
|
gboolean *hexpand,
|
|
gboolean *vexpand);
|
|
static void gtk_table_add (GtkContainer *container,
|
|
GtkWidget *widget);
|
|
static void gtk_table_remove (GtkContainer *container,
|
|
GtkWidget *widget);
|
|
static void gtk_table_forall (GtkContainer *container,
|
|
gboolean include_internals,
|
|
GtkCallback callback,
|
|
gpointer callback_data);
|
|
static void gtk_table_get_property (GObject *object,
|
|
guint prop_id,
|
|
GValue *value,
|
|
GParamSpec *pspec);
|
|
static void gtk_table_set_property (GObject *object,
|
|
guint prop_id,
|
|
const GValue *value,
|
|
GParamSpec *pspec);
|
|
static void gtk_table_set_child_property (GtkContainer *container,
|
|
GtkWidget *child,
|
|
guint property_id,
|
|
const GValue *value,
|
|
GParamSpec *pspec);
|
|
static void gtk_table_get_child_property (GtkContainer *container,
|
|
GtkWidget *child,
|
|
guint property_id,
|
|
GValue *value,
|
|
GParamSpec *pspec);
|
|
static GType gtk_table_child_type (GtkContainer *container);
|
|
|
|
|
|
static void gtk_table_size_request_init (GtkTable *table);
|
|
static void gtk_table_size_request_pass1 (GtkTable *table);
|
|
static void gtk_table_size_request_pass2 (GtkTable *table);
|
|
static void gtk_table_size_request_pass3 (GtkTable *table);
|
|
|
|
static void gtk_table_size_allocate_init (GtkTable *table);
|
|
static void gtk_table_size_allocate_pass1 (GtkTable *table);
|
|
static void gtk_table_size_allocate_pass2 (GtkTable *table);
|
|
|
|
|
|
G_DEFINE_TYPE_WITH_PRIVATE (GtkTable, gtk_table, GTK_TYPE_CONTAINER)
|
|
|
|
static void
|
|
gtk_table_class_init (GtkTableClass *class)
|
|
{
|
|
GObjectClass *gobject_class = G_OBJECT_CLASS (class);
|
|
GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (class);
|
|
GtkContainerClass *container_class = GTK_CONTAINER_CLASS (class);
|
|
|
|
gobject_class->finalize = gtk_table_finalize;
|
|
|
|
gobject_class->get_property = gtk_table_get_property;
|
|
gobject_class->set_property = gtk_table_set_property;
|
|
|
|
widget_class->get_preferred_width = gtk_table_get_preferred_width;
|
|
widget_class->get_preferred_height = gtk_table_get_preferred_height;
|
|
widget_class->size_allocate = gtk_table_size_allocate;
|
|
widget_class->compute_expand = gtk_table_compute_expand;
|
|
|
|
container_class->add = gtk_table_add;
|
|
container_class->remove = gtk_table_remove;
|
|
container_class->forall = gtk_table_forall;
|
|
container_class->child_type = gtk_table_child_type;
|
|
container_class->set_child_property = gtk_table_set_child_property;
|
|
container_class->get_child_property = gtk_table_get_child_property;
|
|
gtk_container_class_handle_border_width (container_class);
|
|
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_N_ROWS,
|
|
g_param_spec_uint ("n-rows",
|
|
P_("Rows"),
|
|
P_("The number of rows in the table"),
|
|
1,
|
|
65535,
|
|
1,
|
|
GTK_PARAM_READWRITE));
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_N_COLUMNS,
|
|
g_param_spec_uint ("n-columns",
|
|
P_("Columns"),
|
|
P_("The number of columns in the table"),
|
|
1,
|
|
65535,
|
|
1,
|
|
GTK_PARAM_READWRITE));
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_ROW_SPACING,
|
|
g_param_spec_uint ("row-spacing",
|
|
P_("Row spacing"),
|
|
P_("The amount of space between two consecutive rows"),
|
|
0,
|
|
65535,
|
|
0,
|
|
GTK_PARAM_READWRITE));
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_COLUMN_SPACING,
|
|
g_param_spec_uint ("column-spacing",
|
|
P_("Column spacing"),
|
|
P_("The amount of space between two consecutive columns"),
|
|
0,
|
|
65535,
|
|
0,
|
|
GTK_PARAM_READWRITE));
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_HOMOGENEOUS,
|
|
g_param_spec_boolean ("homogeneous",
|
|
P_("Homogeneous"),
|
|
P_("If TRUE, the table cells are all the same width/height"),
|
|
FALSE,
|
|
GTK_PARAM_READWRITE));
|
|
|
|
gtk_container_class_install_child_property (container_class,
|
|
CHILD_PROP_LEFT_ATTACH,
|
|
g_param_spec_uint ("left-attach",
|
|
P_("Left attachment"),
|
|
P_("The column number to attach the left side of the child to"),
|
|
0, 65535, 0,
|
|
GTK_PARAM_READWRITE));
|
|
gtk_container_class_install_child_property (container_class,
|
|
CHILD_PROP_RIGHT_ATTACH,
|
|
g_param_spec_uint ("right-attach",
|
|
P_("Right attachment"),
|
|
P_("The column number to attach the right side of a child widget to"),
|
|
1, 65535, 1,
|
|
GTK_PARAM_READWRITE));
|
|
gtk_container_class_install_child_property (container_class,
|
|
CHILD_PROP_TOP_ATTACH,
|
|
g_param_spec_uint ("top-attach",
|
|
P_("Top attachment"),
|
|
P_("The row number to attach the top of a child widget to"),
|
|
0, 65535, 0,
|
|
GTK_PARAM_READWRITE));
|
|
gtk_container_class_install_child_property (container_class,
|
|
CHILD_PROP_BOTTOM_ATTACH,
|
|
g_param_spec_uint ("bottom-attach",
|
|
P_("Bottom attachment"),
|
|
P_("The row number to attach the bottom of the child to"),
|
|
1, 65535, 1,
|
|
GTK_PARAM_READWRITE));
|
|
gtk_container_class_install_child_property (container_class,
|
|
CHILD_PROP_X_OPTIONS,
|
|
g_param_spec_flags ("x-options",
|
|
P_("Horizontal options"),
|
|
P_("Options specifying the horizontal behaviour of the child"),
|
|
GTK_TYPE_ATTACH_OPTIONS, GTK_EXPAND | GTK_FILL,
|
|
GTK_PARAM_READWRITE));
|
|
gtk_container_class_install_child_property (container_class,
|
|
CHILD_PROP_Y_OPTIONS,
|
|
g_param_spec_flags ("y-options",
|
|
P_("Vertical options"),
|
|
P_("Options specifying the vertical behaviour of the child"),
|
|
GTK_TYPE_ATTACH_OPTIONS, GTK_EXPAND | GTK_FILL,
|
|
GTK_PARAM_READWRITE));
|
|
gtk_container_class_install_child_property (container_class,
|
|
CHILD_PROP_X_PADDING,
|
|
g_param_spec_uint ("x-padding",
|
|
P_("Horizontal padding"),
|
|
P_("Extra space to put between the child and its left and right neighbors, in pixels"),
|
|
0, 65535, 0,
|
|
GTK_PARAM_READWRITE));
|
|
gtk_container_class_install_child_property (container_class,
|
|
CHILD_PROP_Y_PADDING,
|
|
g_param_spec_uint ("y-padding",
|
|
P_("Vertical padding"),
|
|
P_("Extra space to put between the child and its upper and lower neighbors, in pixels"),
|
|
0, 65535, 0,
|
|
GTK_PARAM_READWRITE));
|
|
}
|
|
|
|
static void
|
|
gtk_table_compute_expand (GtkWidget *widget,
|
|
gboolean *hexpand_p,
|
|
gboolean *vexpand_p)
|
|
{
|
|
GtkTable *table = GTK_TABLE (widget);
|
|
GtkTablePrivate *priv = table->priv;
|
|
GList *list;
|
|
GtkTableChild *child;
|
|
gboolean hexpand;
|
|
gboolean vexpand;
|
|
|
|
hexpand = FALSE;
|
|
vexpand = FALSE;
|
|
|
|
for (list = priv->children; list; list = list->next)
|
|
{
|
|
child = list->data;
|
|
|
|
if (!hexpand)
|
|
hexpand = child->xexpand ||
|
|
gtk_widget_compute_expand (child->widget,
|
|
GTK_ORIENTATION_HORIZONTAL);
|
|
|
|
if (!vexpand)
|
|
vexpand = child->yexpand ||
|
|
gtk_widget_compute_expand (child->widget,
|
|
GTK_ORIENTATION_VERTICAL);
|
|
|
|
if (hexpand && vexpand)
|
|
break;
|
|
}
|
|
|
|
*hexpand_p = hexpand;
|
|
*vexpand_p = vexpand;
|
|
}
|
|
|
|
static GType
|
|
gtk_table_child_type (GtkContainer *container)
|
|
{
|
|
return GTK_TYPE_WIDGET;
|
|
}
|
|
|
|
static void
|
|
gtk_table_get_property (GObject *object,
|
|
guint prop_id,
|
|
GValue *value,
|
|
GParamSpec *pspec)
|
|
{
|
|
GtkTable *table = GTK_TABLE (object);
|
|
GtkTablePrivate *priv = table->priv;
|
|
|
|
switch (prop_id)
|
|
{
|
|
case PROP_N_ROWS:
|
|
g_value_set_uint (value, priv->nrows);
|
|
break;
|
|
case PROP_N_COLUMNS:
|
|
g_value_set_uint (value, priv->ncols);
|
|
break;
|
|
case PROP_ROW_SPACING:
|
|
g_value_set_uint (value, priv->row_spacing);
|
|
break;
|
|
case PROP_COLUMN_SPACING:
|
|
g_value_set_uint (value, priv->column_spacing);
|
|
break;
|
|
case PROP_HOMOGENEOUS:
|
|
g_value_set_boolean (value, priv->homogeneous);
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_table_set_property (GObject *object,
|
|
guint prop_id,
|
|
const GValue *value,
|
|
GParamSpec *pspec)
|
|
{
|
|
GtkTable *table = GTK_TABLE (object);
|
|
GtkTablePrivate *priv = table->priv;
|
|
|
|
switch (prop_id)
|
|
{
|
|
case PROP_N_ROWS:
|
|
gtk_table_resize (table, g_value_get_uint (value), priv->ncols);
|
|
break;
|
|
case PROP_N_COLUMNS:
|
|
gtk_table_resize (table, priv->nrows, g_value_get_uint (value));
|
|
break;
|
|
case PROP_ROW_SPACING:
|
|
gtk_table_set_row_spacings (table, g_value_get_uint (value));
|
|
break;
|
|
case PROP_COLUMN_SPACING:
|
|
gtk_table_set_col_spacings (table, g_value_get_uint (value));
|
|
break;
|
|
case PROP_HOMOGENEOUS:
|
|
gtk_table_set_homogeneous (table, g_value_get_boolean (value));
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_table_set_child_property (GtkContainer *container,
|
|
GtkWidget *child,
|
|
guint property_id,
|
|
const GValue *value,
|
|
GParamSpec *pspec)
|
|
{
|
|
GtkTable *table = GTK_TABLE (container);
|
|
GtkTablePrivate *priv = table->priv;
|
|
GtkTableChild *table_child;
|
|
GList *list;
|
|
|
|
table_child = NULL;
|
|
for (list = priv->children; list; list = list->next)
|
|
{
|
|
table_child = list->data;
|
|
|
|
if (table_child->widget == child)
|
|
break;
|
|
}
|
|
if (!list)
|
|
{
|
|
GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, property_id, pspec);
|
|
return;
|
|
}
|
|
|
|
switch (property_id)
|
|
{
|
|
case CHILD_PROP_LEFT_ATTACH:
|
|
table_child->left_attach = g_value_get_uint (value);
|
|
if (table_child->right_attach <= table_child->left_attach)
|
|
table_child->right_attach = table_child->left_attach + 1;
|
|
if (table_child->right_attach >= priv->ncols)
|
|
gtk_table_resize (table, priv->nrows, table_child->right_attach);
|
|
break;
|
|
case CHILD_PROP_RIGHT_ATTACH:
|
|
table_child->right_attach = g_value_get_uint (value);
|
|
if (table_child->right_attach <= table_child->left_attach)
|
|
table_child->left_attach = table_child->right_attach - 1;
|
|
if (table_child->right_attach >= priv->ncols)
|
|
gtk_table_resize (table, priv->nrows, table_child->right_attach);
|
|
break;
|
|
case CHILD_PROP_TOP_ATTACH:
|
|
table_child->top_attach = g_value_get_uint (value);
|
|
if (table_child->bottom_attach <= table_child->top_attach)
|
|
table_child->bottom_attach = table_child->top_attach + 1;
|
|
if (table_child->bottom_attach >= priv->nrows)
|
|
gtk_table_resize (table, table_child->bottom_attach, priv->ncols);
|
|
break;
|
|
case CHILD_PROP_BOTTOM_ATTACH:
|
|
table_child->bottom_attach = g_value_get_uint (value);
|
|
if (table_child->bottom_attach <= table_child->top_attach)
|
|
table_child->top_attach = table_child->bottom_attach - 1;
|
|
if (table_child->bottom_attach >= priv->nrows)
|
|
gtk_table_resize (table, table_child->bottom_attach, priv->ncols);
|
|
break;
|
|
case CHILD_PROP_X_OPTIONS:
|
|
{
|
|
gboolean xexpand;
|
|
|
|
xexpand = (g_value_get_flags (value) & GTK_EXPAND) != 0;
|
|
|
|
if (table_child->xexpand != xexpand)
|
|
{
|
|
table_child->xexpand = xexpand;
|
|
gtk_widget_queue_compute_expand (GTK_WIDGET (table));
|
|
}
|
|
|
|
table_child->xshrink = (g_value_get_flags (value) & GTK_SHRINK) != 0;
|
|
table_child->xfill = (g_value_get_flags (value) & GTK_FILL) != 0;
|
|
}
|
|
break;
|
|
case CHILD_PROP_Y_OPTIONS:
|
|
{
|
|
gboolean yexpand;
|
|
|
|
yexpand = (g_value_get_flags (value) & GTK_EXPAND) != 0;
|
|
|
|
if (table_child->yexpand != yexpand)
|
|
{
|
|
table_child->yexpand = yexpand;
|
|
gtk_widget_queue_compute_expand (GTK_WIDGET (table));
|
|
}
|
|
|
|
table_child->yshrink = (g_value_get_flags (value) & GTK_SHRINK) != 0;
|
|
table_child->yfill = (g_value_get_flags (value) & GTK_FILL) != 0;
|
|
}
|
|
break;
|
|
case CHILD_PROP_X_PADDING:
|
|
table_child->xpadding = g_value_get_uint (value);
|
|
break;
|
|
case CHILD_PROP_Y_PADDING:
|
|
table_child->ypadding = g_value_get_uint (value);
|
|
break;
|
|
default:
|
|
GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, property_id, pspec);
|
|
break;
|
|
}
|
|
if (gtk_widget_get_visible (child) &&
|
|
gtk_widget_get_visible (GTK_WIDGET (table)))
|
|
gtk_widget_queue_resize (child);
|
|
}
|
|
|
|
static void
|
|
gtk_table_get_child_property (GtkContainer *container,
|
|
GtkWidget *child,
|
|
guint property_id,
|
|
GValue *value,
|
|
GParamSpec *pspec)
|
|
{
|
|
GtkTable *table = GTK_TABLE (container);
|
|
GtkTablePrivate *priv = table->priv;
|
|
GtkTableChild *table_child;
|
|
GList *list;
|
|
|
|
table_child = NULL;
|
|
for (list = priv->children; list; list = list->next)
|
|
{
|
|
table_child = list->data;
|
|
|
|
if (table_child->widget == child)
|
|
break;
|
|
}
|
|
if (!list)
|
|
{
|
|
GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, property_id, pspec);
|
|
return;
|
|
}
|
|
|
|
switch (property_id)
|
|
{
|
|
case CHILD_PROP_LEFT_ATTACH:
|
|
g_value_set_uint (value, table_child->left_attach);
|
|
break;
|
|
case CHILD_PROP_RIGHT_ATTACH:
|
|
g_value_set_uint (value, table_child->right_attach);
|
|
break;
|
|
case CHILD_PROP_TOP_ATTACH:
|
|
g_value_set_uint (value, table_child->top_attach);
|
|
break;
|
|
case CHILD_PROP_BOTTOM_ATTACH:
|
|
g_value_set_uint (value, table_child->bottom_attach);
|
|
break;
|
|
case CHILD_PROP_X_OPTIONS:
|
|
g_value_set_flags (value, (table_child->xexpand * GTK_EXPAND |
|
|
table_child->xshrink * GTK_SHRINK |
|
|
table_child->xfill * GTK_FILL));
|
|
break;
|
|
case CHILD_PROP_Y_OPTIONS:
|
|
g_value_set_flags (value, (table_child->yexpand * GTK_EXPAND |
|
|
table_child->yshrink * GTK_SHRINK |
|
|
table_child->yfill * GTK_FILL));
|
|
break;
|
|
case CHILD_PROP_X_PADDING:
|
|
g_value_set_uint (value, table_child->xpadding);
|
|
break;
|
|
case CHILD_PROP_Y_PADDING:
|
|
g_value_set_uint (value, table_child->ypadding);
|
|
break;
|
|
default:
|
|
GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, property_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_table_init (GtkTable *table)
|
|
{
|
|
GtkTablePrivate *priv;
|
|
|
|
table->priv = gtk_table_get_instance_private (table);
|
|
priv = table->priv;
|
|
|
|
gtk_widget_set_has_window (GTK_WIDGET (table), FALSE);
|
|
gtk_widget_set_redraw_on_allocate (GTK_WIDGET (table), FALSE);
|
|
|
|
priv->children = NULL;
|
|
priv->rows = NULL;
|
|
priv->cols = NULL;
|
|
priv->nrows = 0;
|
|
priv->ncols = 0;
|
|
priv->column_spacing = 0;
|
|
priv->row_spacing = 0;
|
|
priv->homogeneous = FALSE;
|
|
|
|
gtk_table_resize (table, 1, 1);
|
|
}
|
|
|
|
/**
|
|
* gtk_table_new:
|
|
* @rows: The number of rows the new table should have.
|
|
* @columns: The number of columns the new table should have.
|
|
* @homogeneous: If set to %TRUE, all table cells are resized to the size of
|
|
* the cell containing the largest widget.
|
|
*
|
|
* Used to create a new table widget. An initial size must be given by
|
|
* specifying how many rows and columns the table should have, although
|
|
* this can be changed later with gtk_table_resize(). @rows and @columns
|
|
* must both be in the range 1 .. 65535. For historical reasons, 0 is accepted
|
|
* as well and is silently interpreted as 1.
|
|
*
|
|
* Returns: A pointer to the newly created table widget.
|
|
*
|
|
* Deprecated: 3.4: Use gtk_grid_new().
|
|
*/
|
|
GtkWidget*
|
|
gtk_table_new (guint rows,
|
|
guint columns,
|
|
gboolean homogeneous)
|
|
{
|
|
GtkTable *table;
|
|
GtkTablePrivate *priv;
|
|
|
|
if (rows == 0)
|
|
rows = 1;
|
|
if (columns == 0)
|
|
columns = 1;
|
|
|
|
table = g_object_new (GTK_TYPE_TABLE, NULL);
|
|
priv = table->priv;
|
|
|
|
priv->homogeneous = (homogeneous ? TRUE : FALSE);
|
|
|
|
gtk_table_resize (table, rows, columns);
|
|
|
|
return GTK_WIDGET (table);
|
|
}
|
|
|
|
/**
|
|
* gtk_table_resize:
|
|
* @table: The #GtkTable you wish to change the size of.
|
|
* @rows: The new number of rows.
|
|
* @columns: The new number of columns.
|
|
*
|
|
* If you need to change a table's size after
|
|
* it has been created, this function allows you to do so.
|
|
*
|
|
* Deprecated: 3.4: #GtkGrid resizes automatically.
|
|
*/
|
|
void
|
|
gtk_table_resize (GtkTable *table,
|
|
guint n_rows,
|
|
guint n_cols)
|
|
{
|
|
GtkTablePrivate *priv;
|
|
|
|
g_return_if_fail (GTK_IS_TABLE (table));
|
|
g_return_if_fail (n_rows > 0 && n_rows <= 65535);
|
|
g_return_if_fail (n_cols > 0 && n_cols <= 65535);
|
|
|
|
priv = table->priv;
|
|
|
|
n_rows = MAX (n_rows, 1);
|
|
n_cols = MAX (n_cols, 1);
|
|
|
|
if (n_rows != priv->nrows ||
|
|
n_cols != priv->ncols)
|
|
{
|
|
GList *list;
|
|
|
|
for (list = priv->children; list; list = list->next)
|
|
{
|
|
GtkTableChild *child;
|
|
|
|
child = list->data;
|
|
|
|
n_rows = MAX (n_rows, child->bottom_attach);
|
|
n_cols = MAX (n_cols, child->right_attach);
|
|
}
|
|
|
|
if (n_rows != priv->nrows)
|
|
{
|
|
guint i;
|
|
|
|
i = priv->nrows;
|
|
priv->nrows = n_rows;
|
|
priv->rows = g_realloc (priv->rows, priv->nrows * sizeof (GtkTableRowCol));
|
|
|
|
for (; i < priv->nrows; i++)
|
|
{
|
|
priv->rows[i].requisition = 0;
|
|
priv->rows[i].allocation = 0;
|
|
priv->rows[i].spacing = priv->row_spacing;
|
|
priv->rows[i].need_expand = 0;
|
|
priv->rows[i].need_shrink = 0;
|
|
priv->rows[i].expand = 0;
|
|
priv->rows[i].shrink = 0;
|
|
}
|
|
|
|
g_object_notify (G_OBJECT (table), "n-rows");
|
|
}
|
|
|
|
if (n_cols != priv->ncols)
|
|
{
|
|
guint i;
|
|
|
|
i = priv->ncols;
|
|
priv->ncols = n_cols;
|
|
priv->cols = g_realloc (priv->cols, priv->ncols * sizeof (GtkTableRowCol));
|
|
|
|
for (; i < priv->ncols; i++)
|
|
{
|
|
priv->cols[i].requisition = 0;
|
|
priv->cols[i].allocation = 0;
|
|
priv->cols[i].spacing = priv->column_spacing;
|
|
priv->cols[i].need_expand = 0;
|
|
priv->cols[i].need_shrink = 0;
|
|
priv->cols[i].expand = 0;
|
|
priv->cols[i].shrink = 0;
|
|
}
|
|
|
|
g_object_notify (G_OBJECT (table), "n-columns");
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gtk_table_attach:
|
|
* @table: The #GtkTable to add a new widget to.
|
|
* @child: The widget to add.
|
|
* @left_attach: the column number to attach the left side of a child widget to.
|
|
* @right_attach: the column number to attach the right side of a child widget to.
|
|
* @top_attach: the row number to attach the top of a child widget to.
|
|
* @bottom_attach: the row number to attach the bottom of a child widget to.
|
|
* @xoptions: Used to specify the properties of the child widget when the table is resized.
|
|
* @yoptions: The same as xoptions, except this field determines behaviour of vertical resizing.
|
|
* @xpadding: An integer value specifying the padding on the left and right of the widget being added to the table.
|
|
* @ypadding: The amount of padding above and below the child widget.
|
|
*
|
|
* Adds a widget to a table. The number of 'cells' that a widget will occupy is
|
|
* specified by @left_attach, @right_attach, @top_attach and @bottom_attach.
|
|
* These each represent the leftmost, rightmost, uppermost and lowest column
|
|
* and row numbers of the table. (Columns and rows are indexed from zero).
|
|
*
|
|
* To make a button occupy the lower right cell of a 2x2 table, use
|
|
* |[
|
|
* gtk_table_attach (table, button,
|
|
* 1, 2, // left, right attach
|
|
* 1, 2, // top, bottom attach
|
|
* xoptions, yoptions,
|
|
* xpadding, ypadding);
|
|
* ]|
|
|
* If you want to make the button span the entire bottom row, use @left_attach == 0 and @right_attach = 2 instead.
|
|
*
|
|
* Deprecated: 3.4: Use gtk_grid_attach() with #GtkGrid. Note that the attach
|
|
* arguments differ between those two functions.
|
|
*/
|
|
void
|
|
gtk_table_attach (GtkTable *table,
|
|
GtkWidget *child,
|
|
guint left_attach,
|
|
guint right_attach,
|
|
guint top_attach,
|
|
guint bottom_attach,
|
|
GtkAttachOptions xoptions,
|
|
GtkAttachOptions yoptions,
|
|
guint xpadding,
|
|
guint ypadding)
|
|
{
|
|
GtkTablePrivate *priv;
|
|
GtkTableChild *table_child;
|
|
|
|
g_return_if_fail (GTK_IS_TABLE (table));
|
|
g_return_if_fail (GTK_IS_WIDGET (child));
|
|
g_return_if_fail (gtk_widget_get_parent (child) == NULL);
|
|
|
|
/* g_return_if_fail (left_attach >= 0); */
|
|
g_return_if_fail (left_attach < right_attach);
|
|
/* g_return_if_fail (top_attach >= 0); */
|
|
g_return_if_fail (top_attach < bottom_attach);
|
|
|
|
priv = table->priv;
|
|
|
|
if (right_attach >= priv->ncols)
|
|
gtk_table_resize (table, priv->nrows, right_attach);
|
|
|
|
if (bottom_attach >= priv->nrows)
|
|
gtk_table_resize (table, bottom_attach, priv->ncols);
|
|
|
|
table_child = g_new (GtkTableChild, 1);
|
|
table_child->widget = child;
|
|
table_child->left_attach = left_attach;
|
|
table_child->right_attach = right_attach;
|
|
table_child->top_attach = top_attach;
|
|
table_child->bottom_attach = bottom_attach;
|
|
table_child->xexpand = (xoptions & GTK_EXPAND) != 0;
|
|
table_child->xshrink = (xoptions & GTK_SHRINK) != 0;
|
|
table_child->xfill = (xoptions & GTK_FILL) != 0;
|
|
table_child->xpadding = xpadding;
|
|
table_child->yexpand = (yoptions & GTK_EXPAND) != 0;
|
|
table_child->yshrink = (yoptions & GTK_SHRINK) != 0;
|
|
table_child->yfill = (yoptions & GTK_FILL) != 0;
|
|
table_child->ypadding = ypadding;
|
|
|
|
priv->children = g_list_prepend (priv->children, table_child);
|
|
|
|
gtk_widget_set_parent (child, GTK_WIDGET (table));
|
|
}
|
|
|
|
/**
|
|
* gtk_table_attach_defaults:
|
|
* @table: The table to add a new child widget to.
|
|
* @widget: The child widget to add.
|
|
* @left_attach: The column number to attach the left side of the child widget to.
|
|
* @right_attach: The column number to attach the right side of the child widget to.
|
|
* @top_attach: The row number to attach the top of the child widget to.
|
|
* @bottom_attach: The row number to attach the bottom of the child widget to.
|
|
*
|
|
* As there are many options associated with gtk_table_attach(), this convenience
|
|
* function provides the programmer with a means to add children to a table with
|
|
* identical padding and expansion options. The values used for the #GtkAttachOptions
|
|
* are `GTK_EXPAND | GTK_FILL`, and the padding is set to 0.
|
|
*
|
|
* Deprecated: 3.4: Use gtk_grid_attach() with #GtkGrid. Note that the attach
|
|
* arguments differ between those two functions.
|
|
*/
|
|
void
|
|
gtk_table_attach_defaults (GtkTable *table,
|
|
GtkWidget *widget,
|
|
guint left_attach,
|
|
guint right_attach,
|
|
guint top_attach,
|
|
guint bottom_attach)
|
|
{
|
|
gtk_table_attach (table, widget,
|
|
left_attach, right_attach,
|
|
top_attach, bottom_attach,
|
|
GTK_EXPAND | GTK_FILL,
|
|
GTK_EXPAND | GTK_FILL,
|
|
0, 0);
|
|
}
|
|
|
|
/**
|
|
* gtk_table_set_row_spacing:
|
|
* @table: a #GtkTable containing the row whose properties you wish to change.
|
|
* @row: row number whose spacing will be changed.
|
|
* @spacing: number of pixels that the spacing should take up.
|
|
*
|
|
* Changes the space between a given table row and the subsequent row.
|
|
*
|
|
* Deprecated: 3.4: Use gtk_widget_set_margin_top() and
|
|
* gtk_widget_set_margin_bottom() on the widgets contained in the row if
|
|
* you need this functionality. #GtkGrid does not support per-row spacing.
|
|
*/
|
|
void
|
|
gtk_table_set_row_spacing (GtkTable *table,
|
|
guint row,
|
|
guint spacing)
|
|
{
|
|
GtkTablePrivate *priv;
|
|
|
|
g_return_if_fail (GTK_IS_TABLE (table));
|
|
|
|
priv = table->priv;
|
|
|
|
g_return_if_fail (row < priv->nrows);
|
|
|
|
if (priv->rows[row].spacing != spacing)
|
|
{
|
|
priv->rows[row].spacing = spacing;
|
|
|
|
if (gtk_widget_get_visible (GTK_WIDGET (table)))
|
|
gtk_widget_queue_resize (GTK_WIDGET (table));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gtk_table_get_row_spacing:
|
|
* @table: a #GtkTable
|
|
* @row: a row in the table, 0 indicates the first row
|
|
*
|
|
* Gets the amount of space between row @row, and
|
|
* row @row + 1. See gtk_table_set_row_spacing().
|
|
*
|
|
* Return value: the row spacing
|
|
*
|
|
* Deprecated: 3.4: #GtkGrid does not offer a replacement for this
|
|
* functionality.
|
|
**/
|
|
guint
|
|
gtk_table_get_row_spacing (GtkTable *table,
|
|
guint row)
|
|
{
|
|
GtkTablePrivate *priv;
|
|
|
|
g_return_val_if_fail (GTK_IS_TABLE (table), 0);
|
|
|
|
priv = table->priv;
|
|
|
|
g_return_val_if_fail (row < priv->nrows - 1, 0);
|
|
|
|
return priv->rows[row].spacing;
|
|
}
|
|
|
|
/**
|
|
* gtk_table_set_col_spacing:
|
|
* @table: a #GtkTable.
|
|
* @column: the column whose spacing should be changed.
|
|
* @spacing: number of pixels that the spacing should take up.
|
|
*
|
|
* Alters the amount of space between a given table column and the following
|
|
* column.
|
|
*
|
|
* Deprecated: 3.4: Use gtk_widget_set_margin_start() and
|
|
* gtk_widget_set_margin_end() on the widgets contained in the row if
|
|
* you need this functionality. #GtkGrid does not support per-row spacing.
|
|
*/
|
|
void
|
|
gtk_table_set_col_spacing (GtkTable *table,
|
|
guint column,
|
|
guint spacing)
|
|
{
|
|
GtkTablePrivate *priv;
|
|
|
|
g_return_if_fail (GTK_IS_TABLE (table));
|
|
|
|
priv = table->priv;
|
|
|
|
g_return_if_fail (column < priv->ncols);
|
|
|
|
if (priv->cols[column].spacing != spacing)
|
|
{
|
|
priv->cols[column].spacing = spacing;
|
|
|
|
if (gtk_widget_get_visible (GTK_WIDGET (table)))
|
|
gtk_widget_queue_resize (GTK_WIDGET (table));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gtk_table_get_col_spacing:
|
|
* @table: a #GtkTable
|
|
* @column: a column in the table, 0 indicates the first column
|
|
*
|
|
* Gets the amount of space between column @col, and
|
|
* column @col + 1. See gtk_table_set_col_spacing().
|
|
*
|
|
* Return value: the column spacing
|
|
*
|
|
* Deprecated: 3.4: #GtkGrid does not offer a replacement for this
|
|
* functionality.
|
|
**/
|
|
guint
|
|
gtk_table_get_col_spacing (GtkTable *table,
|
|
guint column)
|
|
{
|
|
GtkTablePrivate *priv;
|
|
|
|
g_return_val_if_fail (GTK_IS_TABLE (table), 0);
|
|
|
|
priv = table->priv;
|
|
|
|
g_return_val_if_fail (column < priv->ncols, 0);
|
|
|
|
return priv->cols[column].spacing;
|
|
}
|
|
|
|
/**
|
|
* gtk_table_set_row_spacings:
|
|
* @table: a #GtkTable.
|
|
* @spacing: the number of pixels of space to place between every row in the table.
|
|
*
|
|
* Sets the space between every row in @table equal to @spacing.
|
|
*
|
|
* Deprecated: 3.4: Use gtk_grid_set_row_spacing() with #GtkGrid.
|
|
*/
|
|
void
|
|
gtk_table_set_row_spacings (GtkTable *table,
|
|
guint spacing)
|
|
{
|
|
GtkTablePrivate *priv;
|
|
guint row;
|
|
|
|
g_return_if_fail (GTK_IS_TABLE (table));
|
|
|
|
priv = table->priv;
|
|
|
|
priv->row_spacing = spacing;
|
|
for (row = 0; row < priv->nrows; row++)
|
|
priv->rows[row].spacing = spacing;
|
|
|
|
if (gtk_widget_get_visible (GTK_WIDGET (table)))
|
|
gtk_widget_queue_resize (GTK_WIDGET (table));
|
|
|
|
g_object_notify (G_OBJECT (table), "row-spacing");
|
|
}
|
|
|
|
/**
|
|
* gtk_table_get_default_row_spacing:
|
|
* @table: a #GtkTable
|
|
*
|
|
* Gets the default row spacing for the table. This is
|
|
* the spacing that will be used for newly added rows.
|
|
* (See gtk_table_set_row_spacings())
|
|
*
|
|
* Return value: the default row spacing
|
|
*
|
|
* Deprecated: 3.4: Use gtk_grid_get_row_spacing() with #GtkGrid.
|
|
**/
|
|
guint
|
|
gtk_table_get_default_row_spacing (GtkTable *table)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_TABLE (table), 0);
|
|
|
|
return table->priv->row_spacing;
|
|
}
|
|
|
|
/**
|
|
* gtk_table_set_col_spacings:
|
|
* @table: a #GtkTable.
|
|
* @spacing: the number of pixels of space to place between every column
|
|
* in the table.
|
|
*
|
|
* Sets the space between every column in @table equal to @spacing.
|
|
*
|
|
* Deprecated: 3.4: Use gtk_grid_set_column_spacing() with #GtkGrid.
|
|
*/
|
|
void
|
|
gtk_table_set_col_spacings (GtkTable *table,
|
|
guint spacing)
|
|
{
|
|
GtkTablePrivate *priv;
|
|
guint col;
|
|
|
|
g_return_if_fail (GTK_IS_TABLE (table));
|
|
|
|
priv = table->priv;
|
|
|
|
priv->column_spacing = spacing;
|
|
for (col = 0; col < priv->ncols; col++)
|
|
priv->cols[col].spacing = spacing;
|
|
|
|
if (gtk_widget_get_visible (GTK_WIDGET (table)))
|
|
gtk_widget_queue_resize (GTK_WIDGET (table));
|
|
|
|
g_object_notify (G_OBJECT (table), "column-spacing");
|
|
}
|
|
|
|
/**
|
|
* gtk_table_get_default_col_spacing:
|
|
* @table: a #GtkTable
|
|
*
|
|
* Gets the default column spacing for the table. This is
|
|
* the spacing that will be used for newly added columns.
|
|
* (See gtk_table_set_col_spacings())
|
|
*
|
|
* Return value: the default column spacing
|
|
*
|
|
* Deprecated: 3.4: Use gtk_grid_get_column_spacing() with #GtkGrid.
|
|
**/
|
|
guint
|
|
gtk_table_get_default_col_spacing (GtkTable *table)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_TABLE (table), 0);
|
|
|
|
return table->priv->column_spacing;
|
|
}
|
|
|
|
/**
|
|
* gtk_table_set_homogeneous:
|
|
* @table: The #GtkTable you wish to set the homogeneous properties of.
|
|
* @homogeneous: Set to %TRUE to ensure all table cells are the same size. Set
|
|
* to %FALSE if this is not your desired behaviour.
|
|
*
|
|
* Changes the homogenous property of table cells, ie. whether all cells are
|
|
* an equal size or not.
|
|
*
|
|
* Deprecated: 3.4: Use gtk_grid_set_row_homogeneous() and
|
|
* gtk_grid_set_column_homogeneous() with #GtkGrid.
|
|
*/
|
|
void
|
|
gtk_table_set_homogeneous (GtkTable *table,
|
|
gboolean homogeneous)
|
|
{
|
|
GtkTablePrivate *priv;
|
|
|
|
g_return_if_fail (GTK_IS_TABLE (table));
|
|
|
|
priv = table->priv;
|
|
|
|
homogeneous = (homogeneous != 0);
|
|
if (homogeneous != priv->homogeneous)
|
|
{
|
|
priv->homogeneous = homogeneous;
|
|
|
|
if (gtk_widget_get_visible (GTK_WIDGET (table)))
|
|
gtk_widget_queue_resize (GTK_WIDGET (table));
|
|
|
|
g_object_notify (G_OBJECT (table), "homogeneous");
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gtk_table_get_homogeneous:
|
|
* @table: a #GtkTable
|
|
*
|
|
* Returns whether the table cells are all constrained to the same
|
|
* width and height. (See gtk_table_set_homogeneous ())
|
|
*
|
|
* Return value: %TRUE if the cells are all constrained to the same size
|
|
*
|
|
* Deprecated: 3.4: Use gtk_grid_get_row_homogeneous() and
|
|
* gtk_grid_get_column_homogeneous() with #GtkGrid.
|
|
**/
|
|
gboolean
|
|
gtk_table_get_homogeneous (GtkTable *table)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_TABLE (table), FALSE);
|
|
|
|
return table->priv->homogeneous;
|
|
}
|
|
|
|
/**
|
|
* gtk_table_get_size:
|
|
* @table: a #GtkTable
|
|
* @rows: (out) (allow-none): return location for the number of
|
|
* rows, or %NULL
|
|
* @columns: (out) (allow-none): return location for the number
|
|
* of columns, or %NULL
|
|
*
|
|
* Gets the number of rows and columns in the table.
|
|
*
|
|
* Since: 2.22
|
|
*
|
|
* Deprecated: 3.4: #GtkGrid does not expose the number of columns and
|
|
* rows.
|
|
**/
|
|
void
|
|
gtk_table_get_size (GtkTable *table,
|
|
guint *rows,
|
|
guint *columns)
|
|
{
|
|
GtkTablePrivate *priv;
|
|
|
|
g_return_if_fail (GTK_IS_TABLE (table));
|
|
|
|
priv = table->priv;
|
|
|
|
if (rows)
|
|
*rows = priv->nrows;
|
|
|
|
if (columns)
|
|
*columns = priv->ncols;
|
|
}
|
|
|
|
static void
|
|
gtk_table_finalize (GObject *object)
|
|
{
|
|
GtkTable *table = GTK_TABLE (object);
|
|
GtkTablePrivate *priv = table->priv;
|
|
|
|
g_free (priv->rows);
|
|
g_free (priv->cols);
|
|
|
|
G_OBJECT_CLASS (gtk_table_parent_class)->finalize (object);
|
|
}
|
|
|
|
static void
|
|
gtk_table_get_preferred_width (GtkWidget *widget,
|
|
gint *minimum,
|
|
gint *natural)
|
|
{
|
|
GtkTable *table = GTK_TABLE (widget);
|
|
GtkTablePrivate *priv = table->priv;
|
|
gint col;
|
|
|
|
gtk_table_size_request_init (table);
|
|
gtk_table_size_request_pass1 (table);
|
|
gtk_table_size_request_pass2 (table);
|
|
gtk_table_size_request_pass3 (table);
|
|
gtk_table_size_request_pass2 (table);
|
|
|
|
*minimum = 0;
|
|
|
|
for (col = 0; col < priv->ncols; col++)
|
|
*minimum += priv->cols[col].requisition;
|
|
for (col = 0; col + 1 < priv->ncols; col++)
|
|
*minimum += priv->cols[col].spacing;
|
|
|
|
*natural = *minimum;
|
|
}
|
|
|
|
static void
|
|
gtk_table_get_preferred_height (GtkWidget *widget,
|
|
gint *minimum,
|
|
gint *natural)
|
|
{
|
|
GtkTable *table = GTK_TABLE (widget);
|
|
GtkTablePrivate *priv = table->priv;
|
|
gint row;
|
|
|
|
gtk_table_size_request_init (table);
|
|
gtk_table_size_request_pass1 (table);
|
|
gtk_table_size_request_pass2 (table);
|
|
gtk_table_size_request_pass3 (table);
|
|
gtk_table_size_request_pass2 (table);
|
|
|
|
*minimum = 0;
|
|
for (row = 0; row < priv->nrows; row++)
|
|
*minimum += priv->rows[row].requisition;
|
|
for (row = 0; row + 1 < priv->nrows; row++)
|
|
*minimum += priv->rows[row].spacing;
|
|
|
|
*natural = *minimum;
|
|
}
|
|
|
|
static void
|
|
gtk_table_size_allocate (GtkWidget *widget,
|
|
GtkAllocation *allocation)
|
|
{
|
|
GtkTable *table = GTK_TABLE (widget);
|
|
|
|
gtk_widget_set_allocation (widget, allocation);
|
|
|
|
gtk_table_size_allocate_init (table);
|
|
gtk_table_size_allocate_pass1 (table);
|
|
gtk_table_size_allocate_pass2 (table);
|
|
}
|
|
|
|
static void
|
|
gtk_table_add (GtkContainer *container,
|
|
GtkWidget *widget)
|
|
{
|
|
gtk_table_attach_defaults (GTK_TABLE (container), widget, 0, 1, 0, 1);
|
|
}
|
|
|
|
static void
|
|
gtk_table_remove (GtkContainer *container,
|
|
GtkWidget *widget)
|
|
{
|
|
GtkTable *table = GTK_TABLE (container);
|
|
GtkTablePrivate *priv = table->priv;
|
|
GtkTableChild *child;
|
|
GtkWidget *widget_container = GTK_WIDGET (container);
|
|
GList *children;
|
|
|
|
children = priv->children;
|
|
|
|
while (children)
|
|
{
|
|
child = children->data;
|
|
children = children->next;
|
|
|
|
if (child->widget == widget)
|
|
{
|
|
gboolean was_visible = gtk_widget_get_visible (widget);
|
|
|
|
gtk_widget_unparent (widget);
|
|
|
|
priv->children = g_list_remove (priv->children, child);
|
|
g_free (child);
|
|
|
|
if (was_visible && gtk_widget_get_visible (widget_container))
|
|
gtk_widget_queue_resize (widget_container);
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_table_forall (GtkContainer *container,
|
|
gboolean include_internals,
|
|
GtkCallback callback,
|
|
gpointer callback_data)
|
|
{
|
|
GtkTable *table = GTK_TABLE (container);
|
|
GtkTablePrivate *priv = table->priv;
|
|
GtkTableChild *child;
|
|
GList *children;
|
|
|
|
children = priv->children;
|
|
|
|
while (children)
|
|
{
|
|
child = children->data;
|
|
children = children->next;
|
|
|
|
(* callback) (child->widget, callback_data);
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_table_size_request_init (GtkTable *table)
|
|
{
|
|
GtkTablePrivate *priv = table->priv;
|
|
GtkTableChild *child;
|
|
GList *children;
|
|
gint row, col;
|
|
|
|
for (row = 0; row < priv->nrows; row++)
|
|
{
|
|
priv->rows[row].requisition = 0;
|
|
priv->rows[row].expand = FALSE;
|
|
}
|
|
for (col = 0; col < priv->ncols; col++)
|
|
{
|
|
priv->cols[col].requisition = 0;
|
|
priv->cols[col].expand = FALSE;
|
|
}
|
|
|
|
children = priv->children;
|
|
while (children)
|
|
{
|
|
child = children->data;
|
|
children = children->next;
|
|
|
|
if (child->left_attach == (child->right_attach - 1) &&
|
|
(child->xexpand || gtk_widget_compute_expand (child->widget, GTK_ORIENTATION_HORIZONTAL)))
|
|
priv->cols[child->left_attach].expand = TRUE;
|
|
|
|
if (child->top_attach == (child->bottom_attach - 1) &&
|
|
(child->yexpand || gtk_widget_compute_expand (child->widget, GTK_ORIENTATION_VERTICAL)))
|
|
priv->rows[child->top_attach].expand = TRUE;
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_table_size_request_pass1 (GtkTable *table)
|
|
{
|
|
GtkTablePrivate *priv = table->priv;
|
|
GtkTableChild *child;
|
|
GList *children;
|
|
gint width;
|
|
gint height;
|
|
|
|
children = priv->children;
|
|
while (children)
|
|
{
|
|
child = children->data;
|
|
children = children->next;
|
|
|
|
if (gtk_widget_get_visible (child->widget))
|
|
{
|
|
GtkRequisition child_requisition;
|
|
|
|
gtk_widget_get_preferred_size (child->widget, &child_requisition, NULL);
|
|
|
|
/* Child spans a single column.
|
|
*/
|
|
if (child->left_attach == (child->right_attach - 1))
|
|
{
|
|
width = child_requisition.width + child->xpadding * 2;
|
|
priv->cols[child->left_attach].requisition = MAX (priv->cols[child->left_attach].requisition, width);
|
|
}
|
|
|
|
/* Child spans a single row.
|
|
*/
|
|
if (child->top_attach == (child->bottom_attach - 1))
|
|
{
|
|
height = child_requisition.height + child->ypadding * 2;
|
|
priv->rows[child->top_attach].requisition = MAX (priv->rows[child->top_attach].requisition, height);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_table_size_request_pass2 (GtkTable *table)
|
|
{
|
|
GtkTablePrivate *priv = table->priv;
|
|
gint max_width;
|
|
gint max_height;
|
|
gint row, col;
|
|
|
|
if (priv->homogeneous)
|
|
{
|
|
max_width = 0;
|
|
max_height = 0;
|
|
|
|
for (col = 0; col < priv->ncols; col++)
|
|
max_width = MAX (max_width, priv->cols[col].requisition);
|
|
for (row = 0; row < priv->nrows; row++)
|
|
max_height = MAX (max_height, priv->rows[row].requisition);
|
|
|
|
for (col = 0; col < priv->ncols; col++)
|
|
priv->cols[col].requisition = max_width;
|
|
for (row = 0; row < priv->nrows; row++)
|
|
priv->rows[row].requisition = max_height;
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_table_size_request_pass3 (GtkTable *table)
|
|
{
|
|
GtkTablePrivate *priv = table->priv;
|
|
GtkTableChild *child;
|
|
GList *children;
|
|
gint width, height;
|
|
gint row, col;
|
|
gint extra;
|
|
|
|
children = priv->children;
|
|
while (children)
|
|
{
|
|
child = children->data;
|
|
children = children->next;
|
|
|
|
if (gtk_widget_get_visible (child->widget))
|
|
{
|
|
/* Child spans multiple columns.
|
|
*/
|
|
if (child->left_attach != (child->right_attach - 1))
|
|
{
|
|
GtkRequisition child_requisition;
|
|
|
|
gtk_widget_get_preferred_size (child->widget,
|
|
&child_requisition, NULL);
|
|
|
|
/* Check and see if there is already enough space
|
|
* for the child.
|
|
*/
|
|
width = 0;
|
|
for (col = child->left_attach; col < child->right_attach; col++)
|
|
{
|
|
width += priv->cols[col].requisition;
|
|
if ((col + 1) < child->right_attach)
|
|
width += priv->cols[col].spacing;
|
|
}
|
|
|
|
/* If we need to request more space for this child to fill
|
|
* its requisition, then divide up the needed space amongst the
|
|
* columns it spans, favoring expandable columns if any.
|
|
*/
|
|
if (width < child_requisition.width + child->xpadding * 2)
|
|
{
|
|
gint n_expand = 0;
|
|
gboolean force_expand = FALSE;
|
|
|
|
width = child_requisition.width + child->xpadding * 2 - width;
|
|
|
|
for (col = child->left_attach; col < child->right_attach; col++)
|
|
if (priv->cols[col].expand)
|
|
n_expand++;
|
|
|
|
if (n_expand == 0)
|
|
{
|
|
n_expand = (child->right_attach - child->left_attach);
|
|
force_expand = TRUE;
|
|
}
|
|
|
|
for (col = child->left_attach; col < child->right_attach; col++)
|
|
if (force_expand || priv->cols[col].expand)
|
|
{
|
|
extra = width / n_expand;
|
|
priv->cols[col].requisition += extra;
|
|
width -= extra;
|
|
n_expand--;
|
|
}
|
|
}
|
|
}
|
|
|
|
/* Child spans multiple rows.
|
|
*/
|
|
if (child->top_attach != (child->bottom_attach - 1))
|
|
{
|
|
GtkRequisition child_requisition;
|
|
|
|
gtk_widget_get_preferred_size (child->widget,
|
|
&child_requisition, NULL);
|
|
|
|
/* Check and see if there is already enough space
|
|
* for the child.
|
|
*/
|
|
height = 0;
|
|
for (row = child->top_attach; row < child->bottom_attach; row++)
|
|
{
|
|
height += priv->rows[row].requisition;
|
|
if ((row + 1) < child->bottom_attach)
|
|
height += priv->rows[row].spacing;
|
|
}
|
|
|
|
/* If we need to request more space for this child to fill
|
|
* its requisition, then divide up the needed space amongst the
|
|
* rows it spans, favoring expandable rows if any.
|
|
*/
|
|
if (height < child_requisition.height + child->ypadding * 2)
|
|
{
|
|
gint n_expand = 0;
|
|
gboolean force_expand = FALSE;
|
|
|
|
height = child_requisition.height + child->ypadding * 2 - height;
|
|
|
|
for (row = child->top_attach; row < child->bottom_attach; row++)
|
|
{
|
|
if (priv->rows[row].expand)
|
|
n_expand++;
|
|
}
|
|
|
|
if (n_expand == 0)
|
|
{
|
|
n_expand = (child->bottom_attach - child->top_attach);
|
|
force_expand = TRUE;
|
|
}
|
|
|
|
for (row = child->top_attach; row < child->bottom_attach; row++)
|
|
if (force_expand || priv->rows[row].expand)
|
|
{
|
|
extra = height / n_expand;
|
|
priv->rows[row].requisition += extra;
|
|
height -= extra;
|
|
n_expand--;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_table_size_allocate_init (GtkTable *table)
|
|
{
|
|
GtkTablePrivate *priv = table->priv;
|
|
GtkTableChild *child;
|
|
GList *children;
|
|
gint row, col;
|
|
gint has_expand;
|
|
gint has_shrink;
|
|
|
|
/* Initialize the rows and cols.
|
|
* By default, rows and cols do not expand and do shrink.
|
|
* Those values are modified by the children that occupy
|
|
* the rows and cols.
|
|
*/
|
|
for (col = 0; col < priv->ncols; col++)
|
|
{
|
|
priv->cols[col].allocation = priv->cols[col].requisition;
|
|
priv->cols[col].need_expand = FALSE;
|
|
priv->cols[col].need_shrink = TRUE;
|
|
priv->cols[col].expand = FALSE;
|
|
priv->cols[col].shrink = TRUE;
|
|
priv->cols[col].empty = TRUE;
|
|
}
|
|
for (row = 0; row < priv->nrows; row++)
|
|
{
|
|
priv->rows[row].allocation = priv->rows[row].requisition;
|
|
priv->rows[row].need_expand = FALSE;
|
|
priv->rows[row].need_shrink = TRUE;
|
|
priv->rows[row].expand = FALSE;
|
|
priv->rows[row].shrink = TRUE;
|
|
priv->rows[row].empty = TRUE;
|
|
}
|
|
|
|
/* Loop over all the children and adjust the row and col values
|
|
* based on whether the children want to be allowed to expand
|
|
* or shrink. This loop handles children that occupy a single
|
|
* row or column.
|
|
*/
|
|
children = priv->children;
|
|
while (children)
|
|
{
|
|
child = children->data;
|
|
children = children->next;
|
|
|
|
if (gtk_widget_get_visible (child->widget))
|
|
{
|
|
if (child->left_attach == (child->right_attach - 1))
|
|
{
|
|
if (child->xexpand || gtk_widget_compute_expand (child->widget, GTK_ORIENTATION_HORIZONTAL))
|
|
priv->cols[child->left_attach].expand = TRUE;
|
|
|
|
if (!child->xshrink)
|
|
priv->cols[child->left_attach].shrink = FALSE;
|
|
|
|
priv->cols[child->left_attach].empty = FALSE;
|
|
}
|
|
|
|
if (child->top_attach == (child->bottom_attach - 1))
|
|
{
|
|
if (child->yexpand || gtk_widget_compute_expand (child->widget, GTK_ORIENTATION_VERTICAL))
|
|
priv->rows[child->top_attach].expand = TRUE;
|
|
|
|
if (!child->yshrink)
|
|
priv->rows[child->top_attach].shrink = FALSE;
|
|
|
|
priv->rows[child->top_attach].empty = FALSE;
|
|
}
|
|
}
|
|
}
|
|
|
|
/* Loop over all the children again and this time handle children
|
|
* which span multiple rows or columns.
|
|
*/
|
|
children = priv->children;
|
|
while (children)
|
|
{
|
|
child = children->data;
|
|
children = children->next;
|
|
|
|
if (gtk_widget_get_visible (child->widget))
|
|
{
|
|
if (child->left_attach != (child->right_attach - 1))
|
|
{
|
|
for (col = child->left_attach; col < child->right_attach; col++)
|
|
priv->cols[col].empty = FALSE;
|
|
|
|
if (child->xexpand)
|
|
{
|
|
has_expand = FALSE;
|
|
for (col = child->left_attach; col < child->right_attach; col++)
|
|
if (priv->cols[col].expand)
|
|
{
|
|
has_expand = TRUE;
|
|
break;
|
|
}
|
|
|
|
if (!has_expand)
|
|
for (col = child->left_attach; col < child->right_attach; col++)
|
|
priv->cols[col].need_expand = TRUE;
|
|
}
|
|
|
|
if (!child->xshrink)
|
|
{
|
|
has_shrink = TRUE;
|
|
for (col = child->left_attach; col < child->right_attach; col++)
|
|
if (!priv->cols[col].shrink)
|
|
{
|
|
has_shrink = FALSE;
|
|
break;
|
|
}
|
|
|
|
if (has_shrink)
|
|
for (col = child->left_attach; col < child->right_attach; col++)
|
|
priv->cols[col].need_shrink = FALSE;
|
|
}
|
|
}
|
|
|
|
if (child->top_attach != (child->bottom_attach - 1))
|
|
{
|
|
for (row = child->top_attach; row < child->bottom_attach; row++)
|
|
priv->rows[row].empty = FALSE;
|
|
|
|
if (child->yexpand)
|
|
{
|
|
has_expand = FALSE;
|
|
for (row = child->top_attach; row < child->bottom_attach; row++)
|
|
if (priv->rows[row].expand)
|
|
{
|
|
has_expand = TRUE;
|
|
break;
|
|
}
|
|
|
|
if (!has_expand)
|
|
for (row = child->top_attach; row < child->bottom_attach; row++)
|
|
priv->rows[row].need_expand = TRUE;
|
|
}
|
|
|
|
if (!child->yshrink)
|
|
{
|
|
has_shrink = TRUE;
|
|
for (row = child->top_attach; row < child->bottom_attach; row++)
|
|
if (!priv->rows[row].shrink)
|
|
{
|
|
has_shrink = FALSE;
|
|
break;
|
|
}
|
|
|
|
if (has_shrink)
|
|
for (row = child->top_attach; row < child->bottom_attach; row++)
|
|
priv->rows[row].need_shrink = FALSE;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/* Loop over the columns and set the expand and shrink values
|
|
* if the column can be expanded or shrunk.
|
|
*/
|
|
for (col = 0; col < priv->ncols; col++)
|
|
{
|
|
if (priv->cols[col].empty)
|
|
{
|
|
priv->cols[col].expand = FALSE;
|
|
priv->cols[col].shrink = FALSE;
|
|
}
|
|
else
|
|
{
|
|
if (priv->cols[col].need_expand)
|
|
priv->cols[col].expand = TRUE;
|
|
if (!priv->cols[col].need_shrink)
|
|
priv->cols[col].shrink = FALSE;
|
|
}
|
|
}
|
|
|
|
/* Loop over the rows and set the expand and shrink values
|
|
* if the row can be expanded or shrunk.
|
|
*/
|
|
for (row = 0; row < priv->nrows; row++)
|
|
{
|
|
if (priv->rows[row].empty)
|
|
{
|
|
priv->rows[row].expand = FALSE;
|
|
priv->rows[row].shrink = FALSE;
|
|
}
|
|
else
|
|
{
|
|
if (priv->rows[row].need_expand)
|
|
priv->rows[row].expand = TRUE;
|
|
if (!priv->rows[row].need_shrink)
|
|
priv->rows[row].shrink = FALSE;
|
|
}
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_table_size_allocate_pass1 (GtkTable *table)
|
|
{
|
|
GtkTablePrivate *priv = table->priv;
|
|
GtkAllocation allocation;
|
|
gint real_width;
|
|
gint real_height;
|
|
gint width, height;
|
|
gint row, col;
|
|
gint nexpand;
|
|
gint nshrink;
|
|
gint extra;
|
|
|
|
/* If we were allocated more space than we requested
|
|
* then we have to expand any expandable rows and columns
|
|
* to fill in the extra space.
|
|
*/
|
|
gtk_widget_get_allocation (GTK_WIDGET (table), &allocation);
|
|
real_width = allocation.width;
|
|
real_height = allocation.height;
|
|
|
|
if (priv->homogeneous)
|
|
{
|
|
if (!priv->children)
|
|
nexpand = 1;
|
|
else
|
|
{
|
|
nexpand = 0;
|
|
for (col = 0; col < priv->ncols; col++)
|
|
if (priv->cols[col].expand)
|
|
{
|
|
nexpand += 1;
|
|
break;
|
|
}
|
|
}
|
|
if (nexpand)
|
|
{
|
|
width = real_width;
|
|
for (col = 0; col + 1 < priv->ncols; col++)
|
|
width -= priv->cols[col].spacing;
|
|
|
|
for (col = 0; col < priv->ncols; col++)
|
|
{
|
|
extra = width / (priv->ncols - col);
|
|
priv->cols[col].allocation = MAX (1, extra);
|
|
width -= extra;
|
|
}
|
|
}
|
|
}
|
|
else
|
|
{
|
|
width = 0;
|
|
nexpand = 0;
|
|
nshrink = 0;
|
|
|
|
for (col = 0; col < priv->ncols; col++)
|
|
{
|
|
width += priv->cols[col].requisition;
|
|
if (priv->cols[col].expand)
|
|
nexpand += 1;
|
|
if (priv->cols[col].shrink)
|
|
nshrink += 1;
|
|
}
|
|
for (col = 0; col + 1 < priv->ncols; col++)
|
|
width += priv->cols[col].spacing;
|
|
|
|
/* Check to see if we were allocated more width than we requested.
|
|
*/
|
|
if ((width < real_width) && (nexpand >= 1))
|
|
{
|
|
width = real_width - width;
|
|
|
|
for (col = 0; col < priv->ncols; col++)
|
|
if (priv->cols[col].expand)
|
|
{
|
|
extra = width / nexpand;
|
|
priv->cols[col].allocation += extra;
|
|
|
|
width -= extra;
|
|
nexpand -= 1;
|
|
}
|
|
}
|
|
|
|
/* Check to see if we were allocated less width than we requested,
|
|
* then shrink until we fit the size give.
|
|
*/
|
|
if (width > real_width)
|
|
{
|
|
gint total_nshrink = nshrink;
|
|
|
|
extra = width - real_width;
|
|
while (total_nshrink > 0 && extra > 0)
|
|
{
|
|
nshrink = total_nshrink;
|
|
for (col = 0; col < priv->ncols; col++)
|
|
if (priv->cols[col].shrink)
|
|
{
|
|
gint allocation = priv->cols[col].allocation;
|
|
|
|
priv->cols[col].allocation = MAX (1, (gint) priv->cols[col].allocation - extra / nshrink);
|
|
extra -= allocation - priv->cols[col].allocation;
|
|
nshrink -= 1;
|
|
if (priv->cols[col].allocation < 2)
|
|
{
|
|
total_nshrink -= 1;
|
|
priv->cols[col].shrink = FALSE;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
if (priv->homogeneous)
|
|
{
|
|
if (!priv->children)
|
|
nexpand = 1;
|
|
else
|
|
{
|
|
nexpand = 0;
|
|
for (row = 0; row < priv->nrows; row++)
|
|
if (priv->rows[row].expand)
|
|
{
|
|
nexpand += 1;
|
|
break;
|
|
}
|
|
}
|
|
if (nexpand)
|
|
{
|
|
height = real_height;
|
|
|
|
for (row = 0; row + 1 < priv->nrows; row++)
|
|
height -= priv->rows[row].spacing;
|
|
|
|
for (row = 0; row < priv->nrows; row++)
|
|
{
|
|
extra = height / (priv->nrows - row);
|
|
priv->rows[row].allocation = MAX (1, extra);
|
|
height -= extra;
|
|
}
|
|
}
|
|
}
|
|
else
|
|
{
|
|
height = 0;
|
|
nexpand = 0;
|
|
nshrink = 0;
|
|
|
|
for (row = 0; row < priv->nrows; row++)
|
|
{
|
|
height += priv->rows[row].requisition;
|
|
if (priv->rows[row].expand)
|
|
nexpand += 1;
|
|
if (priv->rows[row].shrink)
|
|
nshrink += 1;
|
|
}
|
|
for (row = 0; row + 1 < priv->nrows; row++)
|
|
height += priv->rows[row].spacing;
|
|
|
|
/* Check to see if we were allocated more height than we requested.
|
|
*/
|
|
if ((height < real_height) && (nexpand >= 1))
|
|
{
|
|
height = real_height - height;
|
|
|
|
for (row = 0; row < priv->nrows; row++)
|
|
if (priv->rows[row].expand)
|
|
{
|
|
extra = height / nexpand;
|
|
priv->rows[row].allocation += extra;
|
|
|
|
height -= extra;
|
|
nexpand -= 1;
|
|
}
|
|
}
|
|
|
|
/* Check to see if we were allocated less height than we requested.
|
|
* then shrink until we fit the size give.
|
|
*/
|
|
if (height > real_height)
|
|
{
|
|
gint total_nshrink = nshrink;
|
|
|
|
extra = height - real_height;
|
|
while (total_nshrink > 0 && extra > 0)
|
|
{
|
|
nshrink = total_nshrink;
|
|
for (row = 0; row < priv->nrows; row++)
|
|
if (priv->rows[row].shrink)
|
|
{
|
|
gint allocation = priv->rows[row].allocation;
|
|
|
|
priv->rows[row].allocation = MAX (1, (gint) priv->rows[row].allocation - extra / nshrink);
|
|
extra -= allocation - priv->rows[row].allocation;
|
|
nshrink -= 1;
|
|
if (priv->rows[row].allocation < 2)
|
|
{
|
|
total_nshrink -= 1;
|
|
priv->rows[row].shrink = FALSE;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_table_size_allocate_pass2 (GtkTable *table)
|
|
{
|
|
GtkTablePrivate *priv = table->priv;
|
|
GtkTableChild *child;
|
|
GList *children;
|
|
gint max_width;
|
|
gint max_height;
|
|
gint x, y;
|
|
gint row, col;
|
|
GtkAllocation allocation;
|
|
GtkAllocation table_allocation, widget_allocation;
|
|
GtkWidget *widget = GTK_WIDGET (table);
|
|
|
|
children = priv->children;
|
|
while (children)
|
|
{
|
|
child = children->data;
|
|
children = children->next;
|
|
|
|
if (gtk_widget_get_visible (child->widget))
|
|
{
|
|
GtkRequisition child_requisition;
|
|
|
|
gtk_widget_get_preferred_size (child->widget,
|
|
&child_requisition, NULL);
|
|
|
|
gtk_widget_get_allocation (GTK_WIDGET (table), &table_allocation);
|
|
x = table_allocation.x;
|
|
y = table_allocation.y;
|
|
max_width = 0;
|
|
max_height = 0;
|
|
|
|
for (col = 0; col < child->left_attach; col++)
|
|
{
|
|
x += priv->cols[col].allocation;
|
|
x += priv->cols[col].spacing;
|
|
}
|
|
|
|
for (col = child->left_attach; col < child->right_attach; col++)
|
|
{
|
|
max_width += priv->cols[col].allocation;
|
|
if ((col + 1) < child->right_attach)
|
|
max_width += priv->cols[col].spacing;
|
|
}
|
|
|
|
for (row = 0; row < child->top_attach; row++)
|
|
{
|
|
y += priv->rows[row].allocation;
|
|
y += priv->rows[row].spacing;
|
|
}
|
|
|
|
for (row = child->top_attach; row < child->bottom_attach; row++)
|
|
{
|
|
max_height += priv->rows[row].allocation;
|
|
if ((row + 1) < child->bottom_attach)
|
|
max_height += priv->rows[row].spacing;
|
|
}
|
|
|
|
if (child->xfill)
|
|
{
|
|
allocation.width = MAX (1, max_width - (gint)child->xpadding * 2);
|
|
allocation.x = x + (max_width - allocation.width) / 2;
|
|
}
|
|
else
|
|
{
|
|
allocation.width = child_requisition.width;
|
|
allocation.x = x + (max_width - allocation.width) / 2;
|
|
}
|
|
|
|
if (child->yfill)
|
|
{
|
|
allocation.height = MAX (1, max_height - (gint)child->ypadding * 2);
|
|
allocation.y = y + (max_height - allocation.height) / 2;
|
|
}
|
|
else
|
|
{
|
|
allocation.height = child_requisition.height;
|
|
allocation.y = y + (max_height - allocation.height) / 2;
|
|
}
|
|
|
|
gtk_widget_get_allocation (widget, &widget_allocation);
|
|
if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL)
|
|
allocation.x = widget_allocation.x + widget_allocation.width
|
|
- (allocation.x - widget_allocation.x) - allocation.width;
|
|
|
|
gtk_widget_size_allocate (child->widget, &allocation);
|
|
}
|
|
}
|
|
}
|