DataMuseum.dk

top - download

    Length: 3027 (0xbd3)
    Names: »XSelectInput.3X«

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

Default Hex Dump

0x000…020 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_┆
0x020…040 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┆
0x040…060 69 6f 6e 73 20 20 20 20 20 20 20 20 58 53 65 6c 65 63 74 49 6e 70 75 74 28 33 58 29 0a 0a 0a 0a   ┆ions        XSelectInput(3X)    ┆
0x060…080 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    ┆
0x080…0a0 20 20 58 53 65 6c 65 63 74 49 6e 70 75 74 20 2d 20 73 65 6c 65 63 74 20 69 6e 70 75 74 20 65 76   ┆  XSelectInput - select input ev┆
0x0a0…0c0 65 6e 74 73 0a 0a 53 08 53 08 53 08 53 59 08 59 08 59 08 59 4e 08 4e 08 4e 08 4e 54 08 54 08 54   ┆ents  S S S SY Y Y YN N N NT T T┆
0x0c0…0e0 08 54 41 08 41 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 58 53 65 6c 65 63 74 49 6e 70   ┆ TA A A AX X X X      XSelectInp┆
0x0e0…100 75 74 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 2c 20 5f   ┆ut(_ d_ i_ s_ p_ l_ a_ y, _ w, _┆
0x100…120 08 65 5f 08 76 5f 08 65 5f 08 6e 5f 08 74 5f 5f 08 6d 5f 08 61 5f 08 73 5f 08 6b 29 0a 20 20 20   ┆ e_ v_ e_ n_ t__ m_ a_ s_ k)    ┆
0x120…140 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 6c   ┆        Display *_ d_ i_ s_ p_ l┆
0x140…160 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 20   ┆_ a_ y;            Window _ w;  ┆
0x160…180 20 20 20 20 20 20 20 20 20 20 6c 6f 6e 67 20 5f 08 65 5f 08 76 5f 08 65 5f 08 6e 5f 08 74 5f 5f   ┆          long _ e_ v_ e_ n_ t__┆
0x180…1a0 08 6d 5f 08 61 5f 08 73 5f 08 6b 3b 0a 0a 41 08 41 08 41 08 41 52 08 52 08 52 08 52 47 08 47 08   ┆ m_ a_ s_ k;  A A A AR R R RG G ┆
0x1a0…1c0 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 4e 08 4e 08 4e 54   ┆G GU U U UM M M ME E E EN N N NT┆
0x1c0…1e0 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 08 73 5f 08 70 5f   ┆ T T TS S S S      _ d_ i_ s_ p_┆
0x1e0…200 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 6f 6e 6e 65 63 74   ┆ l_ a_ y   Specifies the connect┆
0x200…220 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 20 5f 08 65 5f 08   ┆ion to the X server.       _ e_ ┆
0x220…240 76 5f 08 65 5f 08 6e 5f 08 74 5f 5f 08 6d 5f 08 61 5f 08 73 5f 08 6b 0a 20 20 20 20 20 20 20 20   ┆v_ e_ n_ t__ m_ a_ s_ k         ┆
0x240…260 20 20 20 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 65 76 65 6e 74 20 6d 61 73 6b 2e   ┆       Specifies the event mask.┆
0x260…280 0a 0a 20 20 20 20 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   ┆       _ w         Specifies the┆
0x280…2a0 20 77 69 6e 64 6f 77 20 77 68 6f 73 65 20 65 76 65 6e 74 73 20 79 6f 75 20 61 72 65 0a 20 20 20   ┆ window whose events you are    ┆
0x2a0…2c0 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 65 72 65 73 74 65 64 20 69 6e 2e 0a 0a 44 08 44 08   ┆            interested in.  D D ┆
0x2c0…2e0 44 08 44 45 08 45 08 45 08 45 53 08 53 08 53 08 53 43 08 43 08 43 08 43 52 08 52 08 52 08 52 49   ┆D DE E E ES S S SC C C CR R R RI┆
0x2e0…300 08 49 08 49 08 49 50 08 50 08 50 08 50 54 08 54 08 54 08 54 49 08 49 08 49 08 49 4f 08 4f 08 4f   ┆ I I IP P P PT T T TI I I IO O O┆
0x300…320 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 54 68 65 20 5f 08 58 5f 08 53 5f 08 65 5f 08 6c 5f   ┆ ON N N N      The _ X_ S_ e_ l_┆
0x320…340 08 65 5f 08 63 5f 08 74 5f 08 49 5f 08 6e 5f 08 70 5f 08 75 5f 08 74 20 66 75 6e 63 74 69 6f 6e   ┆ e_ c_ t_ I_ n_ p_ u_ t function┆
0x340…360 20 72 65 71 75 65 73 74 73 20 74 68 61 74 20 74 68 65 20 58 20 73 65 72 76 65 72 20 72 65 70 6f   ┆ requests that the X server repo┆
0x360…380 72 74 0a 20 20 20 20 20 74 68 65 20 65 76 65 6e 74 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69   ┆rt      the events associated wi┆
0x380…3a0 74 68 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 65 76 65 6e 74 20 6d 61 73 6b 2e 20 20 49 6e   ┆th the specified event mask.  In┆
0x3a0…3c0 69 2d 0a 20 20 20 20 20 74 69 61 6c 6c 79 2c 20 58 20 77 69 6c 6c 20 6e 6f 74 20 72 65 70 6f 72   ┆i-      tially, X will not repor┆
0x3c0…3e0 74 20 61 6e 79 20 6f 66 20 74 68 65 73 65 20 65 76 65 6e 74 73 2e 20 20 45 76 65 6e 74 73 20 61   ┆t any of these events.  Events a┆
0x3e0…400 72 65 0a 20 20 20 20 20 72 65 70 6f 72 74 65 64 20 72 65 6c 61 74 69 76 65 20 74 6f 20 61 20 77   ┆re      reported relative to a w┆
0x400…420 69 6e 64 6f 77 2e 20 20 49 66 20 61 20 77 69 6e 64 6f 77 20 69 73 20 6e 6f 74 0a 20 20 20 20 20   ┆indow.  If a window is not      ┆
0x420…440 69 6e 74 65 72 65 73 74 65 64 20 69 6e 20 61 20 64 65 76 69 63 65 20 65 76 65 6e 74 2c 20 69 74   ┆interested in a device event, it┆
0x440…460 20 75 73 75 61 6c 6c 79 20 70 72 6f 70 61 67 61 74 65 73 20 74 6f 20 74 68 65 0a 20 20 20 20 20   ┆ usually propagates to the      ┆
0x460…480 63 6c 6f 73 65 73 74 20 61 6e 63 65 73 74 6f 72 20 74 68 61 74 20 69 73 20 69 6e 74 65 72 65 73   ┆closest ancestor that is interes┆
0x480…4a0 74 65 64 2c 20 75 6e 6c 65 73 73 20 74 68 65 0a 20 20 20 20 20 64 6f 5f 6e 6f 74 5f 70 72 6f 70   ┆ted, unless the      do_not_prop┆
0x4a0…4c0 61 67 61 74 65 20 6d 61 73 6b 20 70 72 6f 68 69 62 69 74 73 20 69 74 2e 0a 0a 20 20 20 20 20 53   ┆agate mask prohibits it.       S┆
0x4c0…4e0 65 74 74 69 6e 67 20 74 68 65 20 65 76 65 6e 74 2d 6d 61 73 6b 20 61 74 74 72 69 62 75 74 65 20   ┆etting the event-mask attribute ┆
0x4e0…500 6f 66 20 61 20 77 69 6e 64 6f 77 20 6f 76 65 72 72 69 64 65 73 20 61 6e 79 0a 20 20 20 20 20 70   ┆of a window overrides any      p┆
0x500…520 72 65 76 69 6f 75 73 20 63 61 6c 6c 20 66 6f 72 20 74 68 65 20 73 61 6d 65 20 77 69 6e 64 6f 77   ┆revious call for the same window┆
0x520…540 20 62 75 74 20 6e 6f 74 20 66 6f 72 20 6f 74 68 65 72 20 63 6c 69 65 6e 74 73 2e 0a 20 20 20 20   ┆ but not for other clients.     ┆
0x540…560 20 4d 75 6c 74 69 70 6c 65 20 63 6c 69 65 6e 74 73 20 63 61 6e 20 73 65 6c 65 63 74 20 66 6f 72   ┆ Multiple clients can select for┆
0x560…580 20 74 68 65 20 73 61 6d 65 20 65 76 65 6e 74 73 20 6f 6e 20 74 68 65 20 73 61 6d 65 0a 20 20 20   ┆ the same events on the same    ┆
0x580…5a0 20 20 77 69 6e 64 6f 77 20 77 69 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 65 73 74   ┆  window with the following rest┆
0x5a0…5c0 72 69 63 74 69 6f 6e 73 3a 0a 0a 20 20 20 20 20 6f 08 2b 20 20 20 20 4d 75 6c 74 69 70 6c 65 20   ┆rictions:       o +    Multiple ┆
0x5c0…5e0 63 6c 69 65 6e 74 73 20 63 61 6e 20 73 65 6c 65 63 74 20 65 76 65 6e 74 73 20 6f 6e 20 74 68 65   ┆clients can select events on the┆
0x5e0…600 20 73 61 6d 65 20 77 69 6e 64 6f 77 0a 20 20 20 20 20 20 20 20 20 20 62 65 63 61 75 73 65 20 74   ┆ same window           because t┆
0x600…620 68 65 69 72 20 65 76 65 6e 74 20 6d 61 73 6b 73 20 61 72 65 20 64 69 73 6a 6f 69 6e 74 2e 20 20   ┆heir event masks are disjoint.  ┆
0x620…640 57 68 65 6e 20 74 68 65 20 58 0a 20 20 20 20 20 20 20 20 20 20 73 65 72 76 65 72 20 67 65 6e 65   ┆When the X           server gene┆
0x640…660 72 61 74 65 73 20 61 6e 20 65 76 65 6e 74 2c 20 69 74 20 72 65 70 6f 72 74 73 20 69 74 20 74 6f   ┆rates an event, it reports it to┆
0x660…680 20 61 6c 6c 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 65 72 65 73 74 65 64 20 63 6c 69 65 6e 74   ┆ all           interested client┆
0x680…6a0 73 2e 0a 0a 20 20 20 20 20 6f 08 2b 20 20 20 20 4f 6e 6c 79 20 6f 6e 65 20 63 6c 69 65 6e 74 20   ┆s.       o +    Only one client ┆
0x6a0…6c0 61 74 20 61 20 74 69 6d 65 20 63 61 6e 20 73 65 6c 65 63 74 20 5f 08 43 5f 08 69 5f 08 72 5f 08   ┆at a time can select _ C_ i_ r_ ┆
0x6c0…6e0 63 5f 08 75 5f 08 6c 5f 08 61 5f 08 74 5f 08 65 5f 08 52 5f 08 65 5f 08 71 5f 08 75 5f 08 65 5f   ┆c_ u_ l_ a_ t_ e_ R_ e_ q_ u_ e_┆
0x6e0…700 08 73 5f 08 74 2c 0a 20 20 20 20 20 20 20 20 20 20 5f 08 43 5f 08 6f 5f 08 6e 5f 08 66 5f 08 69   ┆ s_ t,           _ C_ o_ n_ f_ i┆
0x700…720 5f 08 67 5f 08 75 5f 08 72 5f 08 65 5f 08 52 5f 08 65 5f 08 71 5f 08 75 5f 08 65 5f 08 73 5f 08   ┆_ g_ u_ r_ e_ R_ e_ q_ u_ e_ s_ ┆
0x720…740 74 2c 20 6f 72 20 5f 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   ┆t, or _ M_ a_ p_ R_ e_ q_ u_ e_ ┆
0x740…760 73 5f 08 74 20 65 76 65 6e 74 73 2c 20 77 68 69 63 68 20 61 72 65 20 61 73 73 6f 2d 0a 20 20 20   ┆s_ t events, which are asso-    ┆
0x760…780 20 20 20 20 20 20 20 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20 65 76 65 6e 74 20 6d 61 73   ┆       ciated with the event mas┆
0x780…7a0 6b 20 5f 08 53 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   ┆k _ S_ u_ b_ s_ t_ r_ u_ c_ t_ u┆
0x7a0…7c0 5f 08 72 5f 08 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   ┆_ r_ e_ R_ e_ d_ i_ r_ e_ c_ t_ ┆
0x7c0…7e0 4d 5f 08 61 5f 08 73 5f 08 6b 2e 0a 0a 20 20 20 20 20 6f 08 2b 20 20 20 20 4f 6e 6c 79 20 6f 6e   ┆M_ a_ s_ k.       o +    Only on┆
0x7e0…800 65 20 63 6c 69 65 6e 74 20 61 74 20 61 20 74 69 6d 65 20 63 61 6e 20 73 65 6c 65 63 74 20 61 20   ┆e client at a time can select a ┆
0x800…820 5f 08 52 5f 08 65 5f 08 73 5f 08 69 5f 08 7a 5f 08 65 5f 08 52 5f 08 65 5f 08 71 5f 08 75 5f 08   ┆_ R_ e_ s_ i_ z_ e_ R_ e_ q_ u_ ┆
0x820…840 65 5f 08 73 5f 08 74 0a 20 20 20 20 20 20 20 20 20 20 65 76 65 6e 74 2c 20 77 68 69 63 68 20 69   ┆e_ s_ t           event, which i┆
0x840…860 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20 65 76 65 6e 74 20 6d 61 73 6b   ┆s associated with the event mask┆
0x860…880 20 5f 08 52 5f 08 65 5f 08 73 5f 08 69 5f 08 7a 5f 08 2d 0a 20 20 20 20 20 20 20 20 20 20 5f 08   ┆ _ R_ e_ s_ i_ z_ -           _ ┆
0x880…8a0 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_┆
0x8a0…8c0 08 73 5f 08 6b 2e 0a 0a 20 20 20 20 20 6f 08 2b 20 20 20 20 4f 6e 6c 79 20 6f 6e 65 20 63 6c 69   ┆ s_ k.       o +    Only one cli┆
0x8c0…8e0 65 6e 74 20 61 74 20 61 20 74 69 6d 65 20 63 61 6e 20 73 65 6c 65 63 74 20 61 20 5f 08 42 5f 08   ┆ent at a time can select a _ B_ ┆
0x8e0…900 75 5f 08 74 5f 08 74 5f 08 6f 5f 08 6e 5f 08 50 5f 08 72 5f 08 65 5f 08 73 5f 08 73 0a 20 20 20   ┆u_ t_ t_ o_ n_ P_ r_ e_ s_ s    ┆
0x900…920 20 20 20 20 20 20 20 65 76 65 6e 74 2c 20 77 68 69 63 68 20 69 73 20 61 73 73 6f 63 69 61 74 65   ┆       event, which is associate┆
0x920…940 64 20 77 69 74 68 20 74 68 65 20 65 76 65 6e 74 20 6d 61 73 6b 20 5f 08 42 5f 08 75 5f 08 74 5f   ┆d with the event mask _ B_ u_ t_┆
0x940…960 08 2d 0a 20 20 20 20 20 20 20 20 20 20 5f 08 74 5f 08 6f 5f 08 6e 5f 08 50 5f 08 72 5f 08 65 5f   ┆ -           _ t_ o_ n_ P_ r_ e_┆
0x960…980 08 73 5f 08 73 5f 08 4d 5f 08 61 5f 08 73 5f 08 6b 2e 0a 0a 20 20 20 20 20 54 68 65 20 73 65 72   ┆ s_ s_ M_ a_ s_ k.       The ser┆
0x980…9a0 76 65 72 20 72 65 70 6f 72 74 73 20 74 68 65 20 65 76 65 6e 74 20 74 6f 20 61 6c 6c 20 69 6e 74   ┆ver reports the event to all int┆
0x9a0…9c0 65 72 65 73 74 65 64 20 63 6c 69 65 6e 74 73 2e 0a 0a 20 20 20 20 20 5f 08 58 5f 08 53 5f 08 65   ┆erested clients.       _ X_ S_ e┆
0x9c0…9e0 5f 08 6c 5f 08 65 5f 08 63 5f 08 74 5f 08 49 5f 08 6e 5f 08 70 5f 08 75 5f 08 74 20 63 61 6e 20   ┆_ l_ e_ c_ t_ I_ n_ p_ u_ t can ┆
0x9e0…a00 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 64   ┆generate a _ B_ a_ d_ W_ i_ n_ d┆
0xa00…a20 5f 08 6f 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   ┆_ o_ w error.  D D D DI I I IA A┆
0xa20…a40 08 41 08 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   ┆ A AG G G GN N N NO O O OS S S S┆
0xa40…a60 54 08 54 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   ┆T T T TI I I IC C C CS S S S    ┆
0xa60…a80 20 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 41 20   ┆  _ B_ a_ d_ W_ i_ n_ d_ o_ w A ┆
0xa80…aa0 76 61 6c 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   ┆value for a Window argument does┆
0xaa0…ac0 20 6e 6f 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   ┆ not name a                defin┆
0xac0…ae0 65 64 20 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   ┆ed Window.  S S S SE E E EE E E ┆
0xae0…b00 45 20 41 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   ┆E A A A AL L L LS S S SO O O O  ┆
0xb00…b20 20 20 20 20 5f 08 58 5f 08 6c 5f 08 69 5f 08 62 20 2d 20 5f 08 43 20 5f 08 4c 5f 08 61 5f 08 6e   ┆    _ X_ l_ i_ b - _ C _ L_ a_ n┆
0xb20…b40 5f 08 67 5f 08 75 5f 08 61 5f 08 67 5f 08 65 20 5f 08 58 20 5f 08 49 5f 08 6e 5f 08 74 5f 08 65   ┆_ g_ u_ a_ g_ e _ X _ I_ n_ t_ e┆
0xb40…b60 5f 08 72 5f 08 66 5f 08 61 5f 08 63 5f 08 65 0a 0a 0a 0a 0a 0a 0a 41 75 67 75 73 74 20 31 39 39   ┆_ r_ f_ a_ c_ e       August 199┆
0xb60…b80 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 58   ┆1                             TX┆
0xb80…ba0 20 50 72 6f 67 72 61 6d 6d 65 72 27 73 20 52 65 66 65 72 65 6e 63 65 0a 0a 0a 0a 0a 0a 0a 0a 0a   ┆ Programmer's Reference         ┆
0xba0…bc0 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 0a 0a 0a 0a 0a 0a 0a   ┆                                ┆
0xbc0…bd3 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a                                          ┆                   ┆