mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-11-13 04:10:13 +00:00
f37a0627fc
2001-08-07 Havoc Pennington <hp@pobox.com>
* gtk/gtkfilesel.c (open_ref_dir): fix a typo.
* gtk/gtkplug.c (gtk_plug_init): remove setting of auto_shrink;
some fixage is needed here, but nothing simple. Owen understands
it. ;-)
* gtk/gtkwindow.h, gtk/gtkwindow.c: Rework code and API for window
sizing and positioning. Also, fix bug in compute_geometry_hints
(width/height confusion for setting min size).
(gtk_window_move): new function
(gtk_window_resize): new function
(gtk_window_get_size): new function
(gtk_window_get_position): new function
(gtk_window_parse_geometry): new function
* gtk/gtkwidget.c (gtk_widget_set_size_request): new function
(gtk_widget_get_size_request): new function
(gtk_widget_get_usize): delete, that was a short-lived function
;-)
(gtk_widget_set_usize): deprecate
(gtk_widget_set_uposition): deprecate, make it a trivial
gtk_window_move() wrapper
(gtk_widget_class_init): remove x/y/width/height properties,
add width_request height_request
* demos/*: update to avoid deprecated functions
* gtk/gtklayout.c: add x/y child properties
* gtk/gtkfixed.c: add x/y child properties, and get rid of
uses of "gint16"
* tests/testgtk.c (create_window_sizing): lots of tweaks to window
sizing test
* gdk/x11/gdkevents-x11.c (gdk_event_translate): Ensure that
configure events on toplevel windows are always in root window
coordinates, following ICCCM spec that all synthetic events
are in root window coords already, while real events are
in parent window coords. Previously the code assumed that
coords of 0,0 were parent window coords, which was
really broken.
* gtk/gtkcontainer.c (gtk_container_get_focus_chain): fix
warning
* gdk/gdkwindow.h (GdkWindowHints): add GDK_HINT_USER_POS
and GDK_HINT_USER_SIZE so we can set USSize and USPosition
hints in gtk_window_parse_geometry()
* gdk/x11/gdkwindow-x11.c (gdk_window_set_geometry_hints): support
new USER_POS USER_SIZE hints
524 lines
18 KiB
C
524 lines
18 KiB
C
#ifndef __GDK_WINDOW_H__
|
|
#define __GDK_WINDOW_H__
|
|
|
|
#include <gdk/gdkdrawable.h>
|
|
#include <gdk/gdktypes.h>
|
|
#include <gdk/gdkwindow.h>
|
|
#include <gdk/gdkevents.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif /* __cplusplus */
|
|
|
|
typedef struct _GdkGeometry GdkGeometry;
|
|
typedef struct _GdkWindowAttr GdkWindowAttr;
|
|
typedef struct _GdkPointerHooks GdkPointerHooks;
|
|
|
|
/* Classes of windows.
|
|
* InputOutput: Almost every window should be of this type. Such windows
|
|
* receive events and are also displayed on screen.
|
|
* InputOnly: Used only in special circumstances when events need to be
|
|
* stolen from another window or windows. Input only windows
|
|
* have no visible output, so they are handy for placing over
|
|
* top of a group of windows in order to grab the events (or
|
|
* filter the events) from those windows.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GDK_INPUT_OUTPUT,
|
|
GDK_INPUT_ONLY
|
|
} GdkWindowClass;
|
|
|
|
/* Types of windows.
|
|
* Root: There is only 1 root window and it is initialized
|
|
* at startup. Creating a window of type GDK_WINDOW_ROOT
|
|
* is an error.
|
|
* Toplevel: Windows which interact with the window manager.
|
|
* Child: Windows which are children of some other type of window.
|
|
* (Any other type of window). Most windows are child windows.
|
|
* Dialog: A special kind of toplevel window which interacts with
|
|
* the window manager slightly differently than a regular
|
|
* toplevel window. Dialog windows should be used for any
|
|
* transient window.
|
|
* Foreign: A window that actually belongs to another application
|
|
*/
|
|
typedef enum
|
|
{
|
|
GDK_WINDOW_ROOT,
|
|
GDK_WINDOW_TOPLEVEL,
|
|
GDK_WINDOW_CHILD,
|
|
GDK_WINDOW_DIALOG,
|
|
GDK_WINDOW_TEMP,
|
|
GDK_WINDOW_FOREIGN
|
|
} GdkWindowType;
|
|
|
|
/* Window attribute mask values.
|
|
* GDK_WA_TITLE: The "title" field is valid.
|
|
* GDK_WA_X: The "x" field is valid.
|
|
* GDK_WA_Y: The "y" field is valid.
|
|
* GDK_WA_CURSOR: The "cursor" field is valid.
|
|
* GDK_WA_COLORMAP: The "colormap" field is valid.
|
|
* GDK_WA_VISUAL: The "visual" field is valid.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GDK_WA_TITLE = 1 << 1,
|
|
GDK_WA_X = 1 << 2,
|
|
GDK_WA_Y = 1 << 3,
|
|
GDK_WA_CURSOR = 1 << 4,
|
|
GDK_WA_COLORMAP = 1 << 5,
|
|
GDK_WA_VISUAL = 1 << 6,
|
|
GDK_WA_WMCLASS = 1 << 7,
|
|
GDK_WA_NOREDIR = 1 << 8
|
|
} GdkWindowAttributesType;
|
|
|
|
/* Size restriction enumeration.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GDK_HINT_POS = 1 << 0,
|
|
GDK_HINT_MIN_SIZE = 1 << 1,
|
|
GDK_HINT_MAX_SIZE = 1 << 2,
|
|
GDK_HINT_BASE_SIZE = 1 << 3,
|
|
GDK_HINT_ASPECT = 1 << 4,
|
|
GDK_HINT_RESIZE_INC = 1 << 5,
|
|
GDK_HINT_WIN_GRAVITY = 1 << 6,
|
|
GDK_HINT_USER_POS = 1 << 7,
|
|
GDK_HINT_USER_SIZE = 1 << 8
|
|
} GdkWindowHints;
|
|
|
|
|
|
/* Window type hints.
|
|
* These are hints for the window manager that indicate
|
|
* what type of function the window has. The window manager
|
|
* can use this when determining decoration and behaviour
|
|
* of the window. The hint must be set before mapping the
|
|
* window.
|
|
*
|
|
* Normal: Normal toplevel window
|
|
* Dialog: Dialog window
|
|
* Menu: Window used to implement a menu.
|
|
* Toolbar: Window used to implement toolbars.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GDK_WINDOW_TYPE_HINT_NORMAL,
|
|
GDK_WINDOW_TYPE_HINT_DIALOG,
|
|
GDK_WINDOW_TYPE_HINT_MENU,
|
|
GDK_WINDOW_TYPE_HINT_TOOLBAR
|
|
} GdkWindowTypeHint;
|
|
|
|
|
|
/* The next two enumeration values current match the
|
|
* Motif constants. If this is changed, the implementation
|
|
* of gdk_window_set_decorations/gdk_window_set_functions
|
|
* will need to change as well.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GDK_DECOR_ALL = 1 << 0,
|
|
GDK_DECOR_BORDER = 1 << 1,
|
|
GDK_DECOR_RESIZEH = 1 << 2,
|
|
GDK_DECOR_TITLE = 1 << 3,
|
|
GDK_DECOR_MENU = 1 << 4,
|
|
GDK_DECOR_MINIMIZE = 1 << 5,
|
|
GDK_DECOR_MAXIMIZE = 1 << 6
|
|
} GdkWMDecoration;
|
|
|
|
typedef enum
|
|
{
|
|
GDK_FUNC_ALL = 1 << 0,
|
|
GDK_FUNC_RESIZE = 1 << 1,
|
|
GDK_FUNC_MOVE = 1 << 2,
|
|
GDK_FUNC_MINIMIZE = 1 << 3,
|
|
GDK_FUNC_MAXIMIZE = 1 << 4,
|
|
GDK_FUNC_CLOSE = 1 << 5
|
|
} GdkWMFunction;
|
|
|
|
/* Currently, these are the same values numerically as in the
|
|
* X protocol. If you change that, gdkwindow-x11.c/gdk_window_set_geometry_hints()
|
|
* will need fixing.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GDK_GRAVITY_NORTH_WEST = 1,
|
|
GDK_GRAVITY_NORTH,
|
|
GDK_GRAVITY_NORTH_EAST,
|
|
GDK_GRAVITY_WEST,
|
|
GDK_GRAVITY_CENTER,
|
|
GDK_GRAVITY_EAST,
|
|
GDK_GRAVITY_SOUTH_WEST,
|
|
GDK_GRAVITY_SOUTH,
|
|
GDK_GRAVITY_SOUTH_EAST,
|
|
GDK_GRAVITY_STATIC
|
|
} GdkGravity;
|
|
|
|
|
|
typedef enum
|
|
{
|
|
GDK_WINDOW_EDGE_NORTH_WEST,
|
|
GDK_WINDOW_EDGE_NORTH,
|
|
GDK_WINDOW_EDGE_NORTH_EAST,
|
|
GDK_WINDOW_EDGE_WEST,
|
|
GDK_WINDOW_EDGE_EAST,
|
|
GDK_WINDOW_EDGE_SOUTH_WEST,
|
|
GDK_WINDOW_EDGE_SOUTH,
|
|
GDK_WINDOW_EDGE_SOUTH_EAST
|
|
} GdkWindowEdge;
|
|
|
|
struct _GdkWindowAttr
|
|
{
|
|
gchar *title;
|
|
gint event_mask;
|
|
gint x, y;
|
|
gint width;
|
|
gint height;
|
|
GdkWindowClass wclass;
|
|
GdkVisual *visual;
|
|
GdkColormap *colormap;
|
|
GdkWindowType window_type;
|
|
GdkCursor *cursor;
|
|
gchar *wmclass_name;
|
|
gchar *wmclass_class;
|
|
gboolean override_redirect;
|
|
};
|
|
|
|
struct _GdkGeometry
|
|
{
|
|
gint min_width;
|
|
gint min_height;
|
|
gint max_width;
|
|
gint max_height;
|
|
gint base_width;
|
|
gint base_height;
|
|
gint width_inc;
|
|
gint height_inc;
|
|
gdouble min_aspect;
|
|
gdouble max_aspect;
|
|
GdkGravity win_gravity;
|
|
};
|
|
|
|
struct _GdkPointerHooks
|
|
{
|
|
GdkWindow* (*get_pointer) (GdkWindow *window,
|
|
gint *x,
|
|
gint *y,
|
|
GdkModifierType *mask);
|
|
GdkWindow* (*window_at_pointer) (gint *win_x,
|
|
gint *win_y);
|
|
};
|
|
|
|
typedef struct _GdkWindowObject GdkWindowObject;
|
|
typedef struct _GdkWindowObjectClass GdkWindowObjectClass;
|
|
|
|
#define GDK_TYPE_WINDOW (gdk_window_object_get_type ())
|
|
#define GDK_WINDOW(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_WINDOW, GdkWindow))
|
|
#define GDK_WINDOW_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_WINDOW, GdkWindowObjectClass))
|
|
#define GDK_IS_WINDOW(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_WINDOW))
|
|
#define GDK_IS_WINDOW_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_WINDOW))
|
|
#define GDK_WINDOW_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_WINDOW, GdkWindowObjectClass))
|
|
#define GDK_WINDOW_OBJECT(object) ((GdkWindowObject *) GDK_WINDOW (object))
|
|
|
|
struct _GdkWindowObject
|
|
{
|
|
GdkDrawable parent_instance;
|
|
|
|
GdkDrawable *impl; /* window-system-specific delegate object */
|
|
|
|
GdkWindowObject *parent;
|
|
|
|
gpointer user_data;
|
|
|
|
gint x;
|
|
gint y;
|
|
|
|
gint extension_events;
|
|
|
|
GList *filters;
|
|
GList *children;
|
|
|
|
GdkColor bg_color;
|
|
GdkPixmap *bg_pixmap;
|
|
|
|
GSList *paint_stack;
|
|
|
|
GdkRegion *update_area;
|
|
guint update_freeze_count;
|
|
|
|
guint8 window_type;
|
|
guint8 depth;
|
|
guint8 resize_count;
|
|
|
|
GdkWindowState state;
|
|
|
|
guint guffaw_gravity : 1;
|
|
guint input_only : 1;
|
|
guint modal_hint : 1;
|
|
|
|
guint destroyed : 2;
|
|
};
|
|
|
|
struct _GdkWindowObjectClass
|
|
{
|
|
GdkDrawableClass parent_class;
|
|
};
|
|
|
|
/* Windows
|
|
*/
|
|
GType gdk_window_object_get_type (void) G_GNUC_CONST;
|
|
GdkWindow* gdk_window_new (GdkWindow *parent,
|
|
GdkWindowAttr *attributes,
|
|
gint attributes_mask);
|
|
void gdk_window_destroy (GdkWindow *window);
|
|
GdkWindowType gdk_window_get_window_type (GdkWindow *window);
|
|
GdkWindow* gdk_window_at_pointer (gint *win_x,
|
|
gint *win_y);
|
|
void gdk_window_show (GdkWindow *window);
|
|
void gdk_window_hide (GdkWindow *window);
|
|
void gdk_window_withdraw (GdkWindow *window);
|
|
void gdk_window_show_unraised (GdkWindow *window);
|
|
void gdk_window_move (GdkWindow *window,
|
|
gint x,
|
|
gint y);
|
|
void gdk_window_resize (GdkWindow *window,
|
|
gint width,
|
|
gint height);
|
|
void gdk_window_move_resize (GdkWindow *window,
|
|
gint x,
|
|
gint y,
|
|
gint width,
|
|
gint height);
|
|
void gdk_window_reparent (GdkWindow *window,
|
|
GdkWindow *new_parent,
|
|
gint x,
|
|
gint y);
|
|
void gdk_window_clear (GdkWindow *window);
|
|
void gdk_window_clear_area (GdkWindow *window,
|
|
gint x,
|
|
gint y,
|
|
gint width,
|
|
gint height);
|
|
void gdk_window_clear_area_e (GdkWindow *window,
|
|
gint x,
|
|
gint y,
|
|
gint width,
|
|
gint height);
|
|
void gdk_window_raise (GdkWindow *window);
|
|
void gdk_window_lower (GdkWindow *window);
|
|
void gdk_window_focus (GdkWindow *window,
|
|
guint32 timestamp);
|
|
void gdk_window_set_user_data (GdkWindow *window,
|
|
gpointer user_data);
|
|
void gdk_window_set_override_redirect (GdkWindow *window,
|
|
gboolean override_redirect);
|
|
void gdk_window_add_filter (GdkWindow *window,
|
|
GdkFilterFunc function,
|
|
gpointer data);
|
|
void gdk_window_remove_filter (GdkWindow *window,
|
|
GdkFilterFunc function,
|
|
gpointer data);
|
|
void gdk_window_scroll (GdkWindow *window,
|
|
gint dx,
|
|
gint dy);
|
|
|
|
/*
|
|
* This allows for making shaped (partially transparent) windows
|
|
* - cool feature, needed for Drag and Drag for example.
|
|
* The shape_mask can be the mask
|
|
* from gdk_pixmap_create_from_xpm. Stefan Wille
|
|
*/
|
|
void gdk_window_shape_combine_mask (GdkWindow *window,
|
|
GdkBitmap *shape_mask,
|
|
gint offset_x,
|
|
gint offset_y);
|
|
void gdk_window_shape_combine_region (GdkWindow *window,
|
|
GdkRegion *shape_region,
|
|
gint offset_x,
|
|
gint offset_y);
|
|
|
|
/*
|
|
* This routine allows you to quickly take the shapes of all the child windows
|
|
* of a window and use their shapes as the shape mask for this window - useful
|
|
* for container windows that dont want to look like a big box
|
|
*
|
|
* - Raster
|
|
*/
|
|
void gdk_window_set_child_shapes (GdkWindow *window);
|
|
|
|
/*
|
|
* This routine allows you to merge (ie ADD) child shapes to your
|
|
* own window's shape keeping its current shape and ADDING the child
|
|
* shapes to it.
|
|
*
|
|
* - Raster
|
|
*/
|
|
void gdk_window_merge_child_shapes (GdkWindow *window);
|
|
|
|
/*
|
|
* Check if a window has been shown, and whether all its
|
|
* parents up to a toplevel have been shown, respectively.
|
|
* Note that a window that is_viewable below is not necessarily
|
|
* viewable in the X sense.
|
|
*/
|
|
gboolean gdk_window_is_visible (GdkWindow *window);
|
|
gboolean gdk_window_is_viewable (GdkWindow *window);
|
|
|
|
GdkWindowState gdk_window_get_state (GdkWindow *window);
|
|
|
|
/* Set static bit gravity on the parent, and static
|
|
* window gravity on all children.
|
|
*/
|
|
gboolean gdk_window_set_static_gravities (GdkWindow *window,
|
|
gboolean use_static);
|
|
|
|
/* GdkWindow */
|
|
|
|
void gdk_window_set_hints (GdkWindow *window,
|
|
gint x,
|
|
gint y,
|
|
gint min_width,
|
|
gint min_height,
|
|
gint max_width,
|
|
gint max_height,
|
|
gint flags);
|
|
void gdk_window_set_type_hint (GdkWindow *window,
|
|
GdkWindowTypeHint hint);
|
|
void gdk_window_set_modal_hint (GdkWindow *window,
|
|
gboolean modal);
|
|
void gdk_window_set_geometry_hints (GdkWindow *window,
|
|
GdkGeometry *geometry,
|
|
GdkWindowHints flags);
|
|
void gdk_set_sm_client_id (const gchar *sm_client_id);
|
|
|
|
void gdk_window_begin_paint_rect (GdkWindow *window,
|
|
GdkRectangle *rectangle);
|
|
void gdk_window_begin_paint_region (GdkWindow *window,
|
|
GdkRegion *region);
|
|
void gdk_window_end_paint (GdkWindow *window);
|
|
|
|
void gdk_window_set_title (GdkWindow *window,
|
|
const gchar *title);
|
|
void gdk_window_set_role (GdkWindow *window,
|
|
const gchar *role);
|
|
void gdk_window_set_transient_for (GdkWindow *window,
|
|
GdkWindow *leader);
|
|
void gdk_window_set_background (GdkWindow *window,
|
|
GdkColor *color);
|
|
void gdk_window_set_back_pixmap (GdkWindow *window,
|
|
GdkPixmap *pixmap,
|
|
gboolean parent_relative);
|
|
void gdk_window_set_cursor (GdkWindow *window,
|
|
GdkCursor *cursor);
|
|
void gdk_window_get_user_data (GdkWindow *window,
|
|
gpointer *data);
|
|
void gdk_window_get_geometry (GdkWindow *window,
|
|
gint *x,
|
|
gint *y,
|
|
gint *width,
|
|
gint *height,
|
|
gint *depth);
|
|
void gdk_window_get_position (GdkWindow *window,
|
|
gint *x,
|
|
gint *y);
|
|
gint gdk_window_get_origin (GdkWindow *window,
|
|
gint *x,
|
|
gint *y);
|
|
gboolean gdk_window_get_deskrelative_origin (GdkWindow *window,
|
|
gint *x,
|
|
gint *y);
|
|
void gdk_window_get_root_origin (GdkWindow *window,
|
|
gint *x,
|
|
gint *y);
|
|
void gdk_window_get_frame_extents (GdkWindow *window,
|
|
GdkRectangle *rect);
|
|
GdkWindow* gdk_window_get_pointer (GdkWindow *window,
|
|
gint *x,
|
|
gint *y,
|
|
GdkModifierType *mask);
|
|
GdkWindow * gdk_window_get_parent (GdkWindow *window);
|
|
GdkWindow * gdk_window_get_toplevel (GdkWindow *window);
|
|
|
|
GList * gdk_window_get_children (GdkWindow *window);
|
|
GList * gdk_window_peek_children (GdkWindow *window);
|
|
GdkEventMask gdk_window_get_events (GdkWindow *window);
|
|
void gdk_window_set_events (GdkWindow *window,
|
|
GdkEventMask event_mask);
|
|
|
|
gboolean gdk_window_set_icon_list (GdkWindow *window,
|
|
GList *pixbufs);
|
|
void gdk_window_set_icon (GdkWindow *window,
|
|
GdkWindow *icon_window,
|
|
GdkPixmap *pixmap,
|
|
GdkBitmap *mask);
|
|
void gdk_window_set_icon_name (GdkWindow *window,
|
|
const gchar *name);
|
|
void gdk_window_set_group (GdkWindow *window,
|
|
GdkWindow *leader);
|
|
void gdk_window_set_decorations (GdkWindow *window,
|
|
GdkWMDecoration decorations);
|
|
gboolean gdk_window_get_decorations (GdkWindow *window,
|
|
GdkWMDecoration *decorations);
|
|
void gdk_window_set_functions (GdkWindow *window,
|
|
GdkWMFunction functions);
|
|
GList * gdk_window_get_toplevels (void);
|
|
|
|
void gdk_window_iconify (GdkWindow *window);
|
|
void gdk_window_deiconify (GdkWindow *window);
|
|
void gdk_window_stick (GdkWindow *window);
|
|
void gdk_window_unstick (GdkWindow *window);
|
|
void gdk_window_maximize (GdkWindow *window);
|
|
void gdk_window_unmaximize (GdkWindow *window);
|
|
|
|
void gdk_window_register_dnd (GdkWindow *window);
|
|
|
|
void gdk_window_begin_resize_drag (GdkWindow *window,
|
|
GdkWindowEdge edge,
|
|
gint button,
|
|
gint root_x,
|
|
gint root_y,
|
|
guint32 timestamp);
|
|
void gdk_window_begin_move_drag (GdkWindow *window,
|
|
gint button,
|
|
gint root_x,
|
|
gint root_y,
|
|
guint32 timestamp);
|
|
|
|
/* Interface for dirty-region queueing */
|
|
void gdk_window_invalidate_rect (GdkWindow *window,
|
|
GdkRectangle *rect,
|
|
gboolean invalidate_children);
|
|
void gdk_window_invalidate_region (GdkWindow *window,
|
|
GdkRegion *region,
|
|
gboolean invalidate_children);
|
|
GdkRegion *gdk_window_get_update_area (GdkWindow *window);
|
|
|
|
void gdk_window_freeze_updates (GdkWindow *window);
|
|
void gdk_window_thaw_updates (GdkWindow *window);
|
|
|
|
void gdk_window_process_all_updates (void);
|
|
void gdk_window_process_updates (GdkWindow *window,
|
|
gboolean update_children);
|
|
|
|
/* Enable/disable flicker, so you can tell if your code is inefficient. */
|
|
void gdk_window_set_debug_updates (gboolean setting);
|
|
|
|
void gdk_window_constrain_size (GdkGeometry *geometry,
|
|
guint flags,
|
|
gint width,
|
|
gint height,
|
|
gint *new_width,
|
|
gint *new_height);
|
|
|
|
void gdk_window_get_internal_paint_info (GdkWindow *window,
|
|
GdkDrawable **real_drawable,
|
|
gint *x_offset,
|
|
gint *y_offset);
|
|
|
|
GdkPointerHooks *gdk_set_pointer_hooks (const GdkPointerHooks *new_hooks);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* __cplusplus */
|
|
|
|
#endif /* __GDK_WINDOW_H__ */
|