/usr/share/gtk-doc/html/pygtk/class-gtkwindow.html is in python-gtk2-doc 2.24.0-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.Window</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="prev" href="class-gtkwidget.html" title="gtk.Widget"><link rel="next" href="class-gtkwindowgroup.html" title="gtk.WindowGroup"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.Window</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkwidget.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkwindowgroup.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.Window"><a name="class-gtkwindow"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.Window</h2><p>gtk.Window — a top-level window that holds one child widget.</p></div><div class="refsect1" title="Synopsis"><a name="id4122816"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.Window</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkbin.html" title="gtk.Bin">gtk.Bin</a></span></span>):
<code class="constructorsynopsis"> <span class="methodname"><a class="link" href="class-gtkwindow.html#constructor-gtkwindow" title="Constructor">gtk.Window</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>type</code></strong></span><span class="initializer">=gtk.WINDOW_TOPLEVEL</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-title" title="gtk.Window.set_title">set_title</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-title" title="gtk.Window.get_title">get_title</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-wmclass" title="gtk.Window.set_wmclass">set_wmclass</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>wmclass_name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>wmclass_class</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-role" title="gtk.Window.set_role">set_role</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>role</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-role" title="gtk.Window.get_role">get_role</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--add-accel-group" title="gtk.Window.add_accel_group">add_accel_group</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_group</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--remove-accel-group" title="gtk.Window.remove_accel_group">remove_accel_group</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_group</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-position" title="gtk.Window.set_position">set_position</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>position</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--activate-focus" title="gtk.Window.activate_focus">activate_focus</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-focus" title="gtk.Window.set_focus">set_focus</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>focus</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-focus" title="gtk.Window.get_focus">get_focus</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-default" title="gtk.Window.set_default">set_default</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_widget</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--activate-default" title="gtk.Window.activate_default">activate_default</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-transient-for" title="gtk.Window.set_transient_for">set_transient_for</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>parent</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-transient-for" title="gtk.Window.get_transient_for">get_transient_for</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-type-hint" title="gtk.Window.set_type_hint">set_type_hint</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>hint</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-type-hint" title="gtk.Window.get_type_hint">get_type_hint</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-destroy-with-parent" title="gtk.Window.set_destroy_with_parent">set_destroy_with_parent</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-destroy-with-parent" title="gtk.Window.get_destroy_with_parent">get_destroy_with_parent</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-resizable" title="gtk.Window.set_resizable">set_resizable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>resizable</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-resizable" title="gtk.Window.get_resizable">get_resizable</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-gravity" title="gtk.Window.set_gravity">set_gravity</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>gravity</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-gravity" title="gtk.Window.get_gravity">get_gravity</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-geometry-hints" title="gtk.Window.set_geometry_hints">set_geometry_hints</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>geometry_widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>base_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>base_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>width_inc</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>height_inc</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_aspect</code></strong></span><span class="initializer">=-1.0</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_aspect</code></strong></span><span class="initializer">=-1.0</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-screen" title="gtk.Window.set_screen">set_screen</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>screen</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-screen" title="gtk.Window.get_screen">get_screen</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--is-active" title="gtk.Window.is_active">is_active</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--has-toplevel-focus" title="gtk.Window.has_toplevel_focus">has_toplevel_focus</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame">set_has_frame</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-has-frame" title="gtk.Window.get_has_frame">get_has_frame</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-frame-dimensions" title="gtk.Window.set_frame_dimensions">set_frame_dimensions</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>left</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>top</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>right</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>bottom</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-frame-dimensions" title="gtk.Window.get_frame_dimensions">get_frame_dimensions</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-decorated" title="gtk.Window.set_decorated">set_decorated</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-decorated" title="gtk.Window.get_decorated">get_decorated</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list">set_icon_list</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-icon-list" title="gtk.Window.get_icon_list">get_icon_list</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon" title="gtk.Window.set_icon">set_icon</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-from-file" title="gtk.Window.set_icon_from_file">set_icon_from_file</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filename</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-icon" title="gtk.Window.get_icon">get_icon</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-modal" title="gtk.Window.set_modal">set_modal</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>modal</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-modal" title="gtk.Window.get_modal">get_modal</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--add-mnemonic" title="gtk.Window.add_mnemonic">add_mnemonic</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--remove-mnemonic" title="gtk.Window.remove_mnemonic">remove_mnemonic</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--mnemonic-activate" title="gtk.Window.mnemonic_activate">mnemonic_activate</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>modifier</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-mnemonic-modifier" title="gtk.Window.set_mnemonic_modifier">set_mnemonic_modifier</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>modifier</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-mnemonic-modifier" title="gtk.Window.get_mnemonic_modifier">get_mnemonic_modifier</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-mnemonics-visible" title="gtk.Window.set_mnemonics_visible">set_mnemonics_visible</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-mnemonics-visible" title="gtk.Window.get_mnemonics_visible">get_mnemonics_visible</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--activate-key" title="gtk.Window.activate_key">activate_key</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>event</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--propagate-key-event" title="gtk.Window.propagate_key_event">propagate_key_event</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>event</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--present" title="gtk.Window.present">present</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--iconify" title="gtk.Window.iconify">iconify</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--deiconify" title="gtk.Window.deiconify">deiconify</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--stick" title="gtk.Window.stick">stick</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--unstick" title="gtk.Window.unstick">unstick</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--maximize" title="gtk.Window.maximize">maximize</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--unmaximize" title="gtk.Window.unmaximize">unmaximize</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--fullscreen" title="gtk.Window.fullscreen">fullscreen</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--unfullscreen" title="gtk.Window.unfullscreen">unfullscreen</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-keep-above" title="gtk.Window.set_keep_above">set_keep_above</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>setting</code></em></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-keep-below" title="gtk.Window.set_keep_below">set_keep_below</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>setting</code></em></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--begin-resize-drag" title="gtk.Window.begin_resize_drag">begin_resize_drag</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>edge</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>button</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>root_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>root_y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--begin-move-drag" title="gtk.Window.begin_move_drag">begin_move_drag</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>button</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>root_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>root_y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-default-size" title="gtk.Window.set_default_size">set_default_size</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>width</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>height</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-default-size" title="gtk.Window.get_default_size">get_default_size</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--resize" title="gtk.Window.resize">resize</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>width</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>height</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-size" title="gtk.Window.get_size">get_size</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--move" title="gtk.Window.move">move</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-position" title="gtk.Window.get_position">get_position</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--parse-geometry" title="gtk.Window.parse_geometry">parse_geometry</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>geometry</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--reshow-with-initial-size" title="gtk.Window.reshow_with_initial_size">reshow_with_initial_size</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--tooltips-get-info-from-tip-window" title="gtk.Window.tooltips_get_info_from_tip_window">tooltips_get_info_from_tip_window</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-focus-on-map" title="gtk.Window.set_focus_on_map">set_focus_on_map</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-focus-on-map" title="gtk.Window.get_focus_on_map">get_focus_on_map</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-name" title="gtk.Window.set_icon_name">set_icon_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-icon-name" title="gtk.Window.get_icon_name">get_icon_name</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-urgency-hint" title="gtk.Window.set_urgency_hint">set_urgency_hint</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>urgency_hint</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-urgency-hint" title="gtk.Window.get_urgency_hint">get_urgency_hint</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--present-with-time" title="gtk.Window.present_with_time">present_with_time</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-deletable" title="gtk.Window.set_deletable">set_deletable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-deletable" title="gtk.Window.get_deletable">get_deletable</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-group" title="gtk.Window.get_group">get_group</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--has-group" title="gtk.Window.has_group">has_group</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-window-type" title="gtk.Window.get_window_type">get_window_type</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-opacity" title="gtk.Window.set_opacity">set_opacity</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>opacity</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-opacity" title="gtk.Window.get_opacity">get_opacity</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-startup-id" title="gtk.Window.set_startup_id">set_startup_id</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>startup_id</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-default-widget" title="gtk.Window.get_default_widget">get_default_widget</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-skip-taskbar-hint" title="gtk.Window.set_skip_taskbar_hint">set_skip_taskbar_hint</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-skip-taskbar-hint" title="gtk.Window.get_skip_taskbar_hint">get_skip_taskbar_hint</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-skip-pager-hint" title="gtk.Window.set_skip_pager_hint">set_skip_pager_hint</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-skip-pager-hint" title="gtk.Window.get_skip_pager_hint">get_skip_pager_hint</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-accept-focus" title="gtk.Window.set_accept_focus">set_accept_focus</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--get-accept-focus" title="gtk.Window.get_accept_focus">get_accept_focus</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table><pre class="programlisting">
<span class="bold"><strong>Functions</strong></span>
<code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon" title="gtk.window_set_default_icon">gtk.window_set_default_icon</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-from-file" title="gtk.window_set_default_icon_from_file">gtk.window_set_default_icon_from_file</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filename</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-list" title="gtk.window_set_default_icon_list">gtk.window_set_default_icon_list</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-get-default-icon-list" title="gtk.window_get_default_icon_list">gtk.window_get_default_icon_list</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-auto-startup-notification" title="gtk.window_set_auto_startup_notification">gtk.window_set_auto_startup_notification</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-list-toplevels" title="gtk.window_list_toplevels">gtk.window_list_toplevels</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-name" title="gtk.window_set_default_icon_name">gtk.window_set_default_icon_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code></pre></div><div class="refsect1" title="Ancestry"><a name="id4125703"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
+-- <a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
+-- <a class="link" href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
+-- <a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>
+-- <a class="link" href="class-gtkbin.html" title="gtk.Bin">gtk.Bin</a>
+-- <a class="link" href="class-gtkwindow.html" title="gtk.Window">gtk.Window</a>
</pre></div><div class="refsect1" title="Implemented Interfaces"><a name="id4125754"></a><h2>Implemented Interfaces</h2><p>
<a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>
implements
<a class="link" href="class-gtkbuildable.html" title="gtk.Buildable"><code class="classname">gtk.Buildable</code></a>
</p></div><div class="refsect1" title="gtk.Window Properties"><a name="properties-gtkwindow"></a><h2>gtk.Window Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><p><a class="link" href="class-gtkwidget.html#properties-gtkwidget" title="gtk.Widget Properties">gtk.Widget Properties</a></p><p><a class="link" href="class-gtkcontainer.html#properties-gtkcontainer" title="gtk.Container Properties">gtk.Container Properties</a></p><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"accept-focus"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the window should receive
the input focus. Default value: <code class="literal">True</code>. Available in GTK+
2.4 and above.</td></tr><tr valign="top"><td valign="top">"allow-grow"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the user can expand the
window beyond its minimum size. Default value: <code class="literal">True</code>.</td></tr><tr valign="top"><td valign="top">"allow-shrink"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the window has no minimum
size. Setting this to <code class="literal">True</code> is a bad
idea 99% of the time. Default value: <code class="literal">False</code>.</td></tr><tr valign="top"><td valign="top">"decorated"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the window should be
decorated by the window manager. Default value: <code class="literal">True</code>.
Available in GTK+ 2.4 and above.</td></tr><tr valign="top"><td valign="top">"default-height"</td><td valign="top">Read-Write</td><td valign="top">The default height of the window, used when initially
showing the window. Allowed values: >= -1. Default value: -1</td></tr><tr valign="top"><td valign="top">"default-width"</td><td valign="top">Read-Write</td><td valign="top">The default width of the window, used when initially
showing the window. Allowed values: >= -1. Default value: -1</td></tr><tr valign="top"><td valign="top">"deletable"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code> the window frame should have
a close button. This property is available in GTK+ 2.10 and
above.</td></tr><tr valign="top"><td valign="top">"destroy-with-parent"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the window should be
destroyed when its parent is destroyed. Default value:
<code class="literal">False</code>.</td></tr><tr valign="top"><td valign="top">"focus-on-map"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the window should
receive the input focus when mapped. Default value:
<code class="literal">True</code>. Available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"gravity"</td><td valign="top">Read-Write</td><td valign="top">The window gravity of the window. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--move" title="gtk.Window.move"><code class="methodname">move</code>()</a>
method and the <a class="xref" href="gdk-constants.html#gdk-gravity-constants" title="GDK Gravity Constants">GDK Gravity Constants</a> for more details about window
gravity. Default value:
<code class="literal">gtk.gdk.GRAVITY_NORTH_WEST</code>. Available in GTK+ 2.4 and
above.</td></tr><tr valign="top"><td valign="top">"has-toplevel-focus"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code>, the input focus is within
the window. Default value: <code class="literal">False</code>. Available in GTK+ 2.2
and above.</td></tr><tr valign="top"><td valign="top">"icon"</td><td valign="top">Read-Write</td><td valign="top">The icon for this window</td></tr><tr valign="top"><td valign="top">"icon-name"</td><td valign="top">Read-Write</td><td valign="top">The name of the themed icon to use as the window icon.
See <a class="link" href="class-gtkicontheme.html" title="gtk.IconTheme"><code class="classname">gtk.IconTheme</code></a>
for more details. Default value: <code class="literal">None</code>. Available in
GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"is-active"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code>, the toplevel is the current
active window. Default value: <code class="literal">False</code>. Available in GTK+ 2.2
and above.</td></tr><tr valign="top"><td valign="top">"mnemonics-visible"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, mnemonics are currently visible in
the window. Default value: <code class="literal">True</code>.</td></tr><tr valign="top"><td valign="top">"modal"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the window is modal (other
windows are not usable while this one is up). Default value:
<code class="literal">False</code>.</td></tr><tr valign="top"><td valign="top">"opacity"</td><td valign="top">Read-Write</td><td valign="top">The requested opacity of the window. See
<code class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-opacity" title="gtk.Window.set_opacity">gtk.Window.set_opacity</a></code>()
for more details about window opacity.
Allowed values: [0,1] Default value: 1.
Available in GTK+ 2.12.</td></tr><tr valign="top"><td valign="top">"resizable"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the user can resize the
window. Default value: <code class="literal">True</code>.</td></tr><tr valign="top"><td valign="top">"role"</td><td valign="top">Read-Write</td><td valign="top">Unique identifier for the window to be used when
restoring a session. Default value: <code class="literal">None</code>. Available in
GTK+ 2.4</td></tr><tr valign="top"><td valign="top">"screen"</td><td valign="top">Read-Write</td><td valign="top">The screen where this window will be displayed.
Available in GTK+ 2.2</td></tr><tr valign="top"><td valign="top">"skip-pager-hint"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the window should not be
in the pager. Default value: <code class="literal">False</code>. Available in GTK+ 2.2
and above.</td></tr><tr valign="top"><td valign="top">"skip-taskbar-hint"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the window should not be
in the task bar. Default value: <code class="literal">False</code>. Available in GTK+
2.2 and above.</td></tr><tr valign="top"><td valign="top">"startup-id"</td><td valign="top">Write</td><td valign="top">The :startup-id is a write-only property for setting window's
startup notification identifier. See
<code class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-startup-id" title="gtk.Window.set_startup_id">gtk.Window.set_startup_id</a></code>()
for more details. Default value: NULL.
Available in GTK+ 2.12 and above.</td></tr><tr valign="top"><td valign="top">"title"</td><td valign="top">Read-Write</td><td valign="top">The title of the window. Default value: <code class="literal">None</code>.</td></tr><tr valign="top"><td valign="top">"transient-for"</td><td valign="top">Read-Write-Construct</td><td valign="top">The transient parent of the window. See <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-transient-for" title="gtk.Window.set_transient_for"><code class="methodname">gtk.Window.set_transient_for()</code></a>
for more details about transient windows. This property is
available in GTK+ 2.10 and above.</td></tr><tr valign="top"><td valign="top">"type"</td><td valign="top">Read-Write</td><td valign="top">The type of the window. Default value:
<code class="literal">gtk.WINDOW_TOPLEVEL</code></td></tr><tr valign="top"><td valign="top">"type-hint"</td><td valign="top">Read-Write</td><td valign="top">Hint to help the desktop environment understand what
kind of window this is and how to treat it. Default value:
<code class="literal">gtk.gdk.WINDOW_TYPE_HINT_NORMAL</code>. Available in GTK+ 2.2
and above.</td></tr><tr valign="top"><td valign="top">"urgency-hint"</td><td valign="top">Read-Write</td><td valign="top">If True the window should be brought to the users
attention. Default value: <code class="literal">False</code>. Available in GTK+ 2.8
and above.</td></tr><tr valign="top"><td valign="top">"window-position"</td><td valign="top">Read-Write</td><td valign="top">The initial position of the window. Default value:
<code class="literal">gtk.WIN_POS_NONE</code></td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.Window Style Properties"><a name="style-properties-gtkwindow"></a><h2>gtk.Window Style Properties</h2><p><a class="link" href="class-gtkwidget.html#style-properties-gtkwidget" title="gtk.Widget Style Properties">gtk.Widget Style Properties</a></p></div><div class="refsect1" title="Attributes"><a name="id4126684"></a><h2>Attributes</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table cellpadding="5" width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"allow_grow"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code>, users can expand the window
beyond its minimum size.</td></tr><tr valign="top"><td valign="top">"allow_shrink"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code>, the window has no minimum
size.</td></tr><tr valign="top"><td valign="top">"configure_notify_received"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code> a window resize
configuration event has been received.</td></tr><tr valign="top"><td valign="top">"configure_request_count"</td><td valign="top">Read</td><td valign="top">The number of outstanding configuration
requests.</td></tr><tr valign="top"><td valign="top">"decorated"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code> the window will have
decorations like a titlebar, resize controls, etc. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-decorated" title="gtk.Window.set_decorated"><code class="methodname">set_decorated</code>()</a>
method.</td></tr><tr valign="top"><td valign="top">"default_widget"</td><td valign="top">Read</td><td valign="top">The child widget that will be activated by default. See
the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-default" title="gtk.Window.set_default"><code class="methodname">set_default</code>()</a>
method.</td></tr><tr valign="top"><td valign="top">"destroy_with_parent"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code> the window is destroyed when
its transient parent is destroyed.</td></tr><tr valign="top"><td valign="top">"focus_widget"</td><td valign="top">Read</td><td valign="top">The child widget that has the focus.</td></tr><tr valign="top"><td valign="top">"frame"</td><td valign="top">Read</td><td valign="top">The frame <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> (if
any). See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a>
and <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-frame-dimensions" title="gtk.Window.set_frame_dimensions"><code class="methodname">set_frame_dimensions</code>()</a>
methods.</td></tr><tr valign="top"><td valign="top">"frame_bottom"</td><td valign="top">Read</td><td valign="top">The height of the bottom frame border. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-frame-dimensions" title="gtk.Window.set_frame_dimensions"><code class="methodname">set_frame_dimensions</code>()</a>
and <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a>
methods.</td></tr><tr valign="top"><td valign="top">"frame_left"</td><td valign="top">Read</td><td valign="top">The width of the left frame border. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-frame-dimensions" title="gtk.Window.set_frame_dimensions"><code class="methodname">set_frame_dimensions</code>()</a>
and <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a>
methods.</td></tr><tr valign="top"><td valign="top">"frame_right"</td><td valign="top">Read</td><td valign="top">The width of the right frame border. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-frame-dimensions" title="gtk.Window.set_frame_dimensions"><code class="methodname">set_frame_dimensions</code>()</a>
and <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a>
methods.</td></tr><tr valign="top"><td valign="top">"frame_top"</td><td valign="top">Read</td><td valign="top">The height of the top frame border. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-frame-dimensions" title="gtk.Window.set_frame_dimensions"><code class="methodname">set_frame_dimensions</code>()</a>
and <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a>
methods.</td></tr><tr valign="top"><td valign="top">"gravity"</td><td valign="top">Read</td><td valign="top">The window's gravity. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--move" title="gtk.Window.move"><code class="methodname">move</code>()</a> and
<a class="link" href="class-gtkwindow.html#method-gtkwindow--set-gravity" title="gtk.Window.set_gravity"><code class="methodname">set_gravity</code>()</a>
methods.</td></tr><tr valign="top"><td valign="top">"group"</td><td valign="top">Read</td><td valign="top">The <a class="link" href="class-gtkwindowgroup.html" title="gtk.WindowGroup"><code class="classname">gtk.WindowGroup</code></a>
(if any) the window belongs to.</td></tr><tr valign="top"><td valign="top">"has_focus"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code> the window has the
focus.</td></tr><tr valign="top"><td valign="top">"has_frame"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code> the window has a frame
window. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a>
method.</td></tr><tr valign="top"><td valign="top">"has_user_ref_count"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code> the window has not been
destroyed.</td></tr><tr valign="top"><td valign="top">"iconify_initially"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code> the window has been
iconified by a call to the <a class="link" href="class-gtkwindow.html#method-gtkwindow--iconify" title="gtk.Window.iconify"><code class="methodname">iconify</code>()</a>
method.</td></tr><tr valign="top"><td valign="top">"keys_changed_handler"</td><td valign="top">Read</td><td valign="top">The idle handler ID for handling accelerator group
changes.</td></tr><tr valign="top"><td valign="top">"maximize_initially"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code> the window has been
maximized by a call to the <a class="link" href="class-gtkwindow.html#method-gtkwindow--maximize" title="gtk.Window.maximize"><code class="methodname">maximize</code>()</a>
method.</td></tr><tr valign="top"><td valign="top">"mnemonic_modifier"</td><td valign="top">Read</td><td valign="top">The mnemonic modifier used with a key to activate an
accelerator. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-mnemonic-modifier" title="gtk.Window.set_mnemonic_modifier"><code class="methodname">set_mnemonic_modifier</code>()</a>
method </td></tr><tr valign="top"><td valign="top">"modal"</td><td valign="top">Read</td><td valign="top">If True the window is modal. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-modal" title="gtk.Window.set_modal"><code class="methodname">set_modal</code>()</a>
method.</td></tr><tr valign="top"><td valign="top">"need_default_position"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code> the window needs an initial
position calculated.</td></tr><tr valign="top"><td valign="top">"need_default_size"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code> the window needs an initial
size calculated.</td></tr><tr valign="top"><td valign="top">"position"</td><td valign="top">Read</td><td valign="top">The initial position of the window. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-position" title="gtk.Window.set_position"><code class="methodname">set_position</code>()</a>
method.</td></tr><tr valign="top"><td valign="top">"stick_initially"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code> the window has been made
sticky by a call to the <a class="link" href="class-gtkwindow.html#method-gtkwindow--stick" title="gtk.Window.stick"><code class="methodname">stick</code>()</a>
method.</td></tr><tr valign="top"><td valign="top">"title"</td><td valign="top">Read</td><td valign="top">The title of the window.</td></tr><tr valign="top"><td valign="top">"transient_parent"</td><td valign="top">Read</td><td valign="top">The transient parent window. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-transient-for" title="gtk.Window.set_transient_for"><code class="methodname">set_transient_for</code>()</a>
method.</td></tr><tr valign="top"><td valign="top">"type"</td><td valign="top">Read</td><td valign="top">The type of the window: gtk.WINDOW_TOPLEVEL or gtk.WINDOW_POPUP.</td></tr><tr valign="top"><td valign="top">"type_hint"</td><td valign="top">Read</td><td valign="top">The window's type hint. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-type-hint" title="gtk.Window.set_type_hint"><code class="methodname">set_type_hint</code>()</a>
method.</td></tr><tr valign="top"><td valign="top">"wmclass_class"</td><td valign="top">Read</td><td valign="top">The window system class hint. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-wmclass" title="gtk.Window.set_wmclass"><code class="methodname">set_wmclass</code>()</a>
method.</td></tr><tr valign="top"><td valign="top">"wmclass_name"</td><td valign="top">Read</td><td valign="top">The window system name hint. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-wmclass" title="gtk.Window.set_wmclass"><code class="methodname">set_wmclass</code>()</a>
method.</td></tr><tr valign="top"><td valign="top">"wm_role"</td><td valign="top">Read</td><td valign="top">The unique identifier for the window. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-role" title="gtk.Window.set_role"><code class="methodname">set_role</code>()</a>
method.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.Window Signal Prototypes"><a name="signal-prototypes-gtkwindow"></a><h2>gtk.Window Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></p><p><a class="link" href="class-gtkobject.html#signal-prototypes-gtkobject" title="gtk.Object Signal Prototypes">gtk.Object Signal Prototypes</a></p><p><a class="link" href="class-gtkwidget.html#signal-prototypes-gtkwidget" title="gtk.Widget Signal Prototypes">gtk.Widget Signal Prototypes</a></p><p><a class="link" href="class-gtkcontainer.html#signal-prototypes-gtkcontainer" title="gtk.Container Signal Prototypes">gtk.Container Signal Prototypes</a></p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">"<a class="link" href="class-gtkwindow.html#signal-gtkwindow--activate-default" title='The "activate-default" gtk.Window Signal'>activate-default</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwindow.html#signal-gtkwindow--activate-focus" title='The "activate-focus" gtk.Window Signal'>activate-focus</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwindow.html#signal-gtkwindow--frame-event" title='The "frame-event" gtk.Window Signal'>frame-event</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwindow.html#signal-gtkwindow--keys-changed" title='The "keys-changed" gtk.Window Signal'>keys-changed</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwindow.html#signal-gtkwindow--move-focus" title='The "move-focus" gtk.Window Signal'>move-focus</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>direction</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkwindow.html#signal-gtkwindow--set-focus" title='The "set-focus" gtk.Window Signal'>set-focus</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" title="Description"><a name="id4128123"></a><h2>Description</h2><p>A <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> provides
a widget that users commonly think of as a window. That is, an area of the
display that is managed by the window manager and usually decorated with a
title bar, and items to allow the user to close, resize and move the
window. <code class="literal">PyGTK</code> provides two types of windows (see the
<a class="xref" href="gtk-constants.html#gtk-window-type-constants" title="GTK Window Type Constants">GTK Window Type Constants</a> section for more
information):</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><code class="literal">gtk.WINDOW_TOPLEVEL</code></span></p></td><td>A window that has no parent and usually has a frame and
decorations supplied by a window manager. Toplevels windows are the main
application window and dialogs.</td></tr><tr><td><p><span class="term"><code class="literal">gtk.WINDOW_POPUP</code></span></p></td><td>A window that is ignored by the window manager and has no
frame or decorations. A popup window is used for menus and
tooltips.</td></tr></tbody></table><p>Typically, applications only directly create and use toplevel
windows.</p><p>A <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> is a container (subclass of <a class="link" href="class-gtkbin.html" title="gtk.Bin"><code class="classname">gtk.Bin</code></a>) holding one child widget.</p></div><div class="refsect1" title="Constructor"><a name="constructor-gtkwindow"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.Window</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>type</code></strong></span><span class="initializer">=gtk.WINDOW_TOPLEVEL</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>type</code></strong> :</span></p></td><td>the type of window:
<code class="literal">gtk.WINDOW_TOPLEVEL</code> or
<code class="literal">gtk.WINDOW_POPUP</code></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>.</td></tr></tbody></table><p>Creates a new <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>, which is
a toplevel window that can contain other widgets. Nearly always, the type of
the window should be <code class="literal">gtk.WINDOW_TOPLEVEL</code> (see the <a class="xref" href="gtk-constants.html#gtk-window-type-constants" title="GTK Window Type Constants">GTK Window Type Constants</a> for more details).
<code class="literal">gtk.WINDOW_POPUP</code> is used to create a pop-up menu or
pop-up tooltip. On X11, popup windows are not controlled by the window
manager. If you simply want an undecorated window (no window borders), use
the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-decorated" title="gtk.Window.set_decorated"><code class="methodname">set_decorated</code>()</a>
method with a toplevel window, don't use a popup window.</p></div><div class="refsect1" title="Methods"><a name="id4128372"></a><h2>Methods</h2><div class="refsect2" title="gtk.Window.set_title"><a name="method-gtkwindow--set-title"></a><h3>gtk.Window.set_title</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_title</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>title</code></strong> :</span></p></td><td>the title of the window</td></tr></tbody></table><p>The <code class="methodname">set_title</code>() method sets the "title" property
of the <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> to the
value specified by <em class="parameter"><code>title</code></em>. The title of a window will
be displayed in its title bar. On the X Window System, the title bar is
rendered by the window manager, so exactly how the title appears to users
may vary according to a user's exact configuration. The title should help a
user distinguish this window from other windows they may have open. A good
title might include the application name and current document
filename.</p></div><div class="refsect2" title="gtk.Window.get_title"><a name="method-gtkwindow--get-title"></a><h3>gtk.Window.get_title</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_title</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the title of the window, or
<code class="literal">None</code>.</td></tr></tbody></table><p>The <code class="methodname">get_title</code>() method returns the
value of the "title" property of the window. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-title" title="gtk.Window.set_title"><code class="methodname">set_title</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Window.set_wmclass"><a name="method-gtkwindow--set-wmclass"></a><h3>gtk.Window.set_wmclass</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_wmclass</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>wmclass_name</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>wmclass_class</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>wmclass_name</code></strong> :</span></p></td><td>the window name hint</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>wmclass_class</code></strong> :</span></p></td><td>the window class hint</td></tr></tbody></table><p>The <code class="methodname">set_wmclass</code>() method sets the X
Window System "class" and "name" hints for a window. Applications should not
call this method. According to the ICCCM, you should always set these to the
same value for all windows in an application, and <code class="literal">PyGTK</code>
sets them to that value by default, so calling this method is sort of
pointless. However, you may want to call the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-role" title="gtk.Window.set_role"><code class="methodname">set_role</code>()</a>
method on each window in your application, for the benefit of the session
manager. Setting the role allows the window manager to restore window
positions when loading a saved session.</p></div><div class="refsect2" title="gtk.Window.set_role"><a name="method-gtkwindow--set-role"></a><h3>gtk.Window.set_role</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_role</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>role</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>role</code></strong> :</span></p></td><td>a unique identifier for the
window</td></tr></tbody></table><p>The <code class="methodname">set_role</code>() method sets a unique
identifier (specified by <em class="parameter"><code>role</code></em>) for the window to be
used when restoring a session. This method is only useful on X11. In
combination with the window title, the window role allows a window manager
to identify "the same" window when an application is restarted. So for
example you might set the "toolbox" role on your app's toolbox window, so
that when the user restarts their session, the window manager can put the
toolbox back in the same place. If a window already has a unique title, you
don't need to set the role, since the WM can use the title to identify the
window when restoring the session.d</p></div><div class="refsect2" title="gtk.Window.get_role"><a name="method-gtkwindow--get-role"></a><h3>gtk.Window.get_role</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_role</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the role of the window if set, or
<code class="literal">None</code>.</td></tr></tbody></table><p>The <code class="methodname">get_role</code>() method returns the role
of the window. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-role" title="gtk.Window.set_role"><code class="methodname">set_role</code>()</a>
method for further explanation.</p></div><div class="refsect2" title="gtk.Window.add_accel_group"><a name="method-gtkwindow--add-accel-group"></a><h3>gtk.Window.add_accel_group</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">add_accel_group</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_group</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>accel_group</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkaccelgroup.html" title="gtk.AccelGroup"><code class="classname">gtk.AccelGroup</code></a></td></tr></tbody></table><p>The <code class="methodname">add_accel_group</code>() method associates
the accelerator group specified by <em class="parameter"><code>accel_group</code></em> with
the window.</p></div><div class="refsect2" title="gtk.Window.remove_accel_group"><a name="method-gtkwindow--remove-accel-group"></a><h3>gtk.Window.remove_accel_group</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">remove_accel_group</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>accel_group</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>accel_group</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkaccelgroup.html" title="gtk.AccelGroup"><code class="classname">gtk.AccelGroup</code></a></td></tr></tbody></table><p>The <code class="methodname">remove_accel_group</code>() method
dissociates the accelerator group specified by
<em class="parameter"><code>accel_group</code></em> from the widget. This method reverses the
effects of the <a class="link" href="class-gtkwindow.html#method-gtkwindow--add-accel-group" title="gtk.Window.add_accel_group"><code class="methodname">add_accel_group</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Window.set_position"><a name="method-gtkwindow--set-position"></a><h3>gtk.Window.set_position</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_position</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>position</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>position</code></strong> :</span></p></td><td>a position constraint.</td></tr></tbody></table><p>The <code class="methodname">set_position</code>() method sets the
"window-position" property to the value of <em class="parameter"><code>position</code></em>.
The value of <em class="parameter"><code>position</code></em> must be one of the <a class="xref" href="gtk-constants.html#gtk-window-position-constants" title="GTK Window Position Constants">GTK Window Position Constants</a>.</p><p>If the old or new window position constraint is
<code class="literal">gtk.WIN_POS_CENTER_ALWAYS</code>, this will also cause the
window to be repositioned to satisfy the new constraint.</p></div><div class="refsect2" title="gtk.Window.activate_focus"><a name="method-gtkwindow--activate-focus"></a><h3>gtk.Window.activate_focus</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">activate_focus</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the window has a
focus widget</td></tr></tbody></table><p>The <code class="methodname">activate_focus</code>() method activates
the child widget with the focus. This method returns <code class="literal">True</code>
if the window has a widget with the focus.</p></div><div class="refsect2" title="gtk.Window.set_focus"><a name="method-gtkwindow--set-focus"></a><h3>gtk.Window.set_focus</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_focus</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>focus</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>focus</code></strong> :</span></p></td><td>the widget to be the new focus
widget or <code class="literal">None</code> to unset a focus widget</td></tr></tbody></table><p>The <code class="methodname">set_focus</code>() method sets the widget
specified by <em class="parameter"><code>focus</code></em> to be the focus widget for the
window. If <em class="parameter"><code>focus</code></em> is <code class="literal">None</code> the
window's focus widget is unset. To set the focus to a particular widget in
the toplevel, it is usually more convenient to use the <a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-focus" title="gtk.Widget.grab_focus"><code class="methodname">gtk.Widget.grab_focus</code>()</a>
method instead of this method.</p></div><div class="refsect2" title="gtk.Window.get_focus"><a name="method-gtkwindow--get-focus"></a><h3>gtk.Window.get_focus</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_focus</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the currently focused
widget.</td></tr></tbody></table><p>The <code class="methodname">get_focus</code>() method returns the
current focused widget within the window. The focus widget is the widget
that would have the focus if the toplevel window is focused.</p></div><div class="refsect2" title="gtk.Window.set_default"><a name="method-gtkwindow--set-default"></a><h3>gtk.Window.set_default</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_default</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>default_widget</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>default_widget</code></strong> :</span></p></td><td>the widget to be the default, or
<code class="literal">None</code> to unset the default widget.</td></tr></tbody></table><p>The <code class="methodname">set_default</code>() method sets the
window's default widget to the value specified by
<em class="parameter"><code>default_widget</code></em>. If
<em class="parameter"><code>default_widget</code></em> is <code class="literal">None</code> the
window's default widget is unset. The default widget is the widget that's
activated when the user presses <span class="keycap"><strong>Enter</strong></span> in a window. When
setting (rather than unsetting) the default widget it's generally easier to
call the <a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-default" title="gtk.Widget.grab_default"><code class="methodname">gtk.Widget.grab_default</code>()</a>
method on the widget. Before making a widget the default widget, you must
set the <code class="literal">gtk.CAN_DEFAULT</code> flag on the widget you'd like to
make the default using the <a class="link" href="class-gtkobject.html#method-gtkobject--set-flags" title="gtk.Object.set_flags"><code class="methodname">gtk.Object.set_flags</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Window.activate_default"><a name="method-gtkwindow--activate-default"></a><h3>gtk.Window.activate_default</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">activate_default</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the window has a
default widget or a focus widget.</td></tr></tbody></table><p>The <code class="methodname">activate_default</code>() method activates
the default widget. If there is no default widget or the default widget
cannot be activated, the window's focus widget (if any) is activated. This
method returns <code class="literal">False</code> if no default widget could be
activated or there is no focus widget.</p></div><div class="refsect2" title="gtk.Window.set_transient_for"><a name="method-gtkwindow--set-transient-for"></a><h3>gtk.Window.set_transient_for</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_transient_for</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>parent</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>parent</code></strong> :</span></p></td><td>the parent window or <code class="literal">None</code> to
remove the transient parent</td></tr></tbody></table><p>The <code class="methodname">set_transient_for</code>() method sets the
window as a transient window for the window specified by
<em class="parameter"><code>parent</code></em>. Dialog windows should be set transient for
the main application window they were spawned from. This allows window
managers to keep the dialog on top of the main window, or center the dialog
over the main window. The <a class="link" href="class-gtkdialog.html#constructor-gtkdialog" title="Constructor">gtk.Dialog</a>() constructor and other
convenience functions in <code class="literal">PyGTK</code> will sometimes call the
<code class="methodname">set_transient_for</code>() method on your behalf.
</p><p>
On Windows, this method will and put the child window on top of the parent,
much as the window manager would have done on X.</p></div><div class="refsect2" title="gtk.Window.get_transient_for"><a name="method-gtkwindow--get-transient-for"></a><h3>gtk.Window.get_transient_for</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_transient_for</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the transient parent for this window, or
<code class="literal">None</code> if no transient parent has been
set.</td></tr></tbody></table><p>The <code class="methodname">get_transient_for</code>() method returns
the transient parent for this window or <code class="literal">None</code> if no
transient window is set. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-transient-for" title="gtk.Window.set_transient_for"><code class="methodname">set_transient_for</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Window.set_type_hint"><a name="method-gtkwindow--set-type-hint"></a><h3>gtk.Window.set_type_hint</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_type_hint</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>hint</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>hint</code></strong> :</span></p></td><td>the window type</td></tr></tbody></table><p>The <code class="methodname">set_type_hint</code>() method sets the
window type hint for the window to the value specified by
<em class="parameter"><code>hint</code></em>. The value of <em class="parameter"><code>hint</code></em> must
be one of the <a class="xref" href="gdk-constants.html#gdk-window-type-hint-constants" title="GDK Window Type Hint Constants">GDK Window Type Hint Constants</a>.</p><p>By setting the type hint for the window, you allow the window
manager to decorate and handle the window in a way which is suitable to the
method of the window in your application. This method should be called
before the window becomes visible. The <a class="link" href="class-gtkdialog.html#constructor-gtkdialog" title="Constructor">gtk.Dialog</a>() constructor and other
convenience functions in <code class="literal">PyGTK</code> will sometimes call this
method on your behalf.</p></div><div class="refsect2" title="gtk.Window.get_type_hint"><a name="method-gtkwindow--get-type-hint"></a><h3>gtk.Window.get_type_hint</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_type_hint</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the type hint for the
window.</td></tr></tbody></table><p>The <code class="methodname">get_type_hint</code>() method returns the
type hint for this window. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-type-hint" title="gtk.Window.set_type_hint">s<code class="methodname">et_type_hint</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Window.set_destroy_with_parent"><a name="method-gtkwindow--set-destroy-with-parent"></a><h3>gtk.Window.set_destroy_with_parent</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_destroy_with_parent</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> destroy the window
with its transient parent</td></tr></tbody></table><p>The <code class="methodname">set_destroy_with_parent</code>() method
sets the "destroy-with-parent" property to the value specified by
<em class="parameter"><code>setting</code></em>. If <em class="parameter"><code>setting</code></em> is
<code class="literal">True</code>, destroying the transient parent of the window will
also destroy the window itself. This is useful for dialogs that shouldn't
persist beyond the lifetime of the main window they're associated
with.</p></div><div class="refsect2" title="gtk.Window.get_destroy_with_parent"><a name="method-gtkwindow--get-destroy-with-parent"></a><h3>gtk.Window.get_destroy_with_parent</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_destroy_with_parent</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the window will be
destroyed with its transient parent.</td></tr></tbody></table><p>The <code class="methodname">get_destroy_with_parent</code>() method
returns the value of the "destroy-with-parent" property that determines if
the window will be destroyed with its transient parent. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-destroy-with-parent" title="gtk.Window.set_destroy_with_parent"><code class="methodname">set_destroy_with_parent</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Window.set_resizable"><a name="method-gtkwindow--set-resizable"></a><h3>gtk.Window.set_resizable</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_resizable</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>resizable</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>resizable</code></strong> :</span></p></td><td>if <code class="literal">True</code> the user can resize
this window</td></tr></tbody></table><p>The <code class="methodname">set_resizable</code>() method sets the
"resizable" property to the value of <em class="parameter"><code>resizable</code></em>. If
<em class="parameter"><code>resizable</code></em> is <code class="literal">True</code> the user can
resize the window. Windows are user resizable by default.</p></div><div class="refsect2" title="gtk.Window.get_resizable"><a name="method-gtkwindow--get-resizable"></a><h3>gtk.Window.get_resizable</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_resizable</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the user can resize
the window</td></tr></tbody></table><p>The <code class="methodname">get_resizable</code>() method returns the
value of the "resizable" property. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-resizable" title="gtk.Window.set_resizable"><code class="methodname">set_resizable</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Window.set_gravity"><a name="method-gtkwindow--set-gravity"></a><h3>gtk.Window.set_gravity</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_gravity</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>gravity</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>gravity</code></strong> :</span></p></td><td>the window gravity</td></tr></tbody></table><p>The <code class="methodname">set_gravity</code>() method sets the
gravity of the window to the value specified by
<em class="parameter"><code>gravity</code></em>. The window gravity defines the meaning of
coordinates passed to the <a class="link" href="class-gtkwindow.html#method-gtkwindow--move" title="gtk.Window.move"><code class="methodname">move</code>()</a>
method. The value of gravity must be one of the <a class="xref" href="gdk-constants.html#gdk-gravity-constants" title="GDK Gravity Constants">GDK Gravity Constants</a>.</p><p>The default window gravity is
<code class="literal">gtk.gdk.GRAVITY_NORTH_WEST</code> which will typically "do what
you want."</p></div><div class="refsect2" title="gtk.Window.get_gravity"><a name="method-gtkwindow--get-gravity"></a><h3>gtk.Window.get_gravity</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_gravity</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td> the window gravity</td></tr></tbody></table><p>The <code class="methodname">get_gravity</code>() method returns window
gravity. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-gravity" title="gtk.Window.set_gravity"><code class="methodname">set_gravity</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Window.set_geometry_hints"><a name="method-gtkwindow--set-geometry-hints"></a><h3>gtk.Window.set_geometry_hints</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_geometry_hints</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>geometry_widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>base_width</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>base_height</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>width_inc</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>height_inc</code></strong></span><span class="initializer">=-1</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_aspect</code></strong></span><span class="initializer">=-1.0</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_aspect</code></strong></span><span class="initializer">=-1.0</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>geometry_widget</code></strong> :</span></p></td><td>the widget the geometry hints will be applied
to</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>min_width</code></strong> :</span></p></td><td>the minimum width of window (or -1 to use
requisition)</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>min_height</code></strong> :</span></p></td><td>the minimum height of window (or -1 to use
requisition)</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>max_width</code></strong> :</span></p></td><td>the maximum width of window (or -1 to use
requisition)</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>max_height</code></strong> :</span></p></td><td>the maximum height of window (or -1 to use
requisition)</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>base_width</code></strong> :</span></p></td><td>allowed window widths are base_width +
width_inc * N where N is any integer</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>base_height</code></strong> :</span></p></td><td>allowed window heights are base_height +
width_inc * N where N is any integer</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>width_inc</code></strong> :</span></p></td><td>the width resize increment</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>height_inc</code></strong> :</span></p></td><td>the height resize
increment</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>min_aspect</code></strong> :</span></p></td><td>the minimum width to height
ratio</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>max_aspect</code></strong> :</span></p></td><td>the maximum width to height
ratio</td></tr></tbody></table><p>The <code class="methodname">set_geometry_hints</code>() method sets up
hints about how a window can be resized by the user. You can set the minimum
and maximum widths and heights, the base width and height for resizing, the
allowed width and height resize increments (e.g. for xterm, you can only
resize by the size of a character), and the minimum and maximum aspect
ratios. If <em class="parameter"><code>geometry_widget</code></em> is not
<code class="literal">None</code> it specifies the widget to figure the geometry
on.</p></div><div class="refsect2" title="gtk.Window.set_screen"><a name="method-gtkwindow--set-screen"></a><h3>gtk.Window.set_screen</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_screen</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>screen</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>screen</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">set_screen</code>() method sets the
"screen" property to the <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>
specified by <em class="parameter"><code>screen</code></em>. The "screen" property contains
the screen that the window is displayed on. If the window is already mapped,
it will be unmapped, and then remapped on the new screen.</p></div><div class="refsect2" title="gtk.Window.get_screen"><a name="method-gtkwindow--get-screen"></a><h3>gtk.Window.get_screen</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_screen</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">get_screen</code>() method returns the
<a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>
that the window is displayed on.</p></div><div class="refsect2" title="gtk.Window.is_active"><a name="method-gtkwindow--is-active"></a><h3>gtk.Window.is_active</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">is_active</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the window is part
of the current active window.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">is_active</code>() method returns
<code class="literal">True</code> if the window is part of the current active
toplevel, i.e., the toplevel window receiving keystrokes. The return value
is <code class="literal">True</code> if the window is active the toplevel itself, or
if it is, for example, a <a class="link" href="class-gtkplug.html" title="gtk.Plug"><code class="classname">gtk.Plug</code></a> embedded in
the active toplevel. You might use this method if you wanted to draw a
widget differently in an active window from a widget in an inactive window.
See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--has-toplevel-focus" title="gtk.Window.has_toplevel_focus"><code class="methodname">has_toplevel_focus()</code></a>
method.</p></div><div class="refsect2" title="gtk.Window.has_toplevel_focus"><a name="method-gtkwindow--has-toplevel-focus"></a><h3>gtk.Window.has_toplevel_focus</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">has_toplevel_focus</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the the input focus
is within the window</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">has_toplevel_focus</code>() method returns
<code class="literal">True</code> if the input focus is within the window. For real
toplevel windows, this is identical to <a class="link" href="class-gtkwindow.html#method-gtkwindow--is-active" title="gtk.Window.is_active"><code class="methodname">is_active()</code></a>,
but for embedded windows, like a <a class="link" href="class-gtkplug.html" title="gtk.Plug"><code class="classname">gtk.Plug</code></a>, the results
will differ.</p></div><div class="refsect2" title="gtk.Window.set_has_frame"><a name="method-gtkwindow--set-has-frame"></a><h3>gtk.Window.set_has_frame</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_has_frame</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> PyGTK draws the
window border</td></tr></tbody></table><p>The <code class="methodname">set_has_frame</code>() method sets the
flag that causes <code class="literal">PyGTK</code> to draw its own window border for
the window.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This is a special-purpose method for the framebuffer port. For
most applications, you want the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-decorated" title="gtk.Window.set_decorated"><code class="methodname">set_decorated</code>()</a>
method instead,that tells the window manager whether to draw the window
border.</p></div><p>If this method is called on a window with setting of
<code class="literal">True</code>, before it is realized or showed, it will have a
"frame" window around the window's <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>,
accessible in the window's frame. Using the signal "frame-event" you can
receive all events targeted at the frame. This method is used by the
linux-fb port to implement managed windows, but it could conceivably be used
by X-programs that want to do their own window decorations.</p></div><div class="refsect2" title="gtk.Window.get_has_frame"><a name="method-gtkwindow--get-has-frame"></a><h3>gtk.Window.get_has_frame</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_has_frame</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if a frame has been
added to the window via the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a>
method.</td></tr></tbody></table><p>The <code class="methodname">get_has_frame</code>() method returns the
value of the window's "has_frame" flag that determines if the window has a
frame window exterior to its <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>. See
the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a>
method for more information.</p></div><div class="refsect2" title="gtk.Window.set_frame_dimensions"><a name="method-gtkwindow--set-frame-dimensions"></a><h3>gtk.Window.set_frame_dimensions</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_frame_dimensions</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>left</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>top</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>right</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>bottom</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>left</code></strong> :</span></p></td><td>the width of the left
border</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>top</code></strong> :</span></p></td><td>the height of the top
border</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>right</code></strong> :</span></p></td><td>the width of the right
border</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>bottom</code></strong> :</span></p></td><td>the height of the bottom
border</td></tr></tbody></table><p>The <code class="methodname">set_frame_dimensions</code>() method sets
the size of the frame around the window to the values specified by
<em class="parameter"><code>left</code></em>, <em class="parameter"><code>top</code></em>,
<em class="parameter"><code>bottom</code></em> and <em class="parameter"><code>right</code></em>.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This is a special-purpose method intended for the framebuffer
port. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a>
method. It will have no effect on the window border drawn by the window
manager, which is the normal case when using the X Window system.</p></div><p>For windows with frames (see the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a>
method) this method can be used to change the size of the frame
border.</p></div><div class="refsect2" title="gtk.Window.get_frame_dimensions"><a name="method-gtkwindow--get-frame-dimensions"></a><h3>gtk.Window.get_frame_dimensions</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_frame_dimensions</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a tuple containing the frame dimensions: the
width of the frame at the left; the height of the frame at the top; the
width of the frame at the right; and, the height of the frame at the
bottom.</td></tr></tbody></table><p>The <code class="methodname">get_frame_dimensions</code>() method
returns a tuple containing the frame dimensions: the width of the frame at
the left; the height of the frame at the top; the width of the frame at the
right; and, the height of the frame at the bottom.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This is a special-purpose method intended for the framebuffer
port See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a>
method. It will not return the size of the window border drawn by the window
manager, which is the normal case when using a windowing system. See the
<a class="link" href="class-gdkwindow.html#method-gdkwindow--get-frame-extents" title="gtk.gdk.Window.get_frame_extents"><code class="methodname">get_frame_extents</code>()</a>
to get the standard window border extents.</p></div><p>See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-has-frame" title="gtk.Window.set_has_frame"><code class="methodname">set_has_frame</code>()</a>
and <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-frame-dimensions" title="gtk.Window.set_frame_dimensions"><code class="methodname">set_frame_dimensions</code>()</a>
methods for more information.</p></div><div class="refsect2" title="gtk.Window.set_decorated"><a name="method-gtkwindow--set-decorated"></a><h3>gtk.Window.set_decorated</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_decorated</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> decorate the
window</td></tr></tbody></table><p>The <code class="methodname">set_decorated</code>() method sets the
decorated flag to the value specified by <em class="parameter"><code>setting</code></em>. If
<em class="parameter"><code>setting</code></em> is <code class="literal">True</code> the window will be
decorated. By default, windows are decorated with a title bar, resize
controls, etc. Some window managers allow PyGTK to disable these
decorations, creating a borderless window. If you set the decorated property
to <code class="literal">False</code> using this method, <code class="literal">PyGTK</code> will
do its best to convince the window manager not to decorate the window. On
Windows, this method always works, since there's no window manager policy
involved.</p></div><div class="refsect2" title="gtk.Window.get_decorated"><a name="method-gtkwindow--get-decorated"></a><h3>gtk.Window.get_decorated</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_decorated</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the window has been
set to have decorations</td></tr></tbody></table><p>The <code class="methodname">get_decorated</code>() method returns the
value of the decorated flag that determines if the window has been set to
have decorations such as a title bar. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-decorated" title="gtk.Window.set_decorated"><code class="methodname">set_decorated</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Window.set_icon_list"><a name="method-gtkwindow--set-icon-list"></a><h3>gtk.Window.set_icon_list</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_icon_list</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>zero or more <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
objects</td></tr></tbody></table><p>The <code class="methodname">set_icon_list</code>() method sets up the
icon representing the window using the set of <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
objects passed as arguments. If no <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
objects are passed in the icon is unset and reverts to the default icon. The
icon is used when the window is minimized (also known as iconified). Some
window managers or desktop environments may also place it in the window
frame, or display it in other contexts. This method allows you to pass in
the same icon in several hand-drawn sizes. The <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
objects should contain the natural sizes your icon is available in; i.e.,
don't scale the image before passing it to <code class="literal">PyGTK</code>. Scaling
is postponed until the last minute, when the desired final size is known, to
allow best quality. By passing several sizes, you may improve the final
image quality of the icon, by reducing or eliminating automatic image
scaling. The recommended sizes to provide are: 16x16, 32x32, 48x48 at
minimum, and larger images (64x64, 128x128) if you have them.</p><p>See the <a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-list" title="gtk.window_set_default_icon_list"><code class="methodname">gtk.window_set_default_icon_list</code>()</a>
function to set the icon for all windows in your application in one go. Note
that transient windows (those who have been set transient for another window
using the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-transient-for" title="gtk.Window.set_transient_for"><code class="methodname">set_transient_for</code>()</a>
method) will inherit their icon from their transient parent. So there's no
need to explicitly set the icon on transient windows.</p></div><div class="refsect2" title="gtk.Window.get_icon_list"><a name="method-gtkwindow--get-icon-list"></a><h3>gtk.Window.get_icon_list</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_icon_list</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a copy of the window's icon
list</td></tr></tbody></table><p>The <code class="methodname">get_icon_list</code>() method returns the
list of icons set by the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Window.set_icon"><a name="method-gtkwindow--set-icon"></a><h3>gtk.Window.set_icon</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_icon</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>icon</code></strong> :</span></p></td><td>an icon image, or
<code class="literal">None</code></td></tr></tbody></table><p>The <code class="methodname">set_icon</code>() method sets the "icon"
property to the value specified by <em class="parameter"><code>icon</code></em>. This icon is
used when the window is minimized (also known as iconified). Some window
managers or desktop environments may also place it in the window frame, or
display it in other contexts. The icon should be provided in whatever size
it was naturally drawn; that is, don't scale the image before passing it to
<code class="literal">PyGTK</code>. Scaling is postponed until the last minute, when
the desired final size is known, to allow best quality. If you have your
icon hand-drawn in multiple sizes, use the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a>
method. Then the best size will be used.</p><p>This method is equivalent to calling the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a>
method with a 1-element list. See the <a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-list" title="gtk.window_set_default_icon_list"><code class="methodname">gtk.window_set_default_icon_list</code>()</a>
function to set the icon for all windows in your application in one
go.</p></div><div class="refsect2" title="gtk.Window.set_icon_from_file"><a name="method-gtkwindow--set-icon-from-file"></a><h3>gtk.Window.set_icon_from_file</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_icon_from_file</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filename</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>filename</code></strong> :</span></p></td><td>the name of a file containing an icon
image</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the icon was
loaded.</td></tr></tbody></table><p>The <code class="methodname">set_icon_from_file</code>() method sets
the "icon" property to the icon loaded from the file specified by
<em class="parameter"><code>filename</code></em>. The icon is used when the window is
minimized (also known as iconified). See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon" title="gtk.Window.set_icon"><code class="methodname">set_icon</code>()</a>)
method for more information. This method is equivalent to calling the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon" title="gtk.Window.set_icon"><code class="methodname">set_icon</code>()</a>
method with a pixbuf created by loading the image from
<em class="parameter"><code>filename</code></em>.</p><p>The GError exception is raised if an error occurs while loading
the pixbuf from <em class="parameter"><code>filename</code></em>.</p></div><div class="refsect2" title="gtk.Window.get_icon"><a name="method-gtkwindow--get-icon"></a><h3>gtk.Window.get_icon</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_icon</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the icon for window</td></tr></tbody></table><p>The <code class="methodname">get_icon</code>() method returns the value
of the "icon" property set by the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon" title="gtk.Window.set_icon"><code class="methodname">set_icon</code>()</a>
(or if you've called the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a>
method, returns the first icon in the icon list).</p></div><div class="refsect2" title="gtk.Window.set_modal"><a name="method-gtkwindow--set-modal"></a><h3>gtk.Window.set_modal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_modal</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>modal</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>modal</code></strong> :</span></p></td><td>if <code class="literal">True</code> the window is
modal</td></tr></tbody></table><p>The <code class="methodname">set_modal</code>() method sets the "modal"
property to the value of <em class="parameter"><code>modal</code></em>. If
<em class="parameter"><code>modal</code></em> is <code class="literal">True</code> the window becomes
modal. Modal windows prevent interaction with other windows in the same
application. Typically modal windows are used for <a class="link" href="class-gtkdialog.html" title="gtk.Dialog"><code class="classname">gtk.Dialog</code></a> windows
that require a user response before the application can continue. To keep
modal dialogs on top of the main application windows, use the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-transient-for" title="gtk.Window.set_transient_for"><code class="methodname">set_transient_for</code>()</a>
method to make the dialog transient for the parent - most window managers
will then disallow lowering the dialog below the parent.</p></div><div class="refsect2" title="gtk.Window.get_modal"><a name="method-gtkwindow--get-modal"></a><h3>gtk.Window.get_modal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_modal</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the window is set to
be modal and establishes a grab when shown</td></tr></tbody></table><p>The <code class="methodname">get_modal</code>() method returns the
value of the "modal" property. If "modal" is <code class="literal">True</code> the
window is modal. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-modal" title="gtk.Window.set_modal"><code class="methodname">set_modal</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Window.add_mnemonic"><a name="method-gtkwindow--add-mnemonic"></a><h3>gtk.Window.add_mnemonic</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">add_mnemonic</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>keyval</code></strong> :</span></p></td><td>the mnemonic key</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>target</code></strong> :</span></p></td><td>the widget that gets activated by the
mnemonic</td></tr></tbody></table><p>The <code class="methodname">add_mnemonic</code>() method adds a
mnemonic key specified by <em class="parameter"><code>keyval</code></em> to this window. When
the mnemonic key is pressed the widget specified by
<em class="parameter"><code>target</code></em> will be activated.</p></div><div class="refsect2" title="gtk.Window.remove_mnemonic"><a name="method-gtkwindow--remove-mnemonic"></a><h3>gtk.Window.remove_mnemonic</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">remove_mnemonic</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>target</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>keyval</code></strong> :</span></p></td><td>the mnemonic key</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>target</code></strong> :</span></p></td><td>the widget that gets activated by the
mnemonic</td></tr></tbody></table><p>The <code class="methodname">remove_mnemonic</code>() method removes
the mnemonic specified by <em class="parameter"><code>keyval</code></em> for the widget
specified by <em class="parameter"><code>target</code></em> from this window.</p></div><div class="refsect2" title="gtk.Window.mnemonic_activate"><a name="method-gtkwindow--mnemonic-activate"></a><h3>gtk.Window.mnemonic_activate</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">mnemonic_activate</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>keyval</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>modifier</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>keyval</code></strong> :</span></p></td><td>the mnemonic key</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>modifier</code></strong> :</span></p></td><td>the modifiers</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>True if the activation was
done</td></tr></tbody></table><p>The<code class="methodname"> mnemonic_activate</code>() method
activates the targets associated with the mnemonic specified by
<em class="parameter"><code>keyval</code></em>. The window's mnemonic modifier must match
<em class="parameter"><code>modifier</code></em> to allow the activation to proceed. See the
<a class="link" href="class-gtkwindow.html#method-gtkwindow--set-mnemonic-modifier" title="gtk.Window.set_mnemonic_modifier"><code class="methodname">set_mnemonic_modifier</code>()</a>
method for more information.</p></div><div class="refsect2" title="gtk.Window.set_mnemonic_modifier"><a name="method-gtkwindow--set-mnemonic-modifier"></a><h3>gtk.Window.set_mnemonic_modifier</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_mnemonic_modifier</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>modifier</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>modifier</code></strong> :</span></p></td><td>the modifier mask used to activate mnemonics on
this window.</td></tr></tbody></table><p>The <code class="methodname">set_mnemonic_modifier</code>() method sets
the mnemonic modifier for this window to the value specified by
<em class="parameter"><code>modifier</code></em>. The value of
<em class="parameter"><code>modifier</code></em> is one of:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><code class="literal">gtk.gdk.SHIFT_MASK</code></span></p></td><td>The Shift key.</td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.CONTROL_MASK</code></span></p></td><td>The Control key. </td></tr><tr><td><p><span class="term"><code class="literal">gtk.gdk.MOD1_MASK</code></span></p></td><td>The fourth modifier key (it depends on the modifier
mapping of the X server which key is interpreted as this modifier, but
normally it is the Alt key).</td></tr></tbody></table><p></p></div><div class="refsect2" title="gtk.Window.get_mnemonic_modifier"><a name="method-gtkwindow--get-mnemonic-modifier"></a><h3>gtk.Window.get_mnemonic_modifier</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_mnemonic_modifier</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the modifier mask used to activate mnemonics on
this window.</td></tr></tbody></table><p>The <code class="methodname">get_mnemonic_modifier</code>() method
returns the mnemonic modifier for this window. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-mnemonic-modifier" title="gtk.Window.set_mnemonic_modifier"><code class="methodname">set_mnemonic_modifier</code>()</a>
method for more detail.</p></div><div class="refsect2" title="gtk.Window.set_mnemonics_visible"><a name="method-gtkwindow--set-mnemonics-visible"></a><h3>gtk.Window.set_mnemonics_visible</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_mnemonics_visible</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td><code class="literal">True</code> if mnemomics should be visible in the window, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">set_mnemonics_visible</code>() method sets whether mnemonics are currently visible in the window.</p></div><div class="refsect2" title="gtk.Window.get_mnemonics_visible"><a name="method-gtkwindow--get-mnemonics-visible"></a><h3>gtk.Window.get_mnemonics_visible</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_mnemonics_visible</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if mnemomics are currently visible in the window, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_mnemonics_visible</code>() method returns whether mnemonics are currently visible in the window.</p></div><div class="refsect2" title="gtk.Window.activate_key"><a name="method-gtkwindow--activate-key"></a><h3>gtk.Window.activate_key</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">activate_key</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>event</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>event</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkevent.html" title="gtk.gdk.Event"><code class="classname">gtk.gdk.Event</code></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if a mnemonic or
accelerator was found and activated.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">activate_key</code>() method activates
mnemonics and accelerators for the window. This is normally called by the
default <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--key-press-event" title='The "key-press-event" gtk.Widget Signal'>key-press-event</a>" signal
handler for toplevel windows, however in some cases it may be useful to call
this directly when overriding the standard key handling for a toplevel
window.</p></div><div class="refsect2" title="gtk.Window.propagate_key_event"><a name="method-gtkwindow--propagate-key-event"></a><h3>gtk.Window.propagate_key_event</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">propagate_key_event</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>event</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>event</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkevent.html" title="gtk.gdk.Event"><code class="classname">gtk.gdk.Event</code></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if a widget in the
focus chain handled the event.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">propagate_key_event</code>() method
propagates a key press or release event to the focus widget and up the focus
container chain until a widget handles the key event specified by
<em class="parameter"><code>event</code></em>. This is normally called by the default <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--key-press-event" title='The "key-press-event" gtk.Widget Signal'>key-press-event</a>" and
"<a class="link" href="class-gtkwidget.html#signal-gtkwidget--key-release-event" title='The "key-release-event" gtk.Widget Signal'>key-release-event</a>"
signal handlers for toplevel windows, however in some cases it may be useful
to call this directly when overriding the standard key handling for a
toplevel window.</p></div><div class="refsect2" title="gtk.Window.present"><a name="method-gtkwindow--present"></a><h3>gtk.Window.present</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">present</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">present</code>() method presents a window
to the user. This may mean raising the window in the stacking order,
deiconifying it, moving it to the current desktop, and/or giving it the
keyboard focus, possibly dependent on the user's platform, window manager,
and preferences. If the window is hidden, this method calls the the <a class="link" href="class-gtkwidget.html#method-gtkwidget--show" title="gtk.Widget.show"><code class="methodname">gtk.Widget.show</code>()</a>
method as well. This method should be used when the user tries to open a
window that's already open. Say for example the preferences dialog is
currently open, and the user chooses <span class="guimenuitem">Preferences</span>
from the menu a second time; use the <code class="methodname">present</code>()
method to move the already-open dialog where the user can see it.</p></div><div class="refsect2" title="gtk.Window.iconify"><a name="method-gtkwindow--iconify"></a><h3>gtk.Window.iconify</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">iconify</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">iconify</code>() method asks the window
manager to iconify (i.e. minimize) the specified the window. Note that you
shouldn't assume the window is definitely iconified afterward, because other
entities (e.g. the user or window manager) could deiconify it again, or
there may not be a window manager in which case iconification isn't
possible, etc. But normally the window will end up iconified. Just don't
write code that crashes if not. This method can be called before showing a
window, in which case the window will be iconified before it ever appears
on-screen. You can track iconification via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"
signal.</p></div><div class="refsect2" title="gtk.Window.deiconify"><a name="method-gtkwindow--deiconify"></a><h3>gtk.Window.deiconify</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">deiconify</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">deiconify</code>() method asks the window
manager to deiconify (i.e. unminimize) the specified the window. Note that
you shouldn't assume the window is definitely deiconified afterward, because
other entities (e.g. the user or window manager) could iconify it again
before your code which assumes deiconification gets to run. You can track
iconification via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"
signal.</p></div><div class="refsect2" title="gtk.Window.stick"><a name="method-gtkwindow--stick"></a><h3>gtk.Window.stick</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">stick</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">stick</code>() method asks the window
manager to stick the window, which means that it will appear on all user
desktops. Note that you shouldn't assume the window is definitely stuck
afterward, because other entities (e.g. the user or window manager) could
unstick it again, and some window managers do not support sticking windows.
But normally the window will end up stuck. Just don't write code that
crashes if not. This method can be called before showing a window. You can
track stickiness via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"
signal.</p></div><div class="refsect2" title="gtk.Window.unstick"><a name="method-gtkwindow--unstick"></a><h3>gtk.Window.unstick</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">unstick</span>(<span class="methodparam"></span>)</code></pre><p>The unstick() method asks the window manager to unstick the
window, which means that it will appear on only one of the user's desktops.
Note that you shouldn't assume the window is definitely unstuck afterward,
because other entities (e.g. the user or window manager) could stick it
again. But normally the window will end up stuck. Just don't write code that
crashes if not. You can track stickiness via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"
signal.</p></div><div class="refsect2" title="gtk.Window.maximize"><a name="method-gtkwindow--maximize"></a><h3>gtk.Window.maximize</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">maximize</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">maximize</code>() method asks the window
manager to maximize the window, so that it becomes full-screen. Note that
you shouldn't assume the window is definitely maximized afterward, because
other entities (e.g. the user or window manager) could unmaximize it again,
and not all window managers support maximization. But normally the window
will end up maximized. This method can be called before showing a window, in
which case the window will be maximized when it appears on-screen initially.
You can track maximization via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"
signal.</p></div><div class="refsect2" title="gtk.Window.unmaximize"><a name="method-gtkwindow--unmaximize"></a><h3>gtk.Window.unmaximize</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">unmaximize</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">unmaximize</code>() method asks the window
manager to unmaximize the window. Note that you shouldn't assume the window
is definitely unmaximized afterward, because other entities (e.g. the user
or window manager) could maximize it again, and not all window managers
honor requests to unmaximize. But normally the window will end up
unmaximized. You can track maximization via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"
signal.</p></div><div class="refsect2" title="gtk.Window.fullscreen"><a name="method-gtkwindow--fullscreen"></a><h3>gtk.Window.fullscreen</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">fullscreen</span>(<span class="methodparam"></span>)</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">fullscreen</code>() method requests the
window manager to place the window in the fullscreen state. Note you
shouldn't assume the window is definitely full screen afterward, because
other entities (e.g. the user or window manager) could unfullscreen it
again, and not all window managers honor requests to fullscreen windows. But
normally the window will end up fullscreen. Just don't write code that
crashes if not.</p><p>You can track the fullscreen state via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window-state-event</a>"
signal.</p></div><div class="refsect2" title="gtk.Window.unfullscreen"><a name="method-gtkwindow--unfullscreen"></a><h3>gtk.Window.unfullscreen</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">unfullscreen</span>(<span class="methodparam"></span>)</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">unfullscreen</code>() method requests the
window manager to toggle off the fullscreen state for the window. Note that
you shouldn't assume the window is definitely not full screen afterward,
because other entities (e.g. the user or window manager) could fullscreen it
again, and not all window managers honor requests to unfullscreen
windows. But normally the window will end up restored to its normal
state. Just don't write code that crashes if not.</p><p>You can track the fullscreen state via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window_state_event</a>"
signal.</p></div><div class="refsect2" title="gtk.Window.set_keep_above"><a name="method-gtkwindow--set-keep-above"></a><h3>gtk.Window.set_keep_above</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_keep_above</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> keep the window
above other windows</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">set_keep_above</code>() method requests
the window manager to keep the window on top if
<em class="parameter"><code>setting</code></em> is <code class="literal">True</code>. Note that you
shouldn't assume the window is definitely above afterward, because other
entities (e.g. the user or window manager) could not keep it above, and not
all window managers support keeping windows above. But normally the window
will end kept above. Just don't write code that crashes if not.</p><p>It's permitted to call this method before showing a window, so
the window will be kept above when it appears on-screen initially.</p><p>You can track the above state via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window_state_event</a>"
signal.</p><p>Note that, according to the <a class="ulink" href="http://standards.freedesktop.org/wm-spec/wm-spec-latest.html" target="_top">Extended
Window Manager Hints</a> specification, the above state is mainly meant
for user preferences and should not be used by applications e.g. for drawing
attention to their dialogs.</p></div><div class="refsect2" title="gtk.Window.set_keep_below"><a name="method-gtkwindow--set-keep-below"></a><h3>gtk.Window.set_keep_below</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_keep_below</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>setting</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td><td>if <code class="literal">True</code> keep the window
below other windows</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">set_keep_below</code>() method requests
the window manager to keep the window on the bottom (i.e. below all other
windows). Note that you shouldn't assume the window is definitely below
afterward, because other entities (e.g. the user or window manager) could
not keep it below, and not all window managers support putting windows
below. But normally the window will be kept below. Just don't write code
that crashes if not.</p><p>It's permitted to call this function before showing a window, in
which case the window will be kept below when it appears on-screen
initially.</p><p>You can track the below state via the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> "<a class="link" href="class-gtkwidget.html#signal-gtkwidget--window-state-event" title='The "window-state-event" gtk.Widget Signal'>window_state_event</a>"
signal.</p><p>Note that, according to the <a class="ulink" href="http://standards.freedesktop.org/wm-spec/wm-spec-latest.html" target="_top">Extended
Window Manager Hints</a> specification, the above state is mainly meant
for user preferences and should not be used by applications e.g. for drawing
attention to their dialogs.</p></div><div class="refsect2" title="gtk.Window.begin_resize_drag"><a name="method-gtkwindow--begin-resize-drag"></a><h3>gtk.Window.begin_resize_drag</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">begin_resize_drag</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>edge</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>button</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>root_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>root_y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>edge</code></strong> :</span></p></td><td>the position of the resize
control</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>button</code></strong> :</span></p></td><td>the mouse button that initiated the
drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>root_x</code></strong> :</span></p></td><td>the X position where the user clicked to
initiate the drag, in root window coordinates</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>root_y</code></strong> :</span></p></td><td>the Y position where the user clicked to
initiate the drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>timestamp</code></strong> :</span></p></td><td>the timestamp from the click event that
initiated the drag</td></tr></tbody></table><p>The <code class="methodname">begin_resize_drag</code>() method starts
resizing a window from the edge specified by <em class="parameter"><code>edge</code></em>.
The mouse button that started the resize is specified by
<em class="parameter"><code>button</code></em>; the location, by
<em class="parameter"><code>root_x</code></em> and <em class="parameter"><code>root_y</code></em>; and the
time of the event, by <em class="parameter"><code>timestamp</code></em>. The value of
<em class="parameter"><code>edge</code></em> must be one of the <a class="xref" href="gdk-constants.html#gdk-window-edge-constants" title="GDK Window Edge Constants">GDK Window Edge Constants</a>.</p><p>This method is used if an application has window resizing
controls. When <code class="literal">PyGTK</code> can support it, the resize will be
done using the standard mechanism for the window manager or windowing
system. Otherwise, <code class="literal">PyGTK</code> will try to emulate window
resizing, potentially not all that well, depending on the windowing
system.</p></div><div class="refsect2" title="gtk.Window.begin_move_drag"><a name="method-gtkwindow--begin-move-drag"></a><h3>gtk.Window.begin_move_drag</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">begin_move_drag</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>button</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>root_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>root_y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>button</code></strong> :</span></p></td><td>the mouse button that initiated the
drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>root_x</code></strong> :</span></p></td><td>the X position where the user clicked to
initiate the drag, in root window coordinates</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>root_y</code></strong> :</span></p></td><td>the Y position where the user clicked to
initiate the drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>timestamp</code></strong> :</span></p></td><td>the timestamp from the click event that
initiated the drag</td></tr></tbody></table><p>The <code class="methodname">begin_move_drag</code>() method starts
moving a window when the user presses the mouse button specified by
<em class="parameter"><code>button</code></em> at the location specified by
<em class="parameter"><code>root_x</code></em> and <em class="parameter"><code>root_y</code></em> at the time
specified by <em class="parameter"><code>timestamp</code></em>. This method is used if an
application has window movement grips. When <code class="literal">PyGTK</code> can
support it, the window movement will be done using the standard mechanism
for the window manager or windowing system. Otherwise,
<code class="literal">PyGTK</code> will try to emulate window movement, potentially
not all that well, depending on the windowing system.</p></div><div class="refsect2" title="gtk.Window.set_default_size"><a name="method-gtkwindow--set-default-size"></a><h3>gtk.Window.set_default_size</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_default_size</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>width</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>height</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>width</code></strong> :</span></p></td><td>the width in pixels, or -1 to unset the default
width</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>height</code></strong> :</span></p></td><td>the height in pixels, or -1 to unset the
default height</td></tr></tbody></table><p>The <code class="methodname">set_default_size</code>() method sets the
default size of the window to the specified <em class="parameter"><code>width</code></em> and
<em class="parameter"><code>height</code></em>. If the window's "natural" size (its size
request) is larger than the default, the default will be ignored. More
generally, if the default size does not obey the geometry hints for the
window (the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-geometry-hints" title="gtk.Window.set_geometry_hints"><code class="methodname">set_geometry_hints</code>()</a>
method can be used to set these explicitly), the default size will be
clamped to the nearest permitted size.</p><p>Unlike the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-size-request" title="gtk.Widget.set_size_request"><code class="methodname">gtk.Widget.set_size_request</code>()</a>
method, which sets a size request for a widget and thus would keep users
from shrinking the window, this method only sets the initial size, just as
if the user had resized the window themselves. Users can still shrink the
window again as they normally would. Setting a default size of -1 means to
use the "natural" default size (the size request of the window). For more
control over a window's initial size and how resizing works, investigate the
<a class="link" href="class-gtkwindow.html#method-gtkwindow--set-geometry-hints" title="gtk.Window.set_geometry_hints"><code class="methodname">set_geometry_hints</code>()</a>
method.</p><p>For some uses, the <a class="link" href="class-gtkwindow.html#method-gtkwindow--resize" title="gtk.Window.resize"><code class="methodname">resize</code>()</a>
method is more appropriate as it changes the current size of the window,
rather than the size to be used on initial display. The <a class="link" href="class-gtkwindow.html#method-gtkwindow--resize" title="gtk.Window.resize"><code class="methodname">resize</code>()</a>
method always affects the window itself, not the geometry widget. The
default size of a window only affects the first time a window is shown; if a
window is hidden and re-shown, it will remember the size it had prior to
hiding, rather than using the default size. Windows can't actually be 0x0 in
size, they must be at least 1x1, but passing 0 for
<em class="parameter"><code>width</code></em> and <em class="parameter"><code>height</code></em> is OK,
resulting in a 1x1 default size.</p></div><div class="refsect2" title="gtk.Window.get_default_size"><a name="method-gtkwindow--get-default-size"></a><h3>gtk.Window.get_default_size</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_default_size</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a tuple containing the default width and height
of the window</td></tr></tbody></table><p>The <code class="methodname">get_default_size</code>() method returns a
tuple containing the default width and height of the window. A value of -1
for the returned width or height indicates that a default size has not been
explicitly set for that dimension, so the "natural" size of the window will
be used. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-default-size" title="gtk.Window.set_default_size"><code class="methodname">set_default_size</code>()</a>
method for more information</p></div><div class="refsect2" title="gtk.Window.resize"><a name="method-gtkwindow--resize"></a><h3>gtk.Window.resize</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">resize</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>width</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>height</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>width</code></strong> :</span></p></td><td>the width in pixels to resize the window
to</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>height</code></strong> :</span></p></td><td>the height in pixels to resize the window
to</td></tr></tbody></table><p>The <code class="methodname">resize</code>() method resizes the window
to the specified <em class="parameter"><code>width</code></em> and
<em class="parameter"><code>height</code></em> as if the user had done so, obeying geometry
constraints. The default geometry constraint is that windows may not be
smaller than their size request; to override this constraint, call the <a class="link" href="class-gtkwidget.html#method-gtkwidget--set-size-request" title="gtk.Widget.set_size_request"><code class="methodname">gtk.Widget.set_size_request</code>()</a>
method to set the window's request to a smaller value. If the
<code class="methodname">resize</code>() method is called before showing a window
for the first time, it overrides any default size set with the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-default-size" title="gtk.Window.set_default_size"><code class="methodname">set_default_size</code>()</a>
method. Windows may not be resized smaller than 1 by 1 pixels.</p></div><div class="refsect2" title="gtk.Window.get_size"><a name="method-gtkwindow--get-size"></a><h3>gtk.Window.get_size</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_size</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a tuple containing the width and height of the
window</td></tr></tbody></table><p>The <code class="methodname">get_size</code>() method returns a tuple
containing the current width and height of the window. If the window is not
on-screen, it returns the size <code class="literal">PyGTK</code> will suggest to the
window manager for the initial window size (but this is not reliably the
same as the size the window manager will actually select). The size obtained
by the <code class="methodname">get_size</code>() method is the last size received
in a configure event, that is, <code class="literal">PyGTK</code> uses its
locally-stored size, rather than querying the X server for the size. As a
result, if you call the <a class="link" href="class-gtkwindow.html#method-gtkwindow--resize" title="gtk.Window.resize"><code class="methodname">resize</code>()</a>
method then immediately call the <code class="methodname">get_size</code>() method,
the size won't have taken effect yet. After the window manager processes the
resize request, PyGTK receives notification that the size has changed via a
configure event, and the size of the window gets updated.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Nearly any use of this method creates a race condition,
because the size of the window may change between the time that you get the
size and the time that you perform some action assuming that size is the
current size. To avoid race conditions, connect to "configure_event" on the
window and adjust your size-dependent state to match the size delivered in
the configure event.</p><p>The returned size does <span class="emphasis"><em>not</em></span> include the
size of the window manager decorations (aka the window frame or border).
Those are not drawn by <code class="literal">PyGTK</code> which has no reliable method
of determining their size.</p><p>If you are getting a window size in order to position the
window on-screen, there may be a better way. The preferred way is to simply
set the window's semantic type with the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-type-hint" title="gtk.Window.set_type_hint"><code class="methodname">set_type_hint</code>()</a>
method, that allows the window manager to center dialogs, etc. Also, if you
set the transient parent of dialogs with the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-transient-for" title="gtk.Window.set_transient_for"><code class="methodname">set_transient_for</code>()</a>
method, window managers will often center the dialog over its parent window.
It's much preferred to let the window manager handle these things rather
than doing it yourself, because all apps will behave consistently and
according to user prefs if the window manager handles it. Also, the window
manager can take the size of the window decorations/border into account,
while your application cannot.</p><p>In any case, if you insist on application-specified window
positioning, there's <span class="emphasis"><em>still</em></span> a better way than doing it
yourself - the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-position" title="gtk.Window.set_position"><code class="methodname">set_position</code>()</a>
method will frequently handle the details for you.</p></div></div><div class="refsect2" title="gtk.Window.move"><a name="method-gtkwindow--move"></a><h3>gtk.Window.move</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">move</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>x</code></strong> :</span></p></td><td>the X coordinate to move window
to</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y</code></strong> :</span></p></td><td>the Y coordinate to move window
to</td></tr></tbody></table><p>The <code class="methodname">move</code>() method asks the window
manager to move the window to the position specified by
<em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em>. Window managers are
free to ignore this. In fact, most window managers ignore requests for
initial window positions (instead using a user-defined placement algorithm)
and honor requests after the window has already been shown.</p><p>The position is the position of the gravity-determined
reference point for the window. The gravity determines two things: first,
the location of the reference point in root window coordinates; and second,
which point on the window is positioned at the reference point. By default
the gravity is <code class="literal">gtk.gdk.GRAVITY_NORTH_WEST</code>, so the
reference point is simply the <em class="parameter"><code>x</code></em>,
<em class="parameter"><code>y</code></em> supplied to the <code class="methodname">move</code>()
method. The top-left corner of the window decorations (aka window frame or
border) will be placed at <em class="parameter"><code>x</code></em>,
<em class="parameter"><code>y</code></em>. Therefore, to position a window at the top left of
the screen, you want to use the default gravity (which is
<code class="literal">gtk.gdk.GRAVITY_NORTH_WEST</code>) and move the window to
0,0.</p><p>To position a window at the bottom right corner of the screen,
you would set <code class="literal">gtk.gdk.GRAVITY_SOUTH_EAST</code>, which means
that the reference point is at <em class="parameter"><code>x</code></em> + the window width
and <em class="parameter"><code>y</code></em> + the window height, and the bottom-right
corner of the window border will be placed at that reference point. So, to
place a window in the bottom right corner you would first set gravity to
south east, then move the window:</p><pre class="programlisting">
window.set_gravity(gtk.gdk.GRAVITY_SOUTH_EAST)
width, height = window.get_size()
window.move(gtk.gdk.screen_width() - width, gtk.gdk.screen_height() - height)
</pre><p>The <a class="ulink" href="http://standards.freedesktop.org/wm-spec/wm-spec-latest.html" target="_top">Extended
Window Manager Hints</a> specification has a nice table of gravities in
the "implementation notes" section. The <a class="link" href="class-gtkwindow.html#method-gtkwindow--get-position" title="gtk.Window.get_position"><code class="methodname">get_position</code>()</a>
method documentation may also be relevant.</p></div><div class="refsect2" title="gtk.Window.get_position"><a name="method-gtkwindow--get-position"></a><h3>gtk.Window.get_position</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_position</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a tuple containing the X and Y coordinates of
the gravity-determined reference point</td></tr></tbody></table><p>The <code class="methodname">get_position</code>() method returns a
tuple containing the x and y coordinates of the window that you would need
to pass to the <a class="link" href="class-gtkwindow.html#method-gtkwindow--move" title="gtk.Window.move"><code class="methodname">move</code>()</a>
method to keep the window in its current position. This means that the
meaning of the returned value varies with window gravity. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--move" title="gtk.Window.move"><code class="methodname">move</code>()</a>
method for more details. If you haven't changed the window gravity, its
gravity will be <code class="literal">gtk.gdk.GRAVITY_NORTH_WEST</code>. This means
that the <code class="methodname">get_position</code>() method gets the position of
the top-left corner of the window manager frame for the window. The <a class="link" href="class-gtkwindow.html#method-gtkwindow--move" title="gtk.Window.move"><code class="methodname">move</code>()</a>
method sets the position of this same top-left corner.</p><p>The <code class="methodname">get_position</code>() method is not 100%
reliable because the X Window System does not specify a way to obtain the
geometry of the decorations placed on a window by the window manager. Thus
<code class="literal">PyGTK</code> is using a "best guess" that works with most window
managers. Moreover, nearly all window managers are historically broken with
respect to their handling of window gravity. So moving a window to its
current position as returned by the <code class="methodname">get_position</code>()
method tends to result in moving the window slightly. Window managers are
slowly getting better over time.</p><p>If a window has gravity
<code class="literal">gtk.gdk.GRAVITY_STATIC</code> the window manager frame is not
relevant, and thus the <code class="methodname">get_position</code>() method will
always produce accurate results. However you can't use static gravity to do
things like place a window in a corner of the screen, because static gravity
ignores the window manager decorations. If you are saving and restoring your
application's window positions, you should know that it's impossible for
applications to do this without getting it somewhat wrong because
applications do not have sufficient knowledge of window manager state. The
correct mechanism is to support the session management protocol (see the
"GnomeClient" object in the GNOME libraries for example) and allow the
window manager to save your window sizes and positions.</p></div><div class="refsect2" title="gtk.Window.parse_geometry"><a name="method-gtkwindow--parse-geometry"></a><h3>gtk.Window.parse_geometry</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">parse_geometry</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>geometry</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>geometry</code></strong> :</span></p></td><td>the geometry string</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if string was parsed
successfully</td></tr></tbody></table><p>The <code class="methodname">parse_geometry</code>() method parses the
standard X Window System geometry string specified by
<em class="parameter"><code>geometry</code></em>. The geometry string has the format
"WIDTHxHEIGHT+XOFFSET+YOFFSET" where WIDTH, HEIGHT, XOFFSET and YOFFSET are
specified in pixels (see the X documentation for more details). This method
works work on all <code class="literal">PyGTK</code> ports including Win32 but is
primarily intended for an X environment. If either a size or a position can
be extracted from the geometry string, the
<code class="methodname">parse_geometry</code>() method returns
<code class="literal">True</code> and calls the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-default-size" title="gtk.Window.set_default_size"><code class="methodname">set_default_size</code>()</a>
and <a class="link" href="class-gtkwindow.html#method-gtkwindow--move" title="gtk.Window.move"><code class="methodname">move</code>()</a>
methods to resize and move the window.</p><p>If the <code class="methodname">parse_geometry</code>() method returns
<code class="literal">True</code>, it will also set the
<code class="literal">gtk.gdk.HINT_USER_POS</code> and
<code class="literal">gtk.gdk.HINT_USER_SIZE</code> hints indicating to the window
manager that the size and position of the window was user-specified. This
causes most window managers to honor the geometry.</p></div><div class="refsect2" title="gtk.Window.reshow_with_initial_size"><a name="method-gtkwindow--reshow-with-initial-size"></a><h3>gtk.Window.reshow_with_initial_size</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">reshow_with_initial_size</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">reshow_with_initial_size</code>() method
hides the window, then reshows it, resetting the default size and position
of the window. Used by GUI builders only.</p></div><div class="refsect2" title="gtk.Window.tooltips_get_info_from_tip_window"><a name="method-gtkwindow--tooltips-get-info-from-tip-window"></a><h3>gtk.Window.tooltips_get_info_from_tip_window</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">tooltips_get_info_from_tip_window</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a 2-tuple containing the <a class="link" href="class-gtktooltips.html" title="gtk.Tooltips"><code class="classname">gtk.Tooltips</code></a>
and <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a>
displayed in the window or <code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">tooltips_get_info_from_tip_window</code>()
method returns a 2-tuple containing the <a class="link" href="class-gtktooltips.html" title="gtk.Tooltips"><code class="classname">gtk.Tooltips</code></a> and
<a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a>
displayed in the window. If the window is not displaying tooltips this
method returns None. This method is mostly intended for use by accessibility
technologies - applications should have little use for it.</p></div><div class="refsect2" title="gtk.Window.set_focus_on_map"><a name="method-gtkwindow--set-focus-on-map"></a><h3>gtk.Window.set_focus_on_map</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_focus_on_map</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td>If <code class="literal">True</code> this window would
like to receive focus when mapped.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_focus_on_map</code>() method sets the
"focus-on-map" property to the value of <em class="parameter"><code>setting</code></em>. If
<em class="parameter"><code>setting</code></em> is <code class="literal">True</code> a hint is set
asking the desktop environment to give focus to the window when it is
mapped.</p></div><div class="refsect2" title="gtk.Window.get_focus_on_map"><a name="method-gtkwindow--get-focus-on-map"></a><h3>gtk.Window.get_focus_on_map</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_focus_on_map</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the window would
like to receive focus when mapped.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_focus_on_map</code>() method returns
the value of the "focus-on-map" property. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-focus-on-map" title="gtk.Window.set_focus_on_map"><code class="methodname">set_focus_on_map</code>()</a>
method for more information.</p></div><div class="refsect2" title="gtk.Window.set_icon_name"><a name="method-gtkwindow--set-icon-name"></a><h3>gtk.Window.set_icon_name</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_icon_name</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>name</code></strong> :</span></p></td><td>the name of the themed icon or
<code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_icon_name</code>() method sets the
"icon-name" property to the value of <em class="parameter"><code>name</code></em>. If
<em class="parameter"><code>name</code></em> is <code class="literal">None</code>, then the default
themed icon will be used. The "icon-name" property contains the name of the
icon used for the window. See the <a class="link" href="class-gtkicontheme.html" title="gtk.IconTheme"><code class="classname">gtk.IconTheme</code></a>
reference for more information.</p></div><div class="refsect2" title="gtk.Window.get_icon_name"><a name="method-gtkwindow--get-icon-name"></a><h3>gtk.Window.get_icon_name</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_icon_name</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The name of the themed icon used for the
window icon or <code class="literal">None</code> if no icon is set.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_icon_name</code>() method returns the
name of the themed icon for the window, see the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-name" title="gtk.Window.set_icon_name"><code class="methodname">set_icon_name</code>()</a>
method for more information.</p></div><div class="refsect2" title="gtk.Window.set_urgency_hint"><a name="method-gtkwindow--set-urgency-hint"></a><h3>gtk.Window.set_urgency_hint</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_urgency_hint</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>urgency_hint</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>urgency_hint</code></strong> :</span></p></td><td>if <code class="literal">True</code> mark this window
as needing urgent attention.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">set_urgency_hint</code>() method sets the
"urgency-hint" property to the value of
<em class="parameter"><code>urgency_hint</code></em>. If the "urgency-hint" property is True
the window sets a hint to the desktop environment to draw the users
attention to the window.</p></div><div class="refsect2" title="gtk.Window.get_urgency_hint"><a name="method-gtkwindow--get-urgency-hint"></a><h3>gtk.Window.get_urgency_hint</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_urgency_hint</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the window is marked
as needing urgent user attention.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">get_urgency_hint</code>() method returns
the value of the "urgency-hint" property. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-urgency-hint" title="gtk.Window.set_urgency_hint"><code class="methodname">set_urgency_hint</code>()</a>
method for more information.</p></div><div class="refsect2" title="gtk.Window.present_with_time"><a name="method-gtkwindow--present-with-time"></a><h3>gtk.Window.present_with_time</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">present_with_time</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>timestamp</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>timestamp</code></strong> :</span></p></td><td>the timestamp of the user interaction (typically
a button or key press event) which triggered this call</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">present_with_time</code>() method presents
a window to the user in response to a user interaction. If you need to
present a window without a timestamp, use the <a class="link" href="class-gtkwindow.html#method-gtkwindow--present" title="gtk.Window.present"><code class="methodname">present</code>()</a>
method.</p></div><div class="refsect2" title="gtk.Window.set_deletable"><a name="method-gtkwindow--set-deletable"></a><h3>gtk.Window.set_deletable</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_deletable</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> decorate the window
as deletable</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>By default, windows have a close button in the window
frame. Some window managers allow GTK+ to disable this button. If you
set the deletable property to <code class="literal">False</code> using this
method, GTK+ will do its best to convince the window manager not to
show a close button. Depending on the system, this method may not have
any effect when called on a window that is already visible, so you
should call it before calling
<code class="methodname">gtk_window_show</code>().</p><p>On Windows, this method always works, since there's no window
manager policy involved.</p></div><div class="refsect2" title="gtk.Window.get_deletable"><a name="method-gtkwindow--get-deletable"></a><h3>gtk.Window.get_deletable</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_deletable</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the window has been
set to have a close button</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Returns whether the window has been set to have a close button
via the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-deletable" title="gtk.Window.set_deletable"><code class="methodname">gtk.Window.set_deletable()</code></a>
method.</p></div><div class="refsect2" title="gtk.Window.get_group"><a name="method-gtkwindow--get-group"></a><h3>gtk.Window.get_group</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_group</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the <a class="link" href="class-gtkwindowgroup.html" title="gtk.WindowGroup"><code class="classname">gtk.WindowGroup</code></a>
for a window or the default group</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Returns the <a class="link" href="class-gtkwindowgroup.html" title="gtk.WindowGroup"><code class="classname">gtk.WindowGroup</code></a>
or the default group, if the window does not have an explicit window
group.</p></div><div class="refsect2" title="gtk.Window.has_group"><a name="method-gtkwindow--has-group"></a><h3>gtk.Window.has_group</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">has_group</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the window has an explicit window group, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">has_group</code>() method returns whether window has an explicit window group.</p></div><div class="refsect2" title="gtk.Window.get_window_type"><a name="method-gtkwindow--get-window-type"></a><h3>gtk.Window.get_window_type</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_window_type</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the type of the window.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_window_type</code>() method gets the type of the window.</p></div><div class="refsect2" title="gtk.Window.set_opacity"><a name="method-gtkwindow--set-opacity"></a><h3>gtk.Window.set_opacity</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_opacity</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>opacity</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>opacity</code></strong> :</span></p></td><td>desired opacity, between 0 and 1.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Request the windowing system to make window partially transparent, with
opacity 0 being fully transparent and 1 fully opaque. (Values of the
opacity parameter are clamped to the [0,1] range.) On X11 this has any
effect only on X screens with a compositing manager running.
See <code class="methodname"><a class="link" href="class-gtkwidget.html#method-gtkwidget--is-composited" title="gtk.Widget.is_composited">gtk.Widget.is_composited</a></code>().
On Windows it should work always.
</p><p>
Note that setting a window's opacity after the window has been shown causes it to flicker once on Windows.
</p></div><div class="refsect2" title="gtk.Window.get_opacity"><a name="method-gtkwindow--get-opacity"></a><h3>gtk.Window.get_opacity</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_opacity</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the requested opacity for this window.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>Fetches the requested opacity for this window. See
<code class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-opacity" title="gtk.Window.set_opacity">gtk.Window.set_opacity</a></code>().</p></div><div class="refsect2" title="gtk.Window.set_startup_id"><a name="method-gtkwindow--set-startup-id"></a><h3>gtk.Window.set_startup_id</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_startup_id</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>startup_id</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>startup_id</code></strong> :</span></p></td><td>a string with startup-notification identifier</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Startup notification identifiers are used by desktop environment to track
application startup, to provide user feedback and other features. This
function changes the corresponding property on the underlying GdkWindow.
Normally, startup identifier is managed automatically and you should only
use this function in special cases like transferring focus from other processes.
You should use this function before calling
<code class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--present" title="gtk.Window.present">gtk.Window.present</a></code>()
or any equivalent function generating a window map event.
</p><p>
This function is only useful on X11, not with other GTK+ targets.
</p></div><div class="refsect2" title="gtk.Window.get_default_widget"><a name="method-gtkwindow--get-default-widget"></a><h3>gtk.Window.get_default_widget</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_default_widget</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The default widget, or <code class="literal">None</code>
if there is none.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.14 and above.</p></div><p>
Returns the default widget for window. See
<code class="methodname"><a class="link" href="class-gtkwindow.html#method-gtkwindow--set-default" title="gtk.Window.set_default">gtk.Window.set_default</a></code>()()
for more details.
</p></div><div class="refsect2" title="gtk.Window.set_skip_taskbar_hint"><a name="method-gtkwindow--set-skip-taskbar-hint"></a><h3>gtk.Window.set_skip_taskbar_hint</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_skip_taskbar_hint</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td><code class="literal">True</code> to keep this window from appearing in the task bar, <code class="literal">False</code> otherwise.</td></tr></tbody></table><p>The <code class="methodname">set_skip_taskbar_hint</code>() method set a hint
asking the desktop environment not to display the window in the task bar.</p></div><div class="refsect2" title="gtk.Window.get_skip_taskbar_hint"><a name="method-gtkwindow--get-skip-taskbar-hint"></a><h3>gtk.Window.get_skip_taskbar_hint</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_skip_taskbar_hint</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if this window is kept from appearing in the task bar, <code class="literal">False</code> otherwise.</td></tr></tbody></table><p>The <code class="methodname">get_skip_taskbar_hint</code>() method returns whether a hint
is set asking the desktop environment not to display the window in the task bar.</p></div><div class="refsect2" title="gtk.Window.set_skip_pager_hint"><a name="method-gtkwindow--set-skip-pager-hint"></a><h3>gtk.Window.set_skip_pager_hint</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_skip_pager_hint</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td><code class="literal">True</code> to keep this window from appearing in the pager, <code class="literal">False</code> otherwise.</td></tr></tbody></table><p>The <code class="methodname">set_skip_pager_hint</code>() method sets a hint asking the
desktop environment not to display the window in the pager. A "pager" is any desktop
navigation tool such as a workspace switcher that displays a thumbnail representation of
the windows on the screen.</p></div><div class="refsect2" title="gtk.Window.get_skip_pager_hint"><a name="method-gtkwindow--get-skip-pager-hint"></a><h3>gtk.Window.get_skip_pager_hint</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_skip_pager_hint</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if this window is kept from appearing in the pager, <code class="literal">False</code> otherwise.</td></tr></tbody></table><p>The <code class="methodname">get_skip_pager_hint</code>() method returns whether a hint
is set asking the desktop environment not to display the window in the pager.</p></div><div class="refsect2" title="gtk.Window.set_accept_focus"><a name="method-gtkwindow--set-accept-focus"></a><h3>gtk.Window.set_accept_focus</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_accept_focus</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td><code class="literal">True</code> to let this window receive input focus.</td></tr></tbody></table><p>The <code class="methodname">set_accept_focus</code>() method sets a hint asking
the desktop environment to receive the input focus or not.</p></div><div class="refsect2" title="gtk.Window.get_accept_focus"><a name="method-gtkwindow--get-accept-focus"></a><h3>gtk.Window.get_accept_focus</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_accept_focus</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the window should receive the input focus.</td></tr></tbody></table><p>The <code class="methodname">get_accept_focus</code>() method returns whether a hint
is set asking the desktop environment to receive the input focus.</p></div></div><div class="refsect1" title="Functions"><a name="id4138295"></a><h2>Functions</h2><div class="refsect2" title="gtk.window_set_default_icon_list"><a name="function-gtk--window-set-default-icon-list"></a><h3>gtk.window_set_default_icon_list</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.window_set_default_icon_list</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>zero or more <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
objects</td></tr></tbody></table><p>The <code class="function">gtk.window_set_default_icon_list</code>()
function sets an icon list to be used as fallback for windows that haven't
had the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a>
method called on them to set up a window-specific icon list. This function
allows you to set up the icon for all windows in your app at once. See the
<a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a>
method documentation for more details.</p></div><div class="refsect2" title="gtk.window_set_default_icon"><a name="function-gtk--window-set-default-icon"></a><h3>gtk.window_set_default_icon</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.window_set_default_icon</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>icon</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>icon</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.4 and above.</p></div><p>The <code class="function">gtk.window_set_default_icon</code>() function
sets an icon specified by <em class="parameter"><code>icon</code></em> to be used as the
fallback for windows that haven't had the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon" title="gtk.Window.set_icon"><code class="methodname">set_icon</code>()</a>
method called on them to set up a window-specific icon. This function allows
you to set up the icon for all windows in your app at once.</p></div><div class="refsect2" title="gtk.window_set_default_icon_from_file"><a name="function-gtk--window-set-default-icon-from-file"></a><h3>gtk.window_set_default_icon_from_file</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.window_set_default_icon_from_file</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filename</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>filename</code></strong> :</span></p></td><td>an icon file name</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.2 and above.</p></div><p>The <code class="function">gtk.window_set_default_icon_from_file</code>()
function sets an icon contained in the file specified by
<em class="parameter"><code>filename</code></em> to be used as the fallback for windows that
haven't had the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon" title="gtk.Window.set_icon"><code class="methodname">set_icon</code>()</a>
method called on them to set up a window-specific icon. This function allows
you to set up the icon for all windows in your app at once.</p><p>The GError exception is raised if an error occurs while loading
the icon pixbuf from <em class="parameter"><code>filename</code></em>.</p></div><div class="refsect2" title="gtk.window_get_default_icon_list"><a name="function-gtk--window-get-default-icon-list"></a><h3>gtk.window_get_default_icon_list</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.window_get_default_icon_list</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a copy of the applications default icon
list</td></tr></tbody></table><p>The <code class="function">gtk.window_get_default_icon_list</code>()
function returns the application's default icon list as set by the <a class="link" href="class-gtkwindow.html#function-gtk--window-set-default-icon-list" title="gtk.window_set_default_icon_list"><code class="methodname">gtk.window_set_default_icon_list</code>()</a>
function. See the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a>
method documentation for more details.</p></div><div class="refsect2" title="gtk.window_set_auto_startup_notification"><a name="function-gtk--window-set-auto-startup-notification"></a><h3>gtk.window_set_auto_startup_notification</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.window_set_auto_startup_notification</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code>, automatically do
startup notification</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.2 and above.</p></div><p>The
<code class="function">gtk.window_set_auto_startup_notification</code>() function
sets the auto startup notification setting to the value of <em class="parameter"><code>setting</code></em>. If <em class="parameter"><code>setting</code></em> is <code class="literal">True</code> startup notification will be done automatically.</p><p>By default, after showing the first <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> for each
<a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>, GTK+
calls the <code class="function">gdk_notify_startup_complete</code>() function. Call
this function to disable the automatic startup notification. You might do
this if your first window is a splash screen, and you want to delay
notification until after your real main window has been shown. In that
example, you would disable startup notification temporarily, show your
splash screen, then re-enable it so that showing the main window would
automatically result in notification.</p></div><div class="refsect2" title="gtk.window_list_toplevels"><a name="function-gtk--window-list-toplevels"></a><h3>gtk.window_list_toplevels</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.window_list_toplevels</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a list of all the toplevel <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a>
widgets</td></tr></tbody></table><p>The <code class="function">gtk.window_list_toplevels</code>() function
returns a list of all the toplevel <a class="link" href="class-gtkwindow.html" title="gtk.Window"><code class="classname">gtk.Window</code></a> widgets
in the application.</p></div><div class="refsect2" title="gtk.window_set_default_icon_name"><a name="function-gtk--window-set-default-icon-name"></a><h3>gtk.window_set_default_icon_name</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.window_set_default_icon_name</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code>, automatically do
startup notification</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.6 and above.</p></div><p>The <code class="function">gtk.window_set_default_icon_name</code>()
function sets an icon to be used as fallback for windows that haven't had
the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-list" title="gtk.Window.set_icon_list"><code class="methodname">set_icon_list</code>()</a>
method called on them from a named themed icon, see the <a class="link" href="class-gtkwindow.html#method-gtkwindow--set-icon-name" title="gtk.Window.set_icon_name"><code class="methodname">set_icon_name</code>()</a>
method.</p></div></div><div class="refsect1" title="Signals"><a name="id4139013"></a><h2>Signals</h2><div class="refsect2" title='The "activate-default" gtk.Window Signal'><a name="signal-gtkwindow--activate-default"></a><h3>The "activate-default" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td><td>the window that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "activate-default" signal is emitted when the default child
widget of <em class="parameter"><code>window</code></em> is activated usually by the user
pressing the <span class="keycap"><strong>Return</strong></span> or <span class="keycap"><strong>Enter</strong></span> key.</p></div><div class="refsect2" title='The "activate-focus" gtk.Window Signal'><a name="signal-gtkwindow--activate-focus"></a><h3>The "activate-focus" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td><td>the window that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "activate-focus" signal is emitted when the child widget
with the focus is activated usually by the user pressing the
<span class="keycap"><strong>Space</strong></span> key.</p></div><div class="refsect2" title='The "frame-event" gtk.Window Signal'><a name="signal-gtkwindow--frame-event"></a><h3>The "frame-event" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td><td>the window that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td><td>the event that triggered the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> to stop other handlers
from being invoked for the event. <code class="literal">False</code> to
propagate the event further.</td></tr></tbody></table><p>The "frame-event" signal is emitted when an event other than key
press or release or focus change is received on the window's frame.</p></div><div class="refsect2" title='The "keys-changed" gtk.Window Signal'><a name="signal-gtkwindow--keys-changed"></a><h3>The "keys-changed" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td><td>the window that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "keys-changed" signal is emitted when a mnemonic accelerator
is added, removed or changed or the mnemonic modifier is set.</p></div><div class="refsect2" title='The "move-focus" gtk.Window Signal'><a name="signal-gtkwindow--move-focus"></a><h3>The "move-focus" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>direction</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td><td>the window that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>direction</code></em> :</span></p></td><td>the move direction:
<code class="literal">gtk.DIR_TAB_FORWARD</code>,
<code class="literal">gtk.DIR_TAB_BACKWARD</code>, <code class="literal">gtk.DIR_UP</code>,
<code class="literal">gtk.DIR_DOWN</code>, <code class="literal">gtk.DIR_LEFT</code> or
<code class="literal">gtk.DIR_RIGHT</code></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "move-focus" signal is emitted when the focus is changed
within the window's child widgets. Usually this happens when the user
presses the <span class="keycap"><strong>Tab</strong></span>, the <span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>Tab</strong></span> or the
<span class="keycap"><strong>Up</strong></span>, <span class="keycap"><strong>Down</strong></span>, <span class="keycap"><strong>Left</strong></span> or
<span class="keycap"><strong>Right</strong></span> arrow keys.</p></div><div class="refsect2" title='The "set-focus" gtk.Window Signal'><a name="signal-gtkwindow--set-focus"></a><h3>The "set-focus" gtk.Window Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>window</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>widget</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td><td>the window that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td><td>the widget that receives the
focus</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "set-focus" signal is emitted when the focus changes to <em class="parameter"><code>widget</code></em> in <em class="parameter"><code>window</code></em>.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-gtkwidget.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gtk-class-reference.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="class-gtkwindowgroup.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.Widget </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.WindowGroup</td></tr></table></div></body></html>
|