Pileus Git - ~andy/gtk/blob - docs/reference/gdk/tmpl/windows.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 Windows
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 Onscreen display areas in the target window system
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para>
   9 A #GdkWindow is a rectangular region on the screen. It's a low-level object,
  10 used to implement high-level objects such as #GtkWidget and #GtkWindow on the
  11 GTK+ level. A #GtkWindow is a toplevel window, the thing a user might think of
  12 as a "window" with a titlebar and so on; a #GtkWindow may contain many #GdkWindow.
  13 For example, each #GtkButton has a #GdkWindow associated with it.
  14 </para>
  15 <example id="composited-window-example"><title>Composited windows</title>
  16 <programlisting><![CDATA[
  17 #include <gtk/gtk.h>
  18
  19 /* The expose event handler for the event box.
  20  *
  21  * This function simply draws a transparency onto a widget on the area
  22  * for which it receives expose events.  This is intended to give the
  23  * event box a "transparent" background.
  24  *
  25  * In order for this to work properly, the widget must have an RGBA
  26  * colourmap.  The widget should also be set as app-paintable since it
  27  * doesn't make sense for GTK+ to draw a background if we are drawing it
  28  * (and because GTK+ might actually replace our transparency with its
  29  * default background colour).
  30  */
  31 static gboolean
  32 transparent_expose (GtkWidget      *widget,
  33                     GdkEventExpose *event)
  34 {
  35   cairo_t *cr;
  36
  37   cr = gdk_cairo_create (widget->window);
  38   cairo_set_operator (cr, CAIRO_OPERATOR_CLEAR);
  39   gdk_cairo_region (cr, event->region);
  40   cairo_fill (cr);
  41   cairo_destroy (cr);
  42
  43   return FALSE;
  44 }
  45
  46 /* The expose event handler for the window.
  47  *
  48  * This function performs the actual compositing of the event box onto
  49  * the already-existing background of the window at 50% normal opacity.
  50  *
  51  * In this case we do not want app-paintable to be set on the widget
  52  * since we want it to draw its own (red) background. Because of this,
  53  * however, we must ensure that we use g_signal_connect_after so that
  54  * this handler is called after the red has been drawn. If it was
  55  * called before then GTK would just blindly paint over our work.
  56  *
  57  * Note: if the child window has children, then you need a cairo 1.16
  58  * feature to make this work correctly.
  59  */
  60 static gboolean
  61 window_expose_event (GtkWidget      *widget,
  62                      GdkEventExpose *event)
  63 {
  64   GdkRegion *region;
  65   GtkWidget *child;
  66   cairo_t *cr;
  67
  68   /* get our child (in this case, the event box) */
  69   child = gtk_bin_get_child (GTK_BIN (widget));
  70
  71   /* create a cairo context to draw to the window */
  72   cr = gdk_cairo_create (widget->window);
  73
  74   /* the source data is the (composited) event box */
  75   gdk_cairo_set_source_pixmap (cr, child->window,
  76                                child->allocation.x,
  77                                child->allocation.y);
  78
  79   /* draw no more than our expose event intersects our child */
  80   region = gdk_region_rectangle (&child->allocation);
  81   gdk_region_intersect (region, event->region);
  82   gdk_cairo_region (cr, region);
  83   cairo_clip (cr);
  84
  85   /* composite, with a 50% opacity */
  86   cairo_set_operator (cr, CAIRO_OPERATOR_OVER);
  87   cairo_paint_with_alpha (cr, 0.5);
  88
  89   /* we're done */
  90   cairo_destroy (cr);
  91
  92   return FALSE;
  93 }
  94
  95 int
  96 main (int argc, char **argv)
  97 {
  98   GtkWidget *window, *event, *button;
  99   GdkScreen *screen;
 100   GdkColormap *rgba;
 101   GdkColor red;
 102
 103   gtk_init (&argc, &argv);
 104
 105   /* Make the widgets */
 106   button = gtk_button_new_with_label ("A Button");
 107   event = gtk_event_box_new ();
 108   window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
 109
 110   /* Put a red background on the window */
 111   gdk_color_parse ("red", &red);
 112   gtk_widget_modify_bg (window, GTK_STATE_NORMAL, &red);
 113
 114   /* Set the colourmap for the event box.
 115    * Must be done before the event box is realised.
 116    */
 117   screen = gtk_widget_get_screen (event);
 118   rgba = gdk_screen_get_rgba_colormap (screen);
 119   gtk_widget_set_colormap (event, rgba);
 120
 121   /* Set our event box to have a fully-transparent background
 122    * drawn on it. Currently there is no way to simply tell GTK+
 123    * that "transparency" is the background colour for a widget.
 124    */
 125   gtk_widget_set_app_paintable (GTK_WIDGET (event), TRUE);
 126   g_signal_connect (event, "expose-event",
 127                     G_CALLBACK (transparent_expose), NULL);
 128
 129   /* Put them inside one another */
 130   gtk_container_set_border_width (GTK_CONTAINER (window), 10);
 131   gtk_container_add (GTK_CONTAINER (window), event);
 132   gtk_container_add (GTK_CONTAINER (event), button);
 133
 134   /* Realise and show everything */
 135   gtk_widget_show_all (window);
 136
 137   /* Set the event box GdkWindow to be composited.
 138    * Obviously must be performed after event box is realised.
 139    */
 140   gdk_window_set_composited (event->window, TRUE);
 141
 142   /* Set up the compositing handler.
 143    * Note that we do _after_ so that the normal (red) background is drawn
 144    * by gtk before our compositing occurs.
 145    */
 146   g_signal_connect_after (window, "expose-event",
 147                           G_CALLBACK (window_expose_event), NULL);
 148
 149   gtk_main ();
 150
 151   return 0;
 152 }
 153 ]]>
 154 </programlisting></example>
 155 <para>
 156 In the example <xref linkend="composited-window-example"/>, a button is
 157 placed inside of an event box inside of a window. The event box is
 158 set as composited and therefore is no longer automatically drawn to
 159 the screen.
 160 </para>
 161 <para>
 162 When the contents of the event box change, an expose event is
 163 generated on its parent window (which, in this case, belongs to
 164 the toplevel #GtkWindow). The expose handler for this widget is
 165 responsible for merging the changes back on the screen in the way
 166 that it wishes.
 167 </para>
 168 <para>
 169 In our case, we merge the contents with a 50% transparency. We
 170 also set the background colour of the window to red. The effect is
 171 that the background shows through the button.
 172 </para>
 173
 174 <!-- ##### SECTION See_Also ##### -->
 175 <para>
 176
 177 </para>
 178
 179 <!-- ##### SECTION Stability_Level ##### -->
 180
 181
 182 <!-- ##### STRUCT GdkWindow ##### -->
 183 <para>
 184 An opaque structure representing an onscreen drawable.
 185 Pointers to structures of type #GdkPixmap, #GdkBitmap,
 186 and #GdkWindow, can often be used interchangeably.
 187 The type #GdkDrawable refers generically to any of
 188 these types.
 189 </para>
 190
 191
 192 <!-- ##### SIGNAL GdkWindow::from-embedder ##### -->
 193 <para>
 194
 195 </para>
 196
 197 @gdkwindow: the object which received the signal.
 198 @arg1:
 199 @arg2:
 200 @arg3:
 201 @arg4:
 202
 203 <!-- ##### SIGNAL GdkWindow::pick-embedded-child ##### -->
 204 <para>
 205
 206 </para>
 207
 208 @gdkwindow: the object which received the signal.
 209 @arg1:
 210 @arg2:
 211 @Returns:
 212
 213 <!-- ##### SIGNAL GdkWindow::to-embedder ##### -->
 214 <para>
 215
 216 </para>
 217
 218 @gdkwindow: the object which received the signal.
 219 @arg1:
 220 @arg2:
 221 @arg3:
 222 @arg4:
 223
 224 <!-- ##### ARG GdkWindow:cursor ##### -->
 225 <para>
 226
 227 </para>
 228
 229 <!-- ##### ENUM GdkWindowType ##### -->
 230 <para>
 231 Describes the kind of window.
 232 </para>
 233
 234 @GDK_WINDOW_ROOT: root window; this window has no parent, covers the entire screen, and is created by the window system
 235 @GDK_WINDOW_TOPLEVEL: toplevel window (used to implement #GtkWindow)
 236 @GDK_WINDOW_CHILD: child window (used to implement e.g. #GtkEntry)
 237 @GDK_WINDOW_DIALOG: useless/deprecated compatibility type
 238 @GDK_WINDOW_TEMP: override redirect temporary window (used to implement #GtkMenu)
 239 @GDK_WINDOW_FOREIGN: foreign window (see gdk_window_foreign_new())
 240 @GDK_WINDOW_OFFSCREEN: offscreen window. Since 2.18
 241
 242 <!-- ##### ENUM GdkWindowClass ##### -->
 243 <para>
 244 @GDK_INPUT_OUTPUT windows are the standard kind of window you might expect.
 245 @GDK_INPUT_ONLY windows are invisible; they are used to trap events, but
 246 you can't draw on them.
 247 </para>
 248
 249 @GDK_INPUT_OUTPUT: window for graphics and events
 250 @GDK_INPUT_ONLY: window for events only
 251
 252 <!-- ##### ENUM GdkWindowHints ##### -->
 253 <para>
 254 Used to indicate which fields of a #GdkGeometry struct should be paid attention
 255 to. Also, the presence/absence of @GDK_HINT_POS, @GDK_HINT_USER_POS, and
 256 @GDK_HINT_USER_SIZE is significant, though they don't directly refer to
 257 #GdkGeometry fields.  @GDK_HINT_USER_POS will be set automatically by #GtkWindow
 258 if you call gtk_window_move(). @GDK_HINT_USER_POS and @GDK_HINT_USER_SIZE
 259 should be set if the user specified a size/position using a --geometry
 260 command-line argument; gtk_window_parse_geometry() automatically sets these
 261 flags.
 262 </para>
 263
 264 @GDK_HINT_POS: indicates that the program has positioned the window
 265 @GDK_HINT_MIN_SIZE: min size fields are set
 266 @GDK_HINT_MAX_SIZE: max size fields are set
 267 @GDK_HINT_BASE_SIZE: base size fields are set
 268 @GDK_HINT_ASPECT: aspect ratio fields are set
 269 @GDK_HINT_RESIZE_INC: resize increment fields are set
 270 @GDK_HINT_WIN_GRAVITY: window gravity field is set
 271 @GDK_HINT_USER_POS: indicates that the window's position was explicitly set by the user
 272 @GDK_HINT_USER_SIZE: indicates that the window's size was explicitly set by the user
 273
 274 <!-- ##### STRUCT GdkGeometry ##### -->
 275 <para>
 276 The #GdkGeometry struct gives the window manager information about
 277 a window's geometry constraints. Normally you would set these on
 278 the GTK+ level using gtk_window_set_geometry_hints(). #GtkWindow
 279 then sets the hints on the #GdkWindow it creates.
 280 </para>
 281
 282 <para>
 283 gdk_window_set_geometry_hints() expects the hints to be fully valid already and
 284 simply passes them to the window manager; in contrast,
 285 gtk_window_set_geometry_hints() performs some interpretation. For example,
 286 #GtkWindow will apply the hints to the geometry widget instead of the toplevel
 287 window, if you set a geometry widget. Also, the
 288 @min_width/@min_height/@max_width/@max_height fields may be set to -1, and
 289 #GtkWindow will substitute the size request of the window or geometry widget. If
 290 the minimum size hint is not provided, #GtkWindow will use its requisition as
 291 the minimum size.  If the minimum size is provided and a geometry widget is set,
 292 #GtkWindow will take the minimum size as the minimum size of the geometry widget
 293 rather than the entire window. The base size is treated similarly.
 294 </para>
 295
 296 <para>
 297 The canonical use-case for gtk_window_set_geometry_hints() is to get a terminal
 298 widget to resize properly. Here, the terminal text area should be the geometry
 299 widget; #GtkWindow will then automatically set the base size to the size of
 300 other widgets in the terminal window, such as the menubar and scrollbar.  Then,
 301 the @width_inc and @height_inc fields should be set to the size of one character
 302 in the terminal. Finally, the base size should be set to the size of one
 303 character. The net effect is that the minimum size of the terminal
 304 will have a 1x1 character terminal area, and only terminal sizes on
 305 the "character grid" will be allowed.
 306 </para>
 307
 308 <para>
 309 Here's an example of how the terminal example would be implemented, assuming
 310 a terminal area widget called "terminal" and a toplevel window "toplevel":
 311 <informalexample><programlisting>
 312         GdkGeometry hints;
 313
 314         hints.base_width = terminal->char_width;
 315         hints.base_height = terminal->char_height;
 316         hints.min_width = terminal->char_width;
 317         hints.min_height = terminal->char_height;
 318         hints.width_inc = terminal->char_width;
 319         hints.height_inc = terminal->char_height;
 320
 321         gtk_window_set_geometry_hints (GTK_WINDOW (toplevel),
 322                                        GTK_WIDGET (terminal),
 323                                        &amp;hints,
 324                                        GDK_HINT_RESIZE_INC |
 325                                        GDK_HINT_MIN_SIZE |
 326                                        GDK_HINT_BASE_SIZE);
 327 </programlisting></informalexample>
 328 </para>
 329
 330 <para>
 331 The other useful fields are the @min_aspect and @max_aspect fields; these
 332 contain a width/height ratio as a floating point number. If a geometry widget is
 333 set, the aspect applies to the geometry widget rather than the entire window.
 334 The most common use of these hints is probably to set @min_aspect and
 335 @max_aspect to the same value, thus forcing the window to keep a constant aspect
 336 ratio.
 337 </para>
 338
 339 @min_width: minimum width of window (or -1 to use requisition, with #GtkWindow only)
 340 @min_height: minimum height of window (or -1 to use requisition, with #GtkWindow only)
 341 @max_width: maximum width of window (or -1 to use requisition, with #GtkWindow only)
 342 @max_height: maximum height of window (or -1 to use requisition, with #GtkWindow only)
 343 @base_width: allowed window widths are @base_width + @width_inc * N where N is any integer (-1 allowed with #GtkWindow)
 344 @base_height: allowed window widths are @base_height + @height_inc * N where N is any integer (-1 allowed with #GtkWindow)
 345 @width_inc: width resize increment
 346 @height_inc: height resize increment
 347 @min_aspect: minimum width/height ratio
 348 @max_aspect: maximum width/height ratio
 349 @win_gravity: window gravity, see gtk_window_set_gravity()
 350
 351 <!-- ##### ENUM GdkGravity ##### -->
 352 <para>
 353 Defines the reference point of a window and the meaning of coordinates
 354 passed to gtk_window_move(). See gtk_window_move() and the "implementation
 355 notes" section of the
 356 <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended
 357 Window Manager Hints</ulink> specification for more details.
 358 </para>
 359
 360 @GDK_GRAVITY_NORTH_WEST: the reference point is at the top left corner.
 361 @GDK_GRAVITY_NORTH: the reference point is in the middle of the top edge.
 362 @GDK_GRAVITY_NORTH_EAST: the reference point is at the top right corner.
 363 @GDK_GRAVITY_WEST: the reference point is at the middle of the left edge.
 364 @GDK_GRAVITY_CENTER: the reference point is at the center of the window.
 365 @GDK_GRAVITY_EAST: the reference point is at the middle of the right edge.
 366 @GDK_GRAVITY_SOUTH_WEST: the reference point is at the lower left corner.
 367 @GDK_GRAVITY_SOUTH: the reference point is at the middle of the lower edge.
 368 @GDK_GRAVITY_SOUTH_EAST: the reference point is at the lower right corner.
 369 @GDK_GRAVITY_STATIC: the reference point is at the top left corner of the
 370    window itself, ignoring window manager decorations.
 371
 372 <!-- ##### ENUM GdkWindowEdge ##### -->
 373 <para>
 374 Determines a window edge or corner.
 375 </para>
 376
 377 @GDK_WINDOW_EDGE_NORTH_WEST: the top left corner.
 378 @GDK_WINDOW_EDGE_NORTH: the top edge.
 379 @GDK_WINDOW_EDGE_NORTH_EAST: the top right corner.
 380 @GDK_WINDOW_EDGE_WEST: the left edge.
 381 @GDK_WINDOW_EDGE_EAST: the right edge.
 382 @GDK_WINDOW_EDGE_SOUTH_WEST: the lower left corner.
 383 @GDK_WINDOW_EDGE_SOUTH: the lower edge.
 384 @GDK_WINDOW_EDGE_SOUTH_EAST: the lower right corner.
 385
 386 <!-- ##### ENUM GdkWindowTypeHint ##### -->
 387 <para>
 388 These are hints for the window manager that indicate what type of function
 389 the window has. The window manager can use this when determining decoration
 390 and behaviour of the window. The hint must be set before mapping the window.
 391 </para>
 392 <para>
 393 See the
 394 <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended
 395 Window Manager Hints</ulink> specification for more details about
 396 window types.
 397 </para>
 398
 399 @GDK_WINDOW_TYPE_HINT_NORMAL: Normal toplevel window.
 400 @GDK_WINDOW_TYPE_HINT_DIALOG: Dialog window.
 401 @GDK_WINDOW_TYPE_HINT_MENU: Window used to implement a menu; GTK+ uses
 402   this hint only for torn-off menus, see #GtkTearoffMenuItem.
 403 @GDK_WINDOW_TYPE_HINT_TOOLBAR: Window used to implement toolbars.
 404 @GDK_WINDOW_TYPE_HINT_SPLASHSCREEN: Window used to display a splash
 405   screen during application startup.
 406 @GDK_WINDOW_TYPE_HINT_UTILITY: Utility windows which are not detached
 407   toolbars or dialogs.
 408 @GDK_WINDOW_TYPE_HINT_DOCK: Used for creating dock or panel windows.
 409 @GDK_WINDOW_TYPE_HINT_DESKTOP: Used for creating the desktop background
 410 window.
 411 @GDK_WINDOW_TYPE_HINT_DROPDOWN_MENU: A menu that belongs to a menubar.
 412 @GDK_WINDOW_TYPE_HINT_POPUP_MENU: A menu that does not belong to a menubar,
 413   e.g. a context menu.
 414 @GDK_WINDOW_TYPE_HINT_TOOLTIP: A tooltip.
 415 @GDK_WINDOW_TYPE_HINT_NOTIFICATION: A notification - typically a "bubble"
 416   that belongs to a status icon.
 417 @GDK_WINDOW_TYPE_HINT_COMBO: A popup from a combo box.
 418 @GDK_WINDOW_TYPE_HINT_DND: A window that is used to implement a DND cursor.
 419
 420 <!-- ##### STRUCT GdkWindowAttr ##### -->
 421 <para>
 422 Attributes to use for a newly-created window.
 423 </para>
 424
 425 @title: title of the window (for toplevel windows)
 426 @event_mask: event mask (see gdk_window_set_events())
 427 @x: X coordinate relative to parent window (see gdk_window_move())
 428 @y: Y coordinate relative to parent window (see gdk_window_move())
 429 @width: width of window
 430 @height: height of window
 431 @wclass: #GDK_INPUT_OUTPUT (normal window) or #GDK_INPUT_ONLY (invisible window that receives events)
 432 @visual: #GdkVisual for window
 433 @colormap: #GdkColormap for window
 434 @window_type: type of window
 435 @cursor: cursor for the window (see gdk_window_set_cursor())
 436 @wmclass_name: don't use (see gtk_window_set_wmclass())
 437 @wmclass_class: don't use (see gtk_window_set_wmclass())
 438 @override_redirect: %TRUE to bypass the window manager
 439 @type_hint: a hint of the function of the window
 440
 441 <!-- ##### ENUM GdkWindowAttributesType ##### -->
 442 <para>
 443 Used to indicate which fields in the #GdkWindowAttr struct should be
 444 honored. For example, if you filled in the "cursor" and "x" fields of
 445 #GdkWindowAttr, pass "@GDK_WA_X | @GDK_WA_CURSOR" to gdk_window_new().  Fields
 446 in #GdkWindowAttr not covered by a bit in this enum are required; for example,
 447 the @width/@height, @wclass, and @window_type fields are required, they have no
 448 corresponding flag in #GdkWindowAttributesType.
 449 </para>
 450
 451 @GDK_WA_TITLE: Honor the title field
 452 @GDK_WA_X: Honor the X coordinate field
 453 @GDK_WA_Y: Honor the Y coordinate field
 454 @GDK_WA_CURSOR: Honor the cursor field
 455 @GDK_WA_COLORMAP: Honor the colormap field
 456 @GDK_WA_VISUAL: Honor the visual field
 457 @GDK_WA_WMCLASS: Honor the wmclass_class and wmclass_name fields
 458 @GDK_WA_NOREDIR: Honor the override_redirect field
 459 @GDK_WA_TYPE_HINT: Honor the type_hint field
 460
 461 <!-- ##### FUNCTION gdk_window_new ##### -->
 462 <para>
 463
 464 </para>
 465
 466 @parent:
 467 @attributes:
 468 @attributes_mask:
 469 @Returns:
 470
 471
 472 <!-- ##### FUNCTION gdk_window_destroy ##### -->
 473 <para>
 474
 475 </para>
 476
 477 @window:
 478
 479
 480 <!-- ##### MACRO gdk_window_ref ##### -->
 481 <para>
 482 Deprecated equivalent of g_object_ref()
 483 </para>
 484
 485 @Returns: the window
 486
 487
 488 <!-- ##### MACRO gdk_window_unref ##### -->
 489 <para>
 490 Deprecated equivalent of g_object_unref()
 491 </para>
 492
 493
 494
 495 <!-- ##### FUNCTION gdk_window_get_window_type ##### -->
 496 <para>
 497
 498 </para>
 499
 500 @window:
 501 @Returns:
 502
 503
 504 <!-- ##### FUNCTION gdk_window_at_pointer ##### -->
 505 <para>
 506
 507 </para>
 508
 509 @win_x:
 510 @win_y:
 511 @Returns:
 512
 513
 514 <!-- ##### FUNCTION gdk_window_show ##### -->
 515 <para>
 516
 517 </para>
 518
 519 @window:
 520
 521
 522 <!-- ##### FUNCTION gdk_window_show_unraised ##### -->
 523 <para>
 524
 525 </para>
 526
 527 @window:
 528
 529
 530 <!-- ##### FUNCTION gdk_window_hide ##### -->
 531 <para>
 532
 533 </para>
 534
 535 @window:
 536
 537
 538 <!-- ##### FUNCTION gdk_window_is_visible ##### -->
 539 <para>
 540
 541 </para>
 542
 543 @window:
 544 @Returns:
 545
 546
 547 <!-- ##### FUNCTION gdk_window_is_viewable ##### -->
 548 <para>
 549
 550 </para>
 551
 552 @window:
 553 @Returns:
 554
 555
 556 <!-- ##### FUNCTION gdk_window_get_state ##### -->
 557 <para>
 558
 559 </para>
 560
 561 @window:
 562 @Returns:
 563
 564
 565 <!-- ##### FUNCTION gdk_window_withdraw ##### -->
 566 <para>
 567
 568 </para>
 569
 570 @window:
 571
 572
 573 <!-- ##### FUNCTION gdk_window_iconify ##### -->
 574 <para>
 575
 576 </para>
 577
 578 @window:
 579
 580
 581 <!-- ##### FUNCTION gdk_window_deiconify ##### -->
 582 <para>
 583
 584 </para>
 585
 586 @window:
 587
 588
 589 <!-- ##### FUNCTION gdk_window_stick ##### -->
 590 <para>
 591
 592 </para>
 593
 594 @window:
 595
 596
 597 <!-- ##### FUNCTION gdk_window_unstick ##### -->
 598 <para>
 599
 600 </para>
 601
 602 @window:
 603
 604
 605 <!-- ##### FUNCTION gdk_window_maximize ##### -->
 606 <para>
 607
 608 </para>
 609
 610 @window:
 611
 612
 613 <!-- ##### FUNCTION gdk_window_unmaximize ##### -->
 614 <para>
 615
 616 </para>
 617
 618 @window:
 619
 620
 621 <!-- ##### FUNCTION gdk_window_fullscreen ##### -->
 622 <para>
 623
 624 </para>
 625
 626 @window:
 627
 628
 629 <!-- ##### FUNCTION gdk_window_unfullscreen ##### -->
 630 <para>
 631
 632 </para>
 633
 634 @window:
 635
 636
 637 <!-- ##### FUNCTION gdk_window_set_keep_above ##### -->
 638 <para>
 639
 640 </para>
 641
 642 @window:
 643 @setting:
 644
 645
 646 <!-- ##### FUNCTION gdk_window_set_keep_below ##### -->
 647 <para>
 648
 649 </para>
 650
 651 @window:
 652 @setting:
 653
 654
 655 <!-- ##### FUNCTION gdk_window_set_opacity ##### -->
 656 <para>
 657
 658 </para>
 659
 660 @window:
 661 @opacity:
 662
 663
 664 <!-- ##### FUNCTION gdk_window_set_composited ##### -->
 665 <para>
 666
 667 </para>
 668
 669 @window:
 670 @composited:
 671
 672
 673 <!-- ##### FUNCTION gdk_window_move ##### -->
 674 <para>
 675
 676 </para>
 677
 678 @window:
 679 @x:
 680 @y:
 681
 682
 683 <!-- ##### FUNCTION gdk_window_resize ##### -->
 684 <para>
 685
 686 </para>
 687
 688 @window:
 689 @width:
 690 @height:
 691
 692
 693 <!-- ##### FUNCTION gdk_window_move_resize ##### -->
 694 <para>
 695
 696 </para>
 697
 698 @window:
 699 @x:
 700 @y:
 701 @width:
 702 @height:
 703
 704
 705 <!-- ##### FUNCTION gdk_window_scroll ##### -->
 706 <para>
 707
 708 </para>
 709
 710 @window:
 711 @dx:
 712 @dy:
 713
 714
 715 <!-- ##### FUNCTION gdk_window_move_region ##### -->
 716 <para>
 717
 718 </para>
 719
 720 @window:
 721 @region:
 722 @dx:
 723 @dy:
 724
 725
 726 <!-- ##### FUNCTION gdk_window_ensure_native ##### -->
 727 <para>
 728
 729 </para>
 730
 731 @window:
 732 @Returns:
 733
 734
 735 <!-- ##### FUNCTION gdk_window_reparent ##### -->
 736 <para>
 737
 738 </para>
 739
 740 @window:
 741 @new_parent:
 742 @x:
 743 @y:
 744
 745
 746 <!-- ##### FUNCTION gdk_window_clear ##### -->
 747 <para>
 748
 749 </para>
 750
 751 @window:
 752
 753
 754 <!-- ##### FUNCTION gdk_window_clear_area ##### -->
 755 <para>
 756
 757 </para>
 758
 759 @window:
 760 @x:
 761 @y:
 762 @width:
 763 @height:
 764
 765
 766 <!-- ##### FUNCTION gdk_window_clear_area_e ##### -->
 767 <para>
 768
 769 </para>
 770
 771 @window:
 772 @x:
 773 @y:
 774 @width:
 775 @height:
 776
 777
 778 <!-- ##### MACRO gdk_window_copy_area ##### -->
 779 <para>
 780 Deprecated equivalent to gdk_draw_drawable(), see that function for docs
 781 </para>
 782
 783 @drawable: a #GdkDrawable
 784 @gc: a #GdkGC sharing the drawable's visual and colormap
 785 @x: X position in @drawable where the rectangle should be drawn
 786 @y: Y position in @drawable where the rectangle should be drawn
 787 @source_drawable: the source #GdkDrawable, which may be the same as @drawable
 788 @source_x: X position in @src of rectangle to draw
 789 @source_y: Y position in @src of rectangle to draw
 790 @width: width of rectangle to draw, or -1 for entire @src width
 791 @height: height of rectangle to draw, or -1 for entire @src height
 792 <!-- # Unused Parameters # -->
 793 @drawable: a #GdkDrawable
 794 @xdest: X position in @drawable where the rectangle should be drawn
 795 @ydest: Y position in @drawable where the rectangle should be drawn
 796
 797
 798 <!-- ##### FUNCTION gdk_window_raise ##### -->
 799 <para>
 800
 801 </para>
 802
 803 @window:
 804
 805
 806 <!-- ##### FUNCTION gdk_window_lower ##### -->
 807 <para>
 808
 809 </para>
 810
 811 @window:
 812
 813
 814 <!-- ##### FUNCTION gdk_window_focus ##### -->
 815 <para>
 816
 817 </para>
 818
 819 @window:
 820 @timestamp:
 821
 822
 823 <!-- ##### FUNCTION gdk_window_register_dnd ##### -->
 824 <para>
 825 Registers a window as a potential drop destination.
 826 </para>
 827
 828 @window: a #GdkWindow.
 829
 830
 831 <!-- ##### FUNCTION gdk_window_begin_resize_drag ##### -->
 832 <para>
 833
 834 </para>
 835
 836 @window:
 837 @edge:
 838 @button:
 839 @root_x:
 840 @root_y:
 841 @timestamp:
 842
 843
 844 <!-- ##### FUNCTION gdk_window_begin_move_drag ##### -->
 845 <para>
 846
 847 </para>
 848
 849 @window:
 850 @button:
 851 @root_x:
 852 @root_y:
 853 @timestamp:
 854
 855
 856 <!-- ##### FUNCTION gdk_window_constrain_size ##### -->
 857 <para>
 858
 859 </para>
 860
 861 @geometry:
 862 @flags:
 863 @width:
 864 @height:
 865 @new_width:
 866 @new_height:
 867
 868
 869 <!-- ##### FUNCTION gdk_window_beep ##### -->
 870 <para>
 871
 872 </para>
 873
 874 @window:
 875
 876
 877 <!-- ##### FUNCTION gdk_window_begin_paint_rect ##### -->
 878 <para>
 879
 880 </para>
 881
 882 @window:
 883 @rectangle:
 884
 885
 886 <!-- ##### FUNCTION gdk_window_begin_paint_region ##### -->
 887 <para>
 888
 889 </para>
 890
 891 @window:
 892 @region:
 893
 894
 895 <!-- ##### FUNCTION gdk_window_end_paint ##### -->
 896 <para>
 897
 898 </para>
 899
 900 @window:
 901
 902
 903 <!-- ##### FUNCTION gdk_window_invalidate_rect ##### -->
 904 <para>
 905
 906 </para>
 907
 908 @window:
 909 @rect:
 910 @invalidate_children:
 911
 912
 913 <!-- ##### FUNCTION gdk_window_invalidate_region ##### -->
 914 <para>
 915
 916 </para>
 917
 918 @window:
 919 @region:
 920 @invalidate_children:
 921
 922
 923 <!-- ##### FUNCTION gdk_window_invalidate_maybe_recurse ##### -->
 924 <para>
 925
 926 </para>
 927
 928 @window:
 929 @region:
 930 @child_func:
 931 @user_data:
 932
 933
 934 <!-- ##### FUNCTION gdk_window_get_update_area ##### -->
 935 <para>
 936
 937 </para>
 938
 939 @window:
 940 @Returns:
 941
 942
 943 <!-- ##### FUNCTION gdk_window_freeze_updates ##### -->
 944 <para>
 945
 946 </para>
 947
 948 @window:
 949
 950
 951 <!-- ##### FUNCTION gdk_window_thaw_updates ##### -->
 952 <para>
 953
 954 </para>
 955
 956 @window:
 957
 958
 959 <!-- ##### FUNCTION gdk_window_process_all_updates ##### -->
 960 <para>
 961
 962 </para>
 963
 964
 965
 966 <!-- ##### FUNCTION gdk_window_process_updates ##### -->
 967 <para>
 968
 969 </para>
 970
 971 @window:
 972 @update_children:
 973
 974
 975 <!-- ##### FUNCTION gdk_window_set_debug_updates ##### -->
 976 <para>
 977
 978 </para>
 979
 980 @setting:
 981
 982
 983 <!-- ##### FUNCTION gdk_window_get_internal_paint_info ##### -->
 984 <para>
 985
 986 </para>
 987
 988 @window:
 989 @real_drawable:
 990 @x_offset:
 991 @y_offset:
 992
 993
 994 <!-- ##### FUNCTION gdk_window_enable_synchronized_configure ##### -->
 995 <para>
 996
 997 </para>
 998
 999 @window:
1000
1001
1002 <!-- ##### FUNCTION gdk_window_configure_finished ##### -->
1003 <para>
1004
1005 </para>
1006
1007 @window:
1008
1009
1010 <!-- ##### FUNCTION gdk_window_set_user_data ##### -->
1011 <para>
1012
1013 </para>
1014
1015 @window:
1016 @user_data:
1017
1018
1019 <!-- ##### FUNCTION gdk_window_set_override_redirect ##### -->
1020 <para>
1021
1022 </para>
1023
1024 @window:
1025 @override_redirect:
1026
1027
1028 <!-- ##### FUNCTION gdk_window_set_accept_focus ##### -->
1029 <para>
1030
1031 </para>
1032
1033 @window:
1034 @accept_focus:
1035
1036
1037 <!-- ##### FUNCTION gdk_window_set_focus_on_map ##### -->
1038 <para>
1039
1040 </para>
1041
1042 @window:
1043 @focus_on_map:
1044
1045
1046 <!-- ##### FUNCTION gdk_window_add_filter ##### -->
1047 <para>
1048
1049 </para>
1050
1051 @window:
1052 @function:
1053 @data:
1054
1055
1056 <!-- ##### FUNCTION gdk_window_remove_filter ##### -->
1057 <para>
1058
1059 </para>
1060
1061 @window:
1062 @function:
1063 @data:
1064
1065
1066 <!-- ##### USER_FUNCTION GdkFilterFunc ##### -->
1067 <para>
1068 Specifies the type of function used to filter native events before they are
1069 converted to GDK events.
1070 </para>
1071
1072 <para>
1073 When a filter is called, @event is unpopulated, except for
1074 <literal>event-&gt;window</literal>. The filter may translate the native
1075 event to a GDK event and store the result in @event, or handle it without
1076 translation. If the filter translates the event and processing should
1077 continue, it should return <literal>GDK_FILTER_TRANSLATE</literal>.
1078 </para>
1079
1080 @xevent: the native event to filter.
1081 @event: the GDK event to which the X event will be translated.
1082 @data: user data set when the filter was installed.
1083 @Returns: a #GdkFilterReturn value.
1084
1085
1086 <!-- ##### ENUM GdkFilterReturn ##### -->
1087 <para>
1088 Specifies the result of applying a #GdkFilterFunc to a native event.
1089 </para>
1090
1091 @GDK_FILTER_CONTINUE: event not handled, continue processing.
1092 @GDK_FILTER_TRANSLATE: native event translated into a GDK event and stored
1093                        in the <literal>event</literal> structure that was passed in.
1094 @GDK_FILTER_REMOVE: event handled, terminate processing.
1095
1096 <!-- ##### TYPEDEF GdkXEvent ##### -->
1097 <para>
1098 Used to represent native events (<type>XEvent</type>s for the X11
1099 backend, <type>MSG</type>s for Win32).
1100 </para>
1101
1102
1103 <!-- ##### FUNCTION gdk_window_shape_combine_mask ##### -->
1104 <para>
1105
1106 </para>
1107
1108 @window:
1109 @mask:
1110 @x:
1111 @y:
1112
1113
1114 <!-- ##### FUNCTION gdk_window_shape_combine_region ##### -->
1115 <para>
1116
1117 </para>
1118
1119 @window:
1120 @shape_region:
1121 @offset_x:
1122 @offset_y:
1123
1124
1125 <!-- ##### FUNCTION gdk_window_set_child_shapes ##### -->
1126 <para>
1127
1128 </para>
1129
1130 @window:
1131
1132
1133 <!-- ##### FUNCTION gdk_window_merge_child_shapes ##### -->
1134 <para>
1135
1136 </para>
1137
1138 @window:
1139
1140
1141 <!-- ##### FUNCTION gdk_window_input_shape_combine_mask ##### -->
1142 <para>
1143
1144 </para>
1145
1146 @window:
1147 @mask:
1148 @x:
1149 @y:
1150
1151
1152 <!-- ##### FUNCTION gdk_window_input_shape_combine_region ##### -->
1153 <para>
1154
1155 </para>
1156
1157 @window:
1158 @shape_region:
1159 @offset_x:
1160 @offset_y:
1161
1162
1163 <!-- ##### FUNCTION gdk_window_set_child_input_shapes ##### -->
1164 <para>
1165
1166 </para>
1167
1168 @window:
1169
1170
1171 <!-- ##### FUNCTION gdk_window_merge_child_input_shapes ##### -->
1172 <para>
1173
1174 </para>
1175
1176 @window:
1177
1178
1179 <!-- ##### FUNCTION gdk_window_set_static_gravities ##### -->
1180 <para>
1181
1182 </para>
1183
1184 @window:
1185 @use_static:
1186 @Returns:
1187
1188
1189 <!-- ##### FUNCTION gdk_window_set_hints ##### -->
1190 <para>
1191
1192 </para>
1193
1194 @window:
1195 @x:
1196 @y:
1197 @min_width:
1198 @min_height:
1199 @max_width:
1200 @max_height:
1201 @flags:
1202
1203
1204 <!-- ##### FUNCTION gdk_window_set_title ##### -->
1205 <para>
1206
1207 </para>
1208
1209 @window:
1210 @title:
1211
1212
1213 <!-- ##### FUNCTION gdk_window_set_background ##### -->
1214 <para>
1215
1216 </para>
1217
1218 @window:
1219 @color:
1220
1221
1222 <!-- ##### FUNCTION gdk_window_set_back_pixmap ##### -->
1223 <para>
1224
1225 </para>
1226
1227 @window:
1228 @pixmap:
1229 @parent_relative:
1230
1231
1232 <!-- ##### MACRO GDK_PARENT_RELATIVE ##### -->
1233 <para>
1234 A special value for <literal>GdkPixmap*</literal> variables, indicating
1235 that the background pixmap for a window should be inherited from the parent
1236 window.
1237 </para>
1238
1239
1240
1241 <!-- ##### FUNCTION gdk_window_set_cursor ##### -->
1242 <para>
1243
1244 </para>
1245
1246 @window:
1247 @cursor:
1248
1249
1250 <!-- ##### MACRO gdk_window_set_colormap ##### -->
1251 <para>
1252 Deprecated equivalent to gdk_drawable_set_colormap()
1253 </para>
1254
1255
1256
1257 <!-- ##### FUNCTION gdk_window_get_user_data ##### -->
1258 <para>
1259
1260 </para>
1261
1262 @window:
1263 @data:
1264
1265
1266 <!-- ##### FUNCTION gdk_window_get_geometry ##### -->
1267 <para>
1268
1269 </para>
1270
1271 @window:
1272 @x:
1273 @y:
1274 @width:
1275 @height:
1276 @depth:
1277
1278
1279 <!-- ##### FUNCTION gdk_window_set_geometry_hints ##### -->
1280 <para>
1281
1282 </para>
1283
1284 @window:
1285 @geometry:
1286 @geom_mask:
1287
1288
1289 <!-- ##### FUNCTION gdk_window_set_icon_list ##### -->
1290 <para>
1291
1292 </para>
1293
1294 @window:
1295 @pixbufs:
1296
1297
1298 <!-- ##### FUNCTION gdk_window_set_modal_hint ##### -->
1299 <para>
1300
1301 </para>
1302
1303 @window:
1304 @modal:
1305
1306
1307 <!-- ##### FUNCTION gdk_window_set_type_hint ##### -->
1308 <para>
1309
1310 </para>
1311
1312 @window:
1313 @hint:
1314
1315
1316 <!-- ##### FUNCTION gdk_window_get_type_hint ##### -->
1317 <para>
1318
1319 </para>
1320
1321 @window:
1322 @Returns:
1323
1324
1325 <!-- ##### FUNCTION gdk_window_set_skip_taskbar_hint ##### -->
1326 <para>
1327
1328 </para>
1329
1330 @window:
1331 @skips_taskbar:
1332
1333
1334 <!-- ##### FUNCTION gdk_window_set_skip_pager_hint ##### -->
1335 <para>
1336
1337 </para>
1338
1339 @window:
1340 @skips_pager:
1341
1342
1343 <!-- ##### FUNCTION gdk_window_set_urgency_hint ##### -->
1344 <para>
1345
1346 </para>
1347
1348 @window:
1349 @urgent:
1350
1351
1352 <!-- ##### FUNCTION gdk_window_get_position ##### -->
1353 <para>
1354
1355 </para>
1356
1357 @window:
1358 @x:
1359 @y:
1360
1361
1362 <!-- ##### FUNCTION gdk_window_get_root_origin ##### -->
1363 <para>
1364
1365 </para>
1366
1367 @window:
1368 @x:
1369 @y:
1370
1371
1372 <!-- ##### FUNCTION gdk_window_get_frame_extents ##### -->
1373 <para>
1374
1375 </para>
1376
1377 @window:
1378 @rect:
1379
1380
1381 <!-- ##### MACRO gdk_window_get_size ##### -->
1382 <para>
1383 Deprecated equivalent of gdk_drawable_get_size().
1384 </para>
1385
1386
1387
1388 <!-- ##### MACRO gdk_window_get_visual ##### -->
1389 <para>
1390 Deprecated equivalent of gdk_drawable_get_visual().
1391 </para>
1392
1393 @Returns: the #GdkVisual of the window
1394
1395
1396 <!-- ##### MACRO gdk_window_get_colormap ##### -->
1397 <para>
1398 Deprecated equivalent of gdk_drawable_get_colormap().
1399 </para>
1400
1401 @Returns: colormap for the window
1402
1403
1404 <!-- ##### MACRO gdk_window_get_type ##### -->
1405 <para>
1406 Deprecated equivalent of gdk_drawable_get_type().
1407 </para>
1408
1409 @Returns: type of drawable
1410
1411
1412 <!-- ##### FUNCTION gdk_window_get_origin ##### -->
1413 <para>
1414
1415 </para>
1416
1417 @window:
1418 @x:
1419 @y:
1420 @Returns:
1421
1422
1423 <!-- ##### FUNCTION gdk_window_get_deskrelative_origin ##### -->
1424 <para>
1425
1426 </para>
1427
1428 @window:
1429 @x:
1430 @y:
1431 @Returns:
1432
1433
1434 <!-- ##### FUNCTION gdk_window_get_root_coords ##### -->
1435 <para>
1436
1437 </para>
1438
1439 @window:
1440 @x:
1441 @y:
1442 @root_x:
1443 @root_y:
1444
1445
1446 <!-- ##### FUNCTION gdk_window_get_pointer ##### -->
1447 <para>
1448
1449 </para>
1450
1451 @window:
1452 @x:
1453 @y:
1454 @mask:
1455 @Returns:
1456
1457
1458 <!-- ##### ENUM GdkModifierType ##### -->
1459 <para>
1460 A set of bit-flags to indicate the state of modifier keys and mouse buttons
1461 in various event types. Typical modifier keys are Shift, Control, Meta, Super,
1462 Hyper, Alt, Compose, Apple, CapsLock or ShiftLock.
1463 </para>
1464 <para>
1465 Like the X Window System, GDK supports 8 modifier keys and 5 mouse buttons.
1466 </para>
1467 <para>
1468 Since 2.10, GDK recognizes which of the Meta, Super or Hyper keys are mapped
1469 to Mod2 - Mod5, and indicates this by setting %GDK_SUPER_MASK, %GDK_HYPER_MASK
1470 or %GDK_META_MASK in the state field of key events.
1471 </para>
1472
1473 @GDK_SHIFT_MASK: the Shift key.
1474 @GDK_LOCK_MASK: a Lock key (depending on the modifier mapping of the
1475   X server this may either be CapsLock or ShiftLock).
1476 @GDK_CONTROL_MASK: the Control key.
1477 @GDK_MOD1_MASK: the fourth modifier key (it depends on the modifier
1478   mapping of the X server which key is interpreted as this modifier, but
1479   normally it is the Alt key).
1480 @GDK_MOD2_MASK: the fifth modifier key (it depends on the modifier
1481   mapping of the X server which key is interpreted as this modifier).
1482 @GDK_MOD3_MASK: the sixth modifier key (it depends on the modifier
1483   mapping of the X server which key is interpreted as this modifier).
1484 @GDK_MOD4_MASK: the seventh modifier key (it depends on the modifier
1485   mapping of the X server which key is interpreted as this modifier).
1486 @GDK_MOD5_MASK: the eighth modifier key (it depends on the modifier
1487   mapping of the X server which key is interpreted as this modifier).
1488 @GDK_BUTTON1_MASK: the first mouse button.
1489 @GDK_BUTTON2_MASK: the second mouse button.
1490 @GDK_BUTTON3_MASK: the third mouse button.
1491 @GDK_BUTTON4_MASK: the fourth mouse button.
1492 @GDK_BUTTON5_MASK: the fifth mouse button.
1493 @GDK_SUPER_MASK: the Super modifier. Since 2.10
1494 @GDK_HYPER_MASK: the Hyper modifier. Since 2.10
1495 @GDK_META_MASK: the Meta modifier. Since 2.10
1496 @GDK_RELEASE_MASK: not used in GDK itself. GTK+ uses it to differentiate
1497   between (keyval, modifiers) pairs from key press and release events.
1498 @GDK_MODIFIER_MASK: a mask covering all modifier types.
1499
1500 <!-- ##### FUNCTION gdk_window_get_parent ##### -->
1501 <para>
1502
1503 </para>
1504
1505 @window:
1506 @Returns:
1507
1508
1509 <!-- ##### FUNCTION gdk_window_get_toplevel ##### -->
1510 <para>
1511
1512 </para>
1513
1514 @window:
1515 @Returns:
1516
1517
1518 <!-- ##### FUNCTION gdk_window_get_children ##### -->
1519 <para>
1520
1521 </para>
1522
1523 @window:
1524 @Returns:
1525
1526
1527 <!-- ##### FUNCTION gdk_window_peek_children ##### -->
1528 <para>
1529
1530 </para>
1531
1532 @window:
1533 @Returns:
1534
1535
1536 <!-- ##### FUNCTION gdk_window_get_events ##### -->
1537 <para>
1538
1539 </para>
1540
1541 @window:
1542 @Returns:
1543
1544
1545 <!-- ##### FUNCTION gdk_window_set_events ##### -->
1546 <para>
1547
1548 </para>
1549
1550 @window:
1551 @event_mask:
1552
1553
1554 <!-- ##### FUNCTION gdk_window_set_icon ##### -->
1555 <para>
1556
1557 </para>
1558
1559 @window:
1560 @icon_window:
1561 @pixmap:
1562 @mask:
1563
1564
1565 <!-- ##### FUNCTION gdk_window_set_icon_name ##### -->
1566 <para>
1567
1568 </para>
1569
1570 @window:
1571 @name:
1572
1573
1574 <!-- ##### FUNCTION gdk_window_set_transient_for ##### -->
1575 <para>
1576
1577 </para>
1578
1579 @window:
1580 @parent:
1581
1582
1583 <!-- ##### FUNCTION gdk_window_set_role ##### -->
1584 <para>
1585
1586 </para>
1587
1588 @window:
1589 @role:
1590
1591
1592 <!-- ##### FUNCTION gdk_window_set_startup_id ##### -->
1593 <para>
1594
1595 </para>
1596
1597 @window:
1598 @startup_id:
1599
1600
1601 <!-- ##### FUNCTION gdk_window_set_group ##### -->
1602 <para>
1603
1604 </para>
1605
1606 @window:
1607 @leader:
1608
1609
1610 <!-- ##### FUNCTION gdk_window_get_group ##### -->
1611 <para>
1612
1613 </para>
1614
1615 @window:
1616 @Returns:
1617
1618
1619 <!-- ##### FUNCTION gdk_window_set_decorations ##### -->
1620 <para>
1621
1622 </para>
1623
1624 @window:
1625 @decorations:
1626
1627
1628 <!-- ##### FUNCTION gdk_window_get_decorations ##### -->
1629 <para>
1630
1631 </para>
1632
1633 @window: The window to get the decorations from
1634 @decorations: The window decorations will be written here
1635 @Returns: %TRUE if the window has decorations set, %FALSE otherwise.
1636
1637
1638 <!-- ##### ENUM GdkWMDecoration ##### -->
1639 <para>
1640 These are hints originally defined by the Motif toolkit.
1641 The window manager can use them when determining how to decorate
1642 the window. The hint must be set before mapping the window.
1643 </para>
1644
1645 @GDK_DECOR_ALL: all decorations should be applied.
1646 @GDK_DECOR_BORDER: a frame should be drawn around the window.
1647 @GDK_DECOR_RESIZEH: the frame should have resize handles.
1648 @GDK_DECOR_TITLE: a titlebar should be placed above the window.
1649 @GDK_DECOR_MENU: a button for opening a menu should be included.
1650 @GDK_DECOR_MINIMIZE: a minimize button should be included.
1651 @GDK_DECOR_MAXIMIZE: a maximize button should be included.
1652
1653 <!-- ##### FUNCTION gdk_window_set_functions ##### -->
1654 <para>
1655
1656 </para>
1657
1658 @window:
1659 @functions:
1660
1661
1662 <!-- ##### ENUM GdkWMFunction ##### -->
1663 <para>
1664 These are hints originally defined by the Motif toolkit.
1665 The window manager can use them when determining the functions
1666 to offer for the window.
1667 The hint must be set before mapping the window.
1668 </para>
1669
1670 @GDK_FUNC_ALL: all functions should be offered.
1671 @GDK_FUNC_RESIZE: the window should be resizable.
1672 @GDK_FUNC_MOVE: the window should be movable.
1673 @GDK_FUNC_MINIMIZE: the window should be minimizable.
1674 @GDK_FUNC_MAXIMIZE: the window should be maximizable.
1675 @GDK_FUNC_CLOSE: the window should be closable.
1676
1677 <!-- ##### FUNCTION gdk_window_get_toplevels ##### -->
1678 <para>
1679
1680 </para>
1681
1682 @Returns:
1683
1684
1685 <!-- ##### FUNCTION gdk_get_default_root_window ##### -->
1686 <para>
1687
1688 </para>
1689
1690 @Returns:
1691
1692
1693 <!-- ##### STRUCT GdkPointerHooks ##### -->
1694 <para>
1695 A table of pointers to functions for getting quantities related to
1696 the current pointer position. GDK has one global table of this type,
1697 which can be set using gdk_set_pointer_hooks().
1698 </para>
1699 <para>
1700 This is only useful for such low-level tools as an event recorder.
1701 Applications should never have any reason to use this facility
1702 </para>
1703
1704 @get_pointer: Obtains the current pointer position and modifier state.
1705   The position is given in coordinates relative to the window containing
1706   the pointer, which is returned in @window.
1707 @window_at_pointer: Obtains the window underneath the mouse pointer,
1708   returning the location of that window in @win_x, @win_y. Returns %NULL
1709   if the window under the mouse pointer is not known to GDK (for example,
1710   belongs to another application).
1711
1712 <!-- ##### FUNCTION gdk_set_pointer_hooks ##### -->
1713 <para>
1714
1715 </para>
1716
1717 @new_hooks:
1718 @Returns:
1719
1720
1721 <!-- ##### FUNCTION gdk_offscreen_window_get_pixmap ##### -->
1722 <para>
1723
1724 </para>
1725
1726 @window:
1727 @Returns:
1728
1729
1730 <!-- ##### FUNCTION gdk_offscreen_window_set_embedder ##### -->
1731 <para>
1732
1733 </para>
1734
1735 @window:
1736 @embedder:
1737
1738
1739 <!-- ##### FUNCTION gdk_offscreen_window_get_embedder ##### -->
1740 <para>
1741
1742 </para>
1743
1744 @window:
1745 @Returns:
1746
1747
1748 <!-- ##### FUNCTION gdk_window_geometry_changed ##### -->
1749 <para>
1750
1751 </para>
1752
1753 @window:
1754
1755
1756 <!-- ##### FUNCTION gdk_window_redirect_to_drawable ##### -->
1757 <para>
1758
1759 </para>
1760
1761 @window:
1762 @drawable:
1763 @src_x:
1764 @src_y:
1765 @dest_x:
1766 @dest_y:
1767 @width:
1768 @height:
1769
1770
1771 <!-- ##### FUNCTION gdk_window_remove_redirection ##### -->
1772 <para>
1773
1774 </para>
1775
1776 @window:
1777
1778
1779 <!--
1780 Local variables:
1781 mode: sgml
1782 sgml-parent-document: ("../gdk-docs.sgml" "book" "refsect2" "")
1783 End:
1784 -->
1785
1786