forked from AuroraMiddleware/gtk
77eee887f3
2002-08-10 Soren Sandmann <sandmann@daimi.au.dk> * docs/reference/gtk/tree_widget.sgml, docs/reference/gtk/tmpl/gtkdialog.sgml, docs/reference/gtk/tmpl/gtkentry.sgml, docs/reference/gtk/tmpl/gtkfilesel.sgml, docs/reference/gtk/tmpl/gtkfontsel.sgml, docs/reference/gtk/tmpl/gtkfontseldlg.sgml, docs/reference/gtk/tmpl/gtktreemodel.sgml, docs/reference/gtk/tmpl/gtkwidget.sgml, gdk/x11/gdkdisplay-x11.c, gtk/gtkbbox.c, gtk/gtkbox.c, gtk/gtkbutton.c, gtk/gtkcellrenderer.c, gtk/gtkcellrendererpixbuf.c, gtk/gtkcellrenderertext.c, gtk/gtkcheckmenuitem.c, gtk/gtkcontainer.c, gtk/gtkcurve.c, gtk/gtkdialog.h, gtk/gtkentry.c, gtk/gtkfilesel.c, gtk/gtkfontsel.c, gtk/gtkframe.c, gtk/gtkhandlebox.c, gtk/gtkiconfactory.c, gtk/gtkimage.c, gtk/gtkinvisible.c, gtk/gtkitemfactory.c, gtk/gtklabel.c, gtk/gtklayout.c, gtk/gtkmenu.c, gtk/gtkprogress.c, gtk/gtkprogressbar.c, gtk/gtkscrolledwindow.c, gtk/gtksizegroup.c, gtk/gtktable.c, gtk/gtktextiter.c, gtk/gtktexttag.c, gtk/gtktexttag.h, gtk/gtktextview.c, gtk/gtktogglebutton.c, gtk/gtktoolbar.c, gtk/gtktreemodel.c, gtk/gtktreeselection.c, gtk/gtktreestore.c, gtk/gtktreeview.c, gtk/gtktreeviewcolumn.c, gtk/gtkviewport.c, gtk/gtkwidget.c, gtk/gtkwidget.h, gtk/gtkwindow.c: Minor documentation fixes (#89254, patch from Brett Nash; #85809, patch from daten@dnetc.org; #76391, patch from Ross Burton; #74559, Manuel Clos; #73569, #72005, Alexey A. Malyshev; #70061, patch from Dennis Bj"orklund; #64566, #63388, #58328, #57499, #81007, #77349, Vitaly Tishkov; #78932, Vitaly Tishkov, patch from Ross Burton; #73306)
333 lines
8.7 KiB
C
333 lines
8.7 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, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
/*
|
|
* 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 <gdk/gdk.h>
|
|
#include "gtksignal.h"
|
|
#include "gtkinvisible.h"
|
|
#include "gtkintl.h"
|
|
|
|
enum {
|
|
PROP_0,
|
|
PROP_SCREEN,
|
|
LAST_ARG
|
|
};
|
|
|
|
static void gtk_invisible_class_init (GtkInvisibleClass *klass);
|
|
static void gtk_invisible_init (GtkInvisible *invisible);
|
|
static void gtk_invisible_destroy (GtkObject *object);
|
|
static void gtk_invisible_realize (GtkWidget *widget);
|
|
static void gtk_invisible_style_set (GtkWidget *widget,
|
|
GtkStyle *previous_style);
|
|
static void gtk_invisible_show (GtkWidget *widget);
|
|
static void gtk_invisible_size_allocate (GtkWidget *widget,
|
|
GtkAllocation *allocation);
|
|
static void gtk_invisible_set_property (GObject *object,
|
|
guint prop_id,
|
|
const GValue *value,
|
|
GParamSpec *pspec);
|
|
static void gtk_invisible_get_property (GObject *object,
|
|
guint prop_id,
|
|
GValue *value,
|
|
GParamSpec *pspec);
|
|
|
|
static GObject *gtk_invisible_constructor (GType type,
|
|
guint n_construct_properties,
|
|
GObjectConstructParam *construct_params);
|
|
|
|
GObjectClass *parent_class;
|
|
|
|
GtkType
|
|
gtk_invisible_get_type (void)
|
|
{
|
|
static GtkType invisible_type = 0;
|
|
|
|
if (!invisible_type)
|
|
{
|
|
static const GtkTypeInfo invisible_info =
|
|
{
|
|
"GtkInvisible",
|
|
sizeof (GtkInvisible),
|
|
sizeof (GtkInvisibleClass),
|
|
(GtkClassInitFunc) gtk_invisible_class_init,
|
|
(GtkObjectInitFunc) gtk_invisible_init,
|
|
/* reserved_1 */ NULL,
|
|
/* reserved_2 */ NULL,
|
|
(GtkClassInitFunc) NULL,
|
|
};
|
|
|
|
invisible_type = gtk_type_unique (GTK_TYPE_WIDGET, &invisible_info);
|
|
}
|
|
|
|
return invisible_type;
|
|
}
|
|
|
|
static void
|
|
gtk_invisible_class_init (GtkInvisibleClass *class)
|
|
{
|
|
GObjectClass *gobject_class;
|
|
GtkObjectClass *object_class;
|
|
GtkWidgetClass *widget_class;
|
|
|
|
widget_class = (GtkWidgetClass*) class;
|
|
object_class = (GtkObjectClass*) class;
|
|
gobject_class = (GObjectClass*) class;
|
|
|
|
parent_class = g_type_class_peek_parent (class);
|
|
|
|
widget_class->realize = gtk_invisible_realize;
|
|
widget_class->style_set = gtk_invisible_style_set;
|
|
widget_class->show = gtk_invisible_show;
|
|
widget_class->size_allocate = gtk_invisible_size_allocate;
|
|
|
|
object_class->destroy = gtk_invisible_destroy;
|
|
gobject_class->set_property = gtk_invisible_set_property;
|
|
gobject_class->get_property = gtk_invisible_get_property;
|
|
gobject_class->constructor = gtk_invisible_constructor;
|
|
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_SCREEN,
|
|
g_param_spec_object ("screen",
|
|
_("Screen"),
|
|
_("The screen where this window will be displayed"),
|
|
GDK_TYPE_SCREEN,
|
|
G_PARAM_READWRITE));
|
|
}
|
|
|
|
static void
|
|
gtk_invisible_init (GtkInvisible *invisible)
|
|
{
|
|
GdkColormap *colormap;
|
|
|
|
GTK_WIDGET_UNSET_FLAGS (invisible, GTK_NO_WINDOW);
|
|
GTK_WIDGET_SET_FLAGS (invisible, GTK_TOPLEVEL);
|
|
|
|
gtk_widget_ref (GTK_WIDGET (invisible));
|
|
gtk_object_sink (GTK_OBJECT (invisible));
|
|
|
|
invisible->has_user_ref_count = TRUE;
|
|
invisible->screen = gdk_screen_get_default ();
|
|
|
|
colormap = _gtk_widget_peek_colormap ();
|
|
if (colormap)
|
|
gtk_widget_set_colormap (GTK_WIDGET (invisible), colormap);
|
|
}
|
|
|
|
static void
|
|
gtk_invisible_destroy (GtkObject *object)
|
|
{
|
|
GtkInvisible *invisible = GTK_INVISIBLE (object);
|
|
|
|
if (invisible->has_user_ref_count)
|
|
{
|
|
invisible->has_user_ref_count = FALSE;
|
|
gtk_widget_unref (GTK_WIDGET (invisible));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gtk_invisible_new_for_screen:
|
|
* @screen: a #GdkScreen which identifies on which
|
|
* the new #GtkInvisible will be created.
|
|
*
|
|
* Creates a new #GtkInvisible object for a specified screen
|
|
*
|
|
* Return value: a newly created #GtkInvisible object
|
|
**/
|
|
GtkWidget*
|
|
gtk_invisible_new_for_screen (GdkScreen *screen)
|
|
{
|
|
g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL);
|
|
|
|
return g_object_new (GTK_TYPE_INVISIBLE, "screen", screen, NULL);
|
|
}
|
|
|
|
/**
|
|
* gtk_invisible_new:
|
|
*
|
|
* Creates a new #GtkInvisible.
|
|
*
|
|
* Return value: a new #GtkInvisible.
|
|
**/
|
|
GtkWidget*
|
|
gtk_invisible_new (void)
|
|
{
|
|
return g_object_new (GTK_TYPE_INVISIBLE, NULL);
|
|
}
|
|
|
|
/**
|
|
* gtk_invisible_set_screen:
|
|
* @invisible: a #GtkInvisible.
|
|
* @screen: a #GdkScreen.
|
|
*
|
|
* Sets the #GdkScreen where the #GtkInvisible object will be displayed.
|
|
**/
|
|
void
|
|
gtk_invisible_set_screen (GtkInvisible *invisible,
|
|
GdkScreen *screen)
|
|
{
|
|
gboolean was_realized;
|
|
|
|
g_return_if_fail (GTK_IS_INVISIBLE (invisible));
|
|
g_return_if_fail (GDK_IS_SCREEN (screen));
|
|
|
|
if (screen == invisible->screen)
|
|
return;
|
|
|
|
was_realized = GTK_WIDGET_REALIZED (invisible);
|
|
|
|
if (was_realized)
|
|
gtk_widget_unrealize (GTK_WIDGET (invisible));
|
|
|
|
invisible->screen = screen;
|
|
g_object_notify (G_OBJECT (invisible), "screen");
|
|
|
|
if (was_realized)
|
|
gtk_widget_realize (GTK_WIDGET (invisible));
|
|
}
|
|
|
|
/**
|
|
* gtk_invisible_get_screen:
|
|
* @invisible: a #GtkInvisible.
|
|
*
|
|
* Returns the #GdkScreen object associated with @invisible
|
|
*
|
|
* Return value : the associated #GdkScreen.
|
|
**/
|
|
GdkScreen *
|
|
gtk_invisible_get_screen (GtkInvisible *invisible)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_INVISIBLE (invisible), NULL);
|
|
|
|
return invisible->screen;
|
|
}
|
|
|
|
static void
|
|
gtk_invisible_realize (GtkWidget *widget)
|
|
{
|
|
GdkWindowAttr attributes;
|
|
gint attributes_mask;
|
|
|
|
GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
|
|
|
|
attributes.x = -100;
|
|
attributes.y = -100;
|
|
attributes.width = 10;
|
|
attributes.height = 10;
|
|
attributes.window_type = GDK_WINDOW_TEMP;
|
|
attributes.wclass = GDK_INPUT_ONLY;
|
|
attributes.override_redirect = TRUE;
|
|
attributes.event_mask = gtk_widget_get_events (widget);
|
|
|
|
attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_NOREDIR;
|
|
|
|
widget->window = gdk_window_new (gtk_widget_get_root_window (widget),
|
|
&attributes, attributes_mask);
|
|
|
|
gdk_window_set_user_data (widget->window, widget);
|
|
|
|
widget->style = gtk_style_attach (widget->style, widget->window);
|
|
}
|
|
|
|
static void
|
|
gtk_invisible_style_set (GtkWidget *widget,
|
|
GtkStyle *previous_style)
|
|
{
|
|
/* Don't chain up to parent implementation */
|
|
}
|
|
|
|
static void
|
|
gtk_invisible_show (GtkWidget *widget)
|
|
{
|
|
GTK_WIDGET_SET_FLAGS (widget, GTK_VISIBLE);
|
|
gtk_widget_map (widget);
|
|
}
|
|
|
|
static void
|
|
gtk_invisible_size_allocate (GtkWidget *widget,
|
|
GtkAllocation *allocation)
|
|
{
|
|
widget->allocation = *allocation;
|
|
}
|
|
|
|
|
|
static void
|
|
gtk_invisible_set_property (GObject *object,
|
|
guint prop_id,
|
|
const GValue *value,
|
|
GParamSpec *pspec)
|
|
{
|
|
GtkInvisible *invisible = GTK_INVISIBLE (object);
|
|
|
|
switch (prop_id)
|
|
{
|
|
case PROP_SCREEN:
|
|
gtk_invisible_set_screen (invisible, g_value_get_object (value));
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_invisible_get_property (GObject *object,
|
|
guint prop_id,
|
|
GValue *value,
|
|
GParamSpec *pspec)
|
|
{
|
|
GtkInvisible *invisible = GTK_INVISIBLE (object);
|
|
|
|
switch (prop_id)
|
|
{
|
|
case PROP_SCREEN:
|
|
g_value_set_object (value, invisible->screen);
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
/* We use a constructor here so that we can realize the invisible on
|
|
* the correct screen after the "screen" property has been set
|
|
*/
|
|
static GObject*
|
|
gtk_invisible_constructor (GType type,
|
|
guint n_construct_properties,
|
|
GObjectConstructParam *construct_params)
|
|
{
|
|
GObject *object;
|
|
|
|
object = (* G_OBJECT_CLASS (parent_class)->constructor) (type,
|
|
n_construct_properties,
|
|
construct_params);
|
|
|
|
gtk_widget_realize (GTK_WIDGET (object));
|
|
|
|
return object;
|
|
}
|
|
|