DataMuseum.dk

top - download

    Length: 4835 (0x12e3)
    Names: »XMapWindow.3X«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./usr/man/cat3/XMapWindow.3X« 

Default Hex Dump

0x0000…0020 0a 0a 0a 5f 08 4f 5f 08 6e 5f 08 6c 5f 08 69 5f 08 6e 5f 08 65 20 5f 08 4d 5f 08 61 5f 08 6e 5f   ┆   _ O_ n_ l_ i_ n_ e _ M_ a_ n_┆
0x0020…0040 08 75 5f 08 61 5f 08 6c 20 20 20 20 20 20 20 20 20 20 20 4c 69 62 72 61 72 79 20 46 75 6e 63 74   ┆ u_ a_ l           Library Funct┆
0x0040…0060 69 6f 6e 73 20 20 20 20 20 20 20 20 20 20 58 4d 61 70 57 69 6e 64 6f 77 28 33 58 29 0a 0a 0a 0a   ┆ions          XMapWindow(3X)    ┆
0x0060…0080 4e 08 4e 08 4e 08 4e 41 08 41 08 41 08 41 4d 08 4d 08 4d 08 4d 45 08 45 08 45 08 45 0a 20 20 20   ┆N N N NA A A AM M M ME E E E    ┆
0x0080…00a0 20 20 58 4d 61 70 57 69 6e 64 6f 77 2c 20 58 4d 61 70 52 61 69 73 65 64 2c 20 58 4d 61 70 53 75   ┆  XMapWindow, XMapRaised, XMapSu┆
0x00a0…00c0 62 77 69 6e 64 6f 77 73 20 2d 20 6d 61 70 20 77 69 6e 64 6f 77 73 0a 0a 53 08 53 08 53 08 53 59   ┆bwindows - map windows  S S S SY┆
0x00c0…00e0 08 59 08 59 08 59 4e 08 4e 08 4e 08 4e 54 08 54 08 54 08 54 41 08 41 08 41 08 41 58 08 58 08 58   ┆ Y Y YN N N NT T T TA A A AX X X┆
0x00e0…0100 08 58 0a 20 20 20 20 20 58 4d 61 70 57 69 6e 64 6f 77 28 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f   ┆ X      XMapWindow(_ d_ i_ s_ p_┆
0x0100…0120 08 6c 5f 08 61 5f 08 79 2c 20 5f 08 77 29 0a 20 20 20 20 20 20 20 20 20 20 20 44 69 73 70 6c 61   ┆ l_ a_ y, _ w)            Displa┆
0x0120…0140 79 20 2a 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 3b 0a 20 20 20 20 20 20   ┆y *_ d_ i_ s_ p_ l_ a_ y;       ┆
0x0140…0160 20 20 20 20 20 57 69 6e 64 6f 77 20 5f 08 77 3b 0a 0a 20 20 20 20 20 58 4d 61 70 52 61 69 73 65   ┆     Window _ w;       XMapRaise┆
0x0160…0180 64 28 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 2c 20 5f 08 77 29 0a 20 20   ┆d(_ d_ i_ s_ p_ l_ a_ y, _ w)   ┆
0x0180…01a0 20 20 20 20 20 20 20 20 20 44 69 73 70 6c 61 79 20 2a 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f 08   ┆         Display *_ d_ i_ s_ p_ ┆
0x01a0…01c0 6c 5f 08 61 5f 08 79 3b 0a 20 20 20 20 20 20 20 20 20 20 20 57 69 6e 64 6f 77 20 5f 08 77 3b 0a   ┆l_ a_ y;            Window _ w; ┆
0x01c0…01e0 0a 20 20 20 20 20 58 4d 61 70 53 75 62 77 69 6e 64 6f 77 73 28 5f 08 64 5f 08 69 5f 08 73 5f 08   ┆      XMapSubwindows(_ d_ i_ s_ ┆
0x01e0…0200 70 5f 08 6c 5f 08 61 5f 08 79 2c 20 5f 08 77 29 0a 20 20 20 20 20 20 20 20 20 20 20 44 69 73 70   ┆p_ l_ a_ y, _ w)            Disp┆
0x0200…0220 6c 61 79 20 2a 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 3b 0a 20 20 20 20   ┆lay *_ d_ i_ s_ p_ l_ a_ y;     ┆
0x0220…0240 20 20 20 20 20 20 20 57 69 6e 64 6f 77 20 5f 08 77 3b 0a 0a 41 08 41 08 41 08 41 52 08 52 08 52   ┆       Window _ w;  A A A AR R R┆
0x0240…0260 08 52 47 08 47 08 47 08 47 55 08 55 08 55 08 55 4d 08 4d 08 4d 08 4d 45 08 45 08 45 08 45 4e 08   ┆ RG G G GU U U UM M M ME E E EN ┆
0x0260…0280 4e 08 4e 08 4e 54 08 54 08 54 08 54 53 08 53 08 53 08 53 0a 20 20 20 20 20 5f 08 64 5f 08 69 5f   ┆N N NT T T TS S S S      _ d_ i_┆
0x0280…02a0 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 63   ┆ s_ p_ l_ a_ y   Specifies the c┆
0x02a0…02c0 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 74 68 65 20 58 20 73 65 72 76 65 72 2e 0a 0a 20 20 20 20   ┆onnection to the X server.      ┆
0x02c0…02e0 20 5f 08 77 20 20 20 20 20 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 77 69 6e 64 6f   ┆ _ w         Specifies the windo┆
0x02e0…0300 77 2e 0a 0a 44 08 44 08 44 08 44 45 08 45 08 45 08 45 53 08 53 08 53 08 53 43 08 43 08 43 08 43   ┆w.  D D D DE E E ES S S SC C C C┆
0x0300…0320 52 08 52 08 52 08 52 49 08 49 08 49 08 49 50 08 50 08 50 08 50 54 08 54 08 54 08 54 49 08 49 08   ┆R R R RI I I IP P P PT T T TI I ┆
0x0320…0340 49 08 49 4f 08 4f 08 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 54 68 65 20 5f 08 58 5f 08   ┆I IO O O ON N N N      The _ X_ ┆
0x0340…0360 4d 5f 08 61 5f 08 70 5f 08 57 5f 08 69 5f 08 6e 5f 08 64 5f 08 6f 5f 08 77 20 66 75 6e 63 74 69   ┆M_ a_ p_ W_ i_ n_ d_ o_ w functi┆
0x0360…0380 6f 6e 20 6d 61 70 73 20 74 68 65 20 77 69 6e 64 6f 77 20 61 6e 64 20 61 6c 6c 20 6f 66 20 69 74   ┆on maps the window and all of it┆
0x0380…03a0 73 0a 20 20 20 20 20 73 75 62 77 69 6e 64 6f 77 73 20 74 68 61 74 20 68 61 76 65 20 68 61 64 20   ┆s      subwindows that have had ┆
0x03a0…03c0 6d 61 70 20 72 65 71 75 65 73 74 73 2e 20 20 4d 61 70 70 69 6e 67 20 61 20 77 69 6e 64 6f 77 0a   ┆map requests.  Mapping a window ┆
0x03c0…03e0 20 20 20 20 20 74 68 61 74 20 68 61 73 20 61 6e 20 75 6e 6d 61 70 70 65 64 20 61 6e 63 65 73 74   ┆     that has an unmapped ancest┆
0x03e0…0400 6f 72 20 64 6f 65 73 20 6e 6f 74 20 64 69 73 70 6c 61 79 20 74 68 65 20 77 69 6e 64 6f 77 0a 20   ┆or does not display the window  ┆
0x0400…0420 20 20 20 20 62 75 74 20 6d 61 72 6b 73 20 69 74 20 61 73 20 65 6c 69 67 69 62 6c 65 20 66 6f 72   ┆    but marks it as eligible for┆
0x0420…0440 20 64 69 73 70 6c 61 79 20 77 68 65 6e 20 74 68 65 20 61 6e 63 65 73 74 6f 72 0a 20 20 20 20 20   ┆ display when the ancestor      ┆
0x0440…0460 62 65 63 6f 6d 65 73 20 6d 61 70 70 65 64 2e 20 20 53 75 63 68 20 61 20 77 69 6e 64 6f 77 20 69   ┆becomes mapped.  Such a window i┆
0x0460…0480 73 20 63 61 6c 6c 65 64 20 75 6e 76 69 65 77 61 62 6c 65 2e 20 20 57 68 65 6e 0a 20 20 20 20 20   ┆s called unviewable.  When      ┆
0x0480…04a0 61 6c 6c 20 69 74 73 20 61 6e 63 65 73 74 6f 72 73 20 61 72 65 20 6d 61 70 70 65 64 2c 20 74 68   ┆all its ancestors are mapped, th┆
0x04a0…04c0 65 20 77 69 6e 64 6f 77 20 62 65 63 6f 6d 65 73 20 76 69 65 77 61 62 6c 65 0a 20 20 20 20 20 61   ┆e window becomes viewable      a┆
0x04c0…04e0 6e 64 20 77 69 6c 6c 20 62 65 20 76 69 73 69 62 6c 65 20 6f 6e 20 74 68 65 20 73 63 72 65 65 6e   ┆nd will be visible on the screen┆
0x04e0…0500 20 69 66 20 69 74 20 69 73 20 6e 6f 74 20 6f 62 73 63 75 72 65 64 20 62 79 0a 20 20 20 20 20 61   ┆ if it is not obscured by      a┆
0x0500…0520 6e 6f 74 68 65 72 20 77 69 6e 64 6f 77 2e 20 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 68 61   ┆nother window.  This function ha┆
0x0520…0540 73 20 6e 6f 20 65 66 66 65 63 74 20 69 66 20 74 68 65 20 77 69 6e 64 6f 77 0a 20 20 20 20 20 69   ┆s no effect if the window      i┆
0x0540…0560 73 20 61 6c 72 65 61 64 79 20 6d 61 70 70 65 64 2e 0a 0a 20 20 20 20 20 49 66 20 74 68 65 20 6f   ┆s already mapped.       If the o┆
0x0560…0580 76 65 72 72 69 64 65 2d 72 65 64 69 72 65 63 74 20 6f 66 20 74 68 65 20 77 69 6e 64 6f 77 20 69   ┆verride-redirect of the window i┆
0x0580…05a0 73 20 5f 08 46 5f 08 61 5f 08 6c 5f 08 73 5f 08 65 20 61 6e 64 20 69 66 20 73 6f 6d 65 0a 20 20   ┆s _ F_ a_ l_ s_ e and if some   ┆
0x05a0…05c0 20 20 20 6f 74 68 65 72 20 63 6c 69 65 6e 74 20 68 61 73 20 73 65 6c 65 63 74 65 64 20 5f 08 53   ┆   other client has selected _ S┆
0x05c0…05e0 5f 08 75 5f 08 62 5f 08 73 5f 08 74 5f 08 72 5f 08 75 5f 08 63 5f 08 74 5f 08 75 5f 08 72 5f 08   ┆_ u_ b_ s_ t_ r_ u_ c_ t_ u_ r_ ┆
0x05e0…0600 65 5f 08 52 5f 08 65 5f 08 64 5f 08 69 5f 08 72 5f 08 65 5f 08 63 5f 08 74 5f 08 4d 5f 08 61 5f   ┆e_ R_ e_ d_ i_ r_ e_ c_ t_ M_ a_┆
0x0600…0620 08 73 5f 08 6b 20 6f 6e 20 74 68 65 0a 20 20 20 20 20 70 61 72 65 6e 74 20 77 69 6e 64 6f 77 2c   ┆ s_ k on the      parent window,┆
0x0620…0640 20 74 68 65 6e 20 74 68 65 20 58 20 73 65 72 76 65 72 20 67 65 6e 65 72 61 74 65 73 20 61 20 5f   ┆ then the X server generates a _┆
0x0640…0660 08 4d 5f 08 61 5f 08 70 5f 08 52 5f 08 65 5f 08 71 5f 08 75 5f 08 65 5f 08 73 5f 08 74 0a 20 20   ┆ M_ a_ p_ R_ e_ q_ u_ e_ s_ t   ┆
0x0660…0680 20 20 20 65 76 65 6e 74 2c 20 61 6e 64 20 74 68 65 20 5f 08 58 5f 08 4d 5f 08 61 5f 08 70 5f 08   ┆   event, and the _ X_ M_ a_ p_ ┆
0x0680…06a0 57 5f 08 69 5f 08 6e 5f 08 64 5f 08 6f 5f 08 77 20 66 75 6e 63 74 69 6f 6e 20 64 6f 65 73 20 6e   ┆W_ i_ n_ d_ o_ w function does n┆
0x06a0…06c0 6f 74 20 6d 61 70 20 74 68 65 20 77 69 6e 64 6f 77 2e 0a 20 20 20 20 20 4f 74 68 65 72 77 69 73   ┆ot map the window.      Otherwis┆
0x06c0…06e0 65 2c 20 74 68 65 20 77 69 6e 64 6f 77 20 69 73 20 6d 61 70 70 65 64 2c 20 61 6e 64 20 74 68 65   ┆e, the window is mapped, and the┆
0x06e0…0700 20 58 20 73 65 72 76 65 72 20 67 65 6e 65 72 61 74 65 73 0a 20 20 20 20 20 61 20 5f 08 4d 5f 08   ┆ X server generates      a _ M_ ┆
0x0700…0720 61 5f 08 70 5f 08 4e 5f 08 6f 5f 08 74 5f 08 69 5f 08 66 5f 08 79 20 65 76 65 6e 74 2e 0a 0a 20   ┆a_ p_ N_ o_ t_ i_ f_ y event.   ┆
0x0720…0740 20 20 20 20 49 66 20 74 68 65 20 77 69 6e 64 6f 77 20 62 65 63 6f 6d 65 73 20 76 69 65 77 61 62   ┆    If the window becomes viewab┆
0x0740…0760 6c 65 20 61 6e 64 20 6e 6f 20 65 61 72 6c 69 65 72 20 63 6f 6e 74 65 6e 74 73 20 66 6f 72 0a 20   ┆le and no earlier contents for  ┆
0x0760…0780 20 20 20 20 69 74 20 61 72 65 20 72 65 6d 65 6d 62 65 72 65 64 2c 20 74 68 65 20 58 20 73 65 72   ┆    it are remembered, the X ser┆
0x0780…07a0 76 65 72 20 74 69 6c 65 73 20 74 68 65 20 77 69 6e 64 6f 77 20 77 69 74 68 20 69 74 73 0a 20 20   ┆ver tiles the window with its   ┆
0x07a0…07c0 20 20 20 62 61 63 6b 67 72 6f 75 6e 64 2e 20 20 49 66 20 74 68 65 20 77 69 6e 64 6f 77 27 73 20   ┆   background.  If the window's ┆
0x07c0…07e0 62 61 63 6b 67 72 6f 75 6e 64 20 69 73 20 75 6e 64 65 66 69 6e 65 64 2c 20 74 68 65 0a 20 20 20   ┆background is undefined, the    ┆
0x07e0…0800 20 20 65 78 69 73 74 69 6e 67 20 73 63 72 65 65 6e 20 63 6f 6e 74 65 6e 74 73 20 61 72 65 20 6e   ┆  existing screen contents are n┆
0x0800…0820 6f 74 20 61 6c 74 65 72 65 64 2c 20 61 6e 64 20 74 68 65 20 58 20 73 65 72 76 65 72 0a 20 20 20   ┆ot altered, and the X server    ┆
0x0820…0840 20 20 67 65 6e 65 72 61 74 65 73 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 5f 08 45 5f 08 78 5f   ┆  generates zero or more _ E_ x_┆
0x0840…0860 08 70 5f 08 6f 5f 08 73 5f 08 65 20 65 76 65 6e 74 73 2e 20 20 49 66 20 62 61 63 6b 69 6e 67 2d   ┆ p_ o_ s_ e events.  If backing-┆
0x0860…0880 73 74 6f 72 65 20 77 61 73 0a 20 20 20 20 20 6d 61 69 6e 74 61 69 6e 65 64 20 77 68 69 6c 65 20   ┆store was      maintained while ┆
0x0880…08a0 74 68 65 20 77 69 6e 64 6f 77 20 77 61 73 20 75 6e 6d 61 70 70 65 64 2c 20 6e 6f 20 5f 08 45 5f   ┆the window was unmapped, no _ E_┆
0x08a0…08c0 08 78 5f 08 70 5f 08 6f 5f 08 73 5f 08 65 20 65 76 65 6e 74 73 0a 20 20 20 20 20 61 72 65 20 67   ┆ x_ p_ o_ s_ e events      are g┆
0x08c0…08e0 65 6e 65 72 61 74 65 64 2e 20 20 49 66 20 62 61 63 6b 69 6e 67 2d 73 74 6f 72 65 20 77 69 6c 6c   ┆enerated.  If backing-store will┆
0x08e0…0900 20 6e 6f 77 20 62 65 20 6d 61 69 6e 74 61 69 6e 65 64 2c 20 61 0a 20 20 20 20 20 66 75 6c 6c 2d   ┆ now be maintained, a      full-┆
0x0900…0920 77 69 6e 64 6f 77 20 65 78 70 6f 73 75 72 65 20 69 73 20 61 6c 77 61 79 73 20 67 65 6e 65 72 61   ┆window exposure is always genera┆
0x0920…0940 74 65 64 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 20 6f 6e 6c 79 0a 20 20 20 20 20 76 69 73 69 62   ┆ted.  Otherwise, only      visib┆
0x0940…0960 6c 65 20 72 65 67 69 6f 6e 73 20 6d 61 79 20 62 65 20 72 65 70 6f 72 74 65 64 2e 20 20 53 69 6d   ┆le regions may be reported.  Sim┆
0x0960…0980 69 6c 61 72 20 74 69 6c 69 6e 67 20 61 6e 64 20 65 78 70 6f 2d 0a 20 20 20 20 20 73 75 72 65 20   ┆ilar tiling and expo-      sure ┆
0x0980…09a0 74 61 6b 65 20 70 6c 61 63 65 20 66 6f 72 20 61 6e 79 20 6e 65 77 6c 79 20 76 69 65 77 61 62 6c   ┆take place for any newly viewabl┆
0x09a0…09c0 65 20 69 6e 66 65 72 69 6f 72 73 2e 0a 0a 20 20 20 20 20 49 66 20 74 68 65 20 77 69 6e 64 6f 77   ┆e inferiors.       If the window┆
0x09c0…09e0 20 69 73 20 61 6e 20 5f 08 49 5f 08 6e 5f 08 70 5f 08 75 5f 08 74 5f 08 4f 5f 08 75 5f 08 74 5f   ┆ is an _ I_ n_ p_ u_ t_ O_ u_ t_┆
0x09e0…0a00 08 70 5f 08 75 5f 08 74 20 77 69 6e 64 6f 77 2c 20 5f 08 58 5f 08 4d 5f 08 61 5f 08 70 5f 08 57   ┆ p_ u_ t window, _ X_ M_ a_ p_ W┆
0x0a00…0a20 5f 08 69 5f 08 6e 5f 08 64 5f 08 6f 5f 08 77 20 67 65 6e 65 72 61 74 65 73 0a 20 20 20 20 20 5f   ┆_ i_ n_ d_ o_ w generates      _┆
0x0a20…0a40 08 45 5f 08 78 5f 08 70 5f 08 6f 5f 08 73 5f 08 65 20 65 76 65 6e 74 73 20 6f 6e 20 65 61 63 68   ┆ E_ x_ p_ o_ s_ e events on each┆
0x0a40…0a60 20 5f 08 49 5f 08 6e 5f 08 70 5f 08 75 5f 08 74 5f 08 4f 5f 08 75 5f 08 74 5f 08 70 5f 08 75 5f   ┆ _ I_ n_ p_ u_ t_ O_ u_ t_ p_ u_┆
0x0a60…0a80 08 74 20 77 69 6e 64 6f 77 20 74 68 61 74 20 69 74 20 63 61 75 73 65 73 20 74 6f 0a 20 20 20 20   ┆ t window that it causes to     ┆
0x0a80…0aa0 20 62 65 20 64 69 73 70 6c 61 79 65 64 2e 20 20 49 66 20 74 68 65 20 63 6c 69 65 6e 74 20 6d 61   ┆ be displayed.  If the client ma┆
0x0aa0…0ac0 70 73 20 61 6e 64 20 70 61 69 6e 74 73 20 74 68 65 20 77 69 6e 64 6f 77 20 61 6e 64 0a 20 20 20   ┆ps and paints the window and    ┆
0x0ac0…0ae0 20 20 69 66 20 74 68 65 20 63 6c 69 65 6e 74 20 62 65 67 69 6e 73 20 70 72 6f 63 65 73 73 69 6e   ┆  if the client begins processin┆
0x0ae0…0b00 67 20 65 76 65 6e 74 73 2c 20 74 68 65 20 77 69 6e 64 6f 77 20 69 73 0a 20 20 20 20 20 70 61 69   ┆g events, the window is      pai┆
0x0b00…0b20 6e 74 65 64 20 74 77 69 63 65 2e 20 20 54 6f 20 61 76 6f 69 64 20 74 68 69 73 2c 20 66 69 72 73   ┆nted twice.  To avoid this, firs┆
0x0b20…0b40 74 20 61 73 6b 20 66 6f 72 20 5f 08 45 5f 08 78 5f 08 70 5f 08 6f 5f 08 73 5f 08 65 20 65 76 65   ┆t ask for _ E_ x_ p_ o_ s_ e eve┆
0x0b40…0b60 6e 74 73 0a 20 20 20 20 20 61 6e 64 20 74 68 65 6e 20 6d 61 70 20 74 68 65 20 77 69 6e 64 6f 77   ┆nts      and then map the window┆
0x0b60…0b80 2c 20 73 6f 20 74 68 65 20 63 6c 69 65 6e 74 20 70 72 6f 63 65 73 73 65 73 20 69 6e 70 75 74 0a   ┆, so the client processes input ┆
0x0b80…0ba0 20 20 20 20 20 65 76 65 6e 74 73 20 61 73 20 75 73 75 61 6c 2e 20 20 54 68 65 20 65 76 65 6e 74   ┆     events as usual.  The event┆
0x0ba0…0bc0 20 6c 69 73 74 20 77 69 6c 6c 20 69 6e 63 6c 75 64 65 20 5f 08 45 5f 08 78 5f 08 70 5f 08 6f 5f   ┆ list will include _ E_ x_ p_ o_┆
0x0bc0…0be0 08 73 5f 08 65 20 66 6f 72 0a 20 20 20 20 20 65 61 63 68 20 77 69 6e 64 6f 77 20 74 68 61 74 20   ┆ s_ e for      each window that ┆
0x0be0…0c00 68 61 73 20 61 70 70 65 61 72 65 64 20 6f 6e 20 74 68 65 20 73 63 72 65 65 6e 2e 20 54 68 65 20   ┆has appeared on the screen. The ┆
0x0c00…0c20 63 6c 69 65 6e 74 27 73 0a 20 20 20 20 20 6e 6f 72 6d 61 6c 20 72 65 73 70 6f 6e 73 65 20 74 6f   ┆client's      normal response to┆
0x0c20…0c40 20 61 6e 20 5f 08 45 5f 08 78 5f 08 70 5f 08 6f 5f 08 73 5f 08 65 20 65 76 65 6e 74 20 73 68 6f   ┆ an _ E_ x_ p_ o_ s_ e event sho┆
0x0c40…0c60 75 6c 64 20 62 65 20 74 6f 20 72 65 70 61 69 6e 74 20 74 68 65 0a 0a 0a 0a 0a 0a 0a 20 20 20 20   ┆uld be to repaint the           ┆
0x0c60…0c80 20 77 69 6e 64 6f 77 2e 20 20 54 68 69 73 20 6d 65 74 68 6f 64 20 75 73 75 61 6c 6c 79 20 6c 65   ┆ window.  This method usually le┆
0x0c80…0ca0 61 64 73 20 74 6f 20 73 69 6d 70 6c 65 72 20 70 72 6f 67 72 61 6d 73 20 61 6e 64 0a 20 20 20 20   ┆ads to simpler programs and     ┆
0x0ca0…0cc0 20 74 6f 20 70 72 6f 70 65 72 20 69 6e 74 65 72 61 63 74 69 6f 6e 20 77 69 74 68 20 77 69 6e 64   ┆ to proper interaction with wind┆
0x0cc0…0ce0 6f 77 20 6d 61 6e 61 67 65 72 73 2e 0a 0a 20 20 20 20 20 5f 08 58 5f 08 4d 5f 08 61 5f 08 70 5f   ┆ow managers.       _ X_ M_ a_ p_┆
0x0ce0…0d00 08 57 5f 08 69 5f 08 6e 5f 08 64 5f 08 6f 5f 08 77 20 63 61 6e 20 67 65 6e 65 72 61 74 65 20 61   ┆ W_ i_ n_ d_ o_ w can generate a┆
0x0d00…0d20 20 5f 08 42 5f 08 61 5f 08 64 5f 08 57 5f 08 69 5f 08 6e 5f 08 64 5f 08 6f 5f 08 77 20 65 72 72   ┆ _ B_ a_ d_ W_ i_ n_ d_ o_ w err┆
0x0d20…0d40 6f 72 2e 0a 0a 20 20 20 20 20 54 68 65 20 5f 08 58 5f 08 4d 5f 08 61 5f 08 70 5f 08 52 5f 08 61   ┆or.       The _ X_ M_ a_ p_ R_ a┆
0x0d40…0d60 5f 08 69 5f 08 73 5f 08 65 5f 08 64 20 66 75 6e 63 74 69 6f 6e 20 65 73 73 65 6e 74 69 61 6c 6c   ┆_ i_ s_ e_ d function essentiall┆
0x0d60…0d80 79 20 69 73 20 73 69 6d 69 6c 61 72 20 74 6f 20 5f 08 58 5f 08 4d 5f 08 61 5f 08 70 5f 08 57 5f   ┆y is similar to _ X_ M_ a_ p_ W_┆
0x0d80…0da0 08 69 5f 08 6e 5f 08 64 5f 08 6f 5f 08 77 0a 20 20 20 20 20 69 6e 20 74 68 61 74 20 69 74 20 6d   ┆ i_ n_ d_ o_ w      in that it m┆
0x0da0…0dc0 61 70 73 20 74 68 65 20 77 69 6e 64 6f 77 20 61 6e 64 20 61 6c 6c 20 6f 66 20 69 74 73 20 73 75   ┆aps the window and all of its su┆
0x0dc0…0de0 62 77 69 6e 64 6f 77 73 20 74 68 61 74 0a 20 20 20 20 20 68 61 76 65 20 68 61 64 20 6d 61 70 20   ┆bwindows that      have had map ┆
0x0de0…0e00 72 65 71 75 65 73 74 73 2e 20 20 48 6f 77 65 76 65 72 2c 20 69 74 20 61 6c 73 6f 20 72 61 69 73   ┆requests.  However, it also rais┆
0x0e00…0e20 65 73 20 74 68 65 20 73 70 65 63 69 2d 0a 20 20 20 20 20 66 69 65 64 20 77 69 6e 64 6f 77 20 74   ┆es the speci-      fied window t┆
0x0e20…0e40 6f 20 74 68 65 20 74 6f 70 20 6f 66 20 74 68 65 20 73 74 61 63 6b 2e 0a 0a 20 20 20 20 20 5f 08   ┆o the top of the stack.       _ ┆
0x0e40…0e60 58 5f 08 4d 5f 08 61 5f 08 70 5f 08 52 5f 08 61 5f 08 69 5f 08 73 5f 08 65 5f 08 64 20 63 61 6e   ┆X_ M_ a_ p_ R_ a_ i_ s_ e_ d can┆
0x0e60…0e80 20 67 65 6e 65 72 61 74 65 20 61 20 5f 08 42 5f 08 61 5f 08 64 5f 08 57 5f 08 69 5f 08 6e 5f 08   ┆ generate a _ B_ a_ d_ W_ i_ n_ ┆
0x0e80…0ea0 64 5f 08 6f 5f 08 77 20 65 72 72 6f 72 2e 0a 0a 20 20 20 20 20 54 68 65 20 5f 08 58 5f 08 4d 5f   ┆d_ o_ w error.       The _ X_ M_┆
0x0ea0…0ec0 08 61 5f 08 70 5f 08 53 5f 08 75 5f 08 62 5f 08 77 5f 08 69 5f 08 6e 5f 08 64 5f 08 6f 5f 08 77   ┆ a_ p_ S_ u_ b_ w_ i_ n_ d_ o_ w┆
0x0ec0…0ee0 5f 08 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 70 73 20 61 6c 6c 20 73 75 62 77 69 6e 64 6f 77 73   ┆_ s function maps all subwindows┆
0x0ee0…0f00 20 66 6f 72 20 61 20 73 70 65 63 69 2d 0a 20 20 20 20 20 66 69 65 64 20 77 69 6e 64 6f 77 20 69   ┆ for a speci-      fied window i┆
0x0f00…0f20 6e 20 74 6f 70 2d 74 6f 2d 62 6f 74 74 6f 6d 20 73 74 61 63 6b 69 6e 67 20 6f 72 64 65 72 2e 20   ┆n top-to-bottom stacking order. ┆
0x0f20…0f40 20 54 68 65 20 58 20 73 65 72 76 65 72 0a 20 20 20 20 20 67 65 6e 65 72 61 74 65 73 20 5f 08 45   ┆ The X server      generates _ E┆
0x0f40…0f60 5f 08 78 5f 08 70 5f 08 6f 5f 08 73 5f 08 65 20 65 76 65 6e 74 73 20 6f 6e 20 65 61 63 68 20 6e   ┆_ x_ p_ o_ s_ e events on each n┆
0x0f60…0f80 65 77 6c 79 20 64 69 73 70 6c 61 79 65 64 20 77 69 6e 64 6f 77 2e 0a 20 20 20 20 20 54 68 69 73   ┆ewly displayed window.      This┆
0x0f80…0fa0 20 6d 61 79 20 62 65 20 6d 75 63 68 20 6d 6f 72 65 20 65 66 66 69 63 69 65 6e 74 20 74 68 61 6e   ┆ may be much more efficient than┆
0x0fa0…0fc0 20 6d 61 70 70 69 6e 67 20 6d 61 6e 79 20 77 69 6e 64 6f 77 73 0a 20 20 20 20 20 6f 6e 65 20 61   ┆ mapping many windows      one a┆
0x0fc0…0fe0 74 20 61 20 74 69 6d 65 20 62 65 63 61 75 73 65 20 74 68 65 20 73 65 72 76 65 72 20 6e 65 65 64   ┆t a time because the server need┆
0x0fe0…1000 73 20 74 6f 20 70 65 72 66 6f 72 6d 20 6d 75 63 68 20 6f 66 0a 20 20 20 20 20 74 68 65 20 77 6f   ┆s to perform much of      the wo┆
0x1000…1020 72 6b 20 6f 6e 6c 79 20 6f 6e 63 65 2c 20 66 6f 72 20 61 6c 6c 20 6f 66 20 74 68 65 20 77 69 6e   ┆rk only once, for all of the win┆
0x1020…1040 64 6f 77 73 2c 20 72 61 74 68 65 72 20 74 68 61 6e 20 66 6f 72 0a 20 20 20 20 20 65 61 63 68 20   ┆dows, rather than for      each ┆
0x1040…1060 77 69 6e 64 6f 77 2e 0a 0a 20 20 20 20 20 5f 08 58 5f 08 4d 5f 08 61 5f 08 70 5f 08 53 5f 08 75   ┆window.       _ X_ M_ a_ p_ S_ u┆
0x1060…1080 5f 08 62 5f 08 77 5f 08 69 5f 08 6e 5f 08 64 5f 08 6f 5f 08 77 5f 08 73 20 63 61 6e 20 67 65 6e   ┆_ b_ w_ i_ n_ d_ o_ w_ s can gen┆
0x1080…10a0 65 72 61 74 65 20 61 20 5f 08 42 5f 08 61 5f 08 64 5f 08 57 5f 08 69 5f 08 6e 5f 08 64 5f 08 6f   ┆erate a _ B_ a_ d_ W_ i_ n_ d_ o┆
0x10a0…10c0 5f 08 77 20 65 72 72 6f 72 2e 0a 0a 44 08 44 08 44 08 44 49 08 49 08 49 08 49 41 08 41 08 41 08   ┆_ w error.  D D D DI I I IA A A ┆
0x10c0…10e0 41 47 08 47 08 47 08 47 4e 08 4e 08 4e 08 4e 4f 08 4f 08 4f 08 4f 53 08 53 08 53 08 53 54 08 54   ┆AG G G GN N N NO O O OS S S ST T┆
0x10e0…1100 08 54 08 54 49 08 49 08 49 08 49 43 08 43 08 43 08 43 53 08 53 08 53 08 53 0a 20 20 20 20 20 5f   ┆ T TI I I IC C C CS S S S      _┆
0x1100…1120 08 42 5f 08 61 5f 08 64 5f 08 57 5f 08 69 5f 08 6e 5f 08 64 5f 08 6f 5f 08 77 20 41 20 76 61 6c   ┆ B_ a_ d_ W_ i_ n_ d_ o_ w A val┆
0x1120…1140 75 65 20 66 6f 72 20 61 20 57 69 6e 64 6f 77 20 61 72 67 75 6d 65 6e 74 20 64 6f 65 73 20 6e 6f   ┆ue for a Window argument does no┆
0x1140…1160 74 20 6e 61 6d 65 20 61 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 65 66 69 6e 65 64 20   ┆t name a                defined ┆
0x1160…1180 57 69 6e 64 6f 77 2e 0a 0a 53 08 53 08 53 08 53 45 08 45 08 45 08 45 45 08 45 08 45 08 45 20 41   ┆Window.  S S S SE E E EE E E E A┆
0x1180…11a0 08 41 08 41 08 41 4c 08 4c 08 4c 08 4c 53 08 53 08 53 08 53 4f 08 4f 08 4f 08 4f 0a 20 20 20 20   ┆ A A AL L L LS S S SO O O O     ┆
0x11a0…11c0 20 58 43 68 61 6e 67 65 57 69 6e 64 6f 77 41 74 74 72 69 62 75 74 65 73 28 33 58 31 31 29 2c 20   ┆ XChangeWindowAttributes(3X11), ┆
0x11c0…11e0 58 43 6f 6e 66 69 67 75 72 65 57 69 6e 64 6f 77 28 33 58 31 31 29 2c 0a 20 20 20 20 20 58 43 72   ┆XConfigureWindow(3X11),      XCr┆
0x11e0…1200 65 61 74 65 57 69 6e 64 6f 77 28 33 58 31 31 29 2c 20 58 44 65 73 74 72 6f 79 57 69 6e 64 6f 77   ┆eateWindow(3X11), XDestroyWindow┆
0x1200…1220 28 33 58 31 31 29 2c 0a 20 20 20 20 20 58 52 61 69 73 65 57 69 6e 64 6f 77 28 33 58 31 31 29 2c   ┆(3X11),      XRaiseWindow(3X11),┆
0x1220…1240 20 58 55 6e 6d 61 70 57 69 6e 64 6f 77 28 33 58 31 31 29 0a 20 20 20 20 20 5f 08 58 5f 08 6c 5f   ┆ XUnmapWindow(3X11)      _ X_ l_┆
0x1240…1260 08 69 5f 08 62 20 2d 20 5f 08 43 20 5f 08 4c 5f 08 61 5f 08 6e 5f 08 67 5f 08 75 5f 08 61 5f 08   ┆ i_ b - _ C _ L_ a_ n_ g_ u_ a_ ┆
0x1260…1280 67 5f 08 65 20 5f 08 58 20 5f 08 49 5f 08 6e 5f 08 74 5f 08 65 5f 08 72 5f 08 66 5f 08 61 5f 08   ┆g_ e _ X _ I_ n_ t_ e_ r_ f_ a_ ┆
0x1280…12a0 63 5f 08 65 0a 0a 41 75 67 75 73 74 20 31 39 39 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆c_ e  August 1991               ┆
0x12a0…12c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 58 20 50 72 6f 67 72 61 6d 6d 65 72 27 73 20 52 65   ┆              TX Programmer's Re┆
0x12c0…12e0 66 65 72 65 6e 63 65 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a   ┆ference                         ┆
0x12e0…12e3 0a 0a 0a                                                                                          ┆   ┆