home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat1 / xwininfo.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  7.1 KB  |  265 lines
  1.  
  2.  
  3.  
  4. XWININFO(1)                          XWININFO(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        xwininfo - window information utility for X
  9.  
  10. SSYYNNOOPPSSIISS
  11.        xxwwiinniinnffoo     [-help]  [-id    _i_d]  [-root]  [-name _n_a_m_e] [-int]
  12.        [-children] [-tree]  [-stats]  [-bits]  [-events]  [-size]
  13.        [-wm] [-shape] [-frame] [-all] [-english] [-metric] [-dis-
  14.        play _d_i_s_p_l_a_y]
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.        _X_w_i_n_i_n_f_o is a utility  for  displaying  information  about
  18.        windows.      Various  information    is displayed depending on
  19.        which options are selected.  If    no  options  are  chosen,
  20.        --ssttaattss is assumed.
  21.  
  22.        The  user  has  the  option of selecting the target window
  23.        with the mouse  (by  clicking  any  mouse  button  in  the
  24.        desired window) or by specifying its window id on the com-
  25.        mand line with the --iidd option.  Or instead  of  specifying
  26.        the  window by its id number, the --nnaammee option may be used
  27.        to specify which window is desired by name.  There is also
  28.        a  special  --rroooott  option to quickly obtain information on
  29.        the screen's root window.
  30.  
  31. OOPPTTIIOONNSS
  32.        --hheellpp   Print out the `Usage:' command syntax summary.
  33.  
  34.  
  35.        --iidd _i_d  This option allows the user to  specify    a  target
  36.            window  _i_d  on  the command line rather than using
  37.            the mouse to select the target  window.     This  is
  38.            very  useful in debugging X applications where the
  39.            target window is not mapped to the screen or where
  40.            the use of the mouse might be impossible or inter-
  41.            fere with the application.
  42.  
  43.  
  44.        --nnaammee _n_a_m_e
  45.            This option allows the user to  specify    that  the
  46.            window named _n_a_m_e is the target window on the com-
  47.            mand line rather than using the    mouse  to  select
  48.            the target window.
  49.  
  50.  
  51.        --rroooott   This  option specifies that X's root window is the
  52.            target window.  This is useful in situations where
  53.            the root window is completely obscured.
  54.  
  55.  
  56.        --iinntt    This option specifies that all X window ids should
  57.            be displayed as integer values.    The default is to
  58.            display them as hexadecimal values.
  59.  
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XWININFO(1)                          XWININFO(1)
  71.  
  72.  
  73.        --cchhiillddrreenn
  74.            This  option causes the root, parent, and children
  75.            windows' ids and names of the selected  window  to
  76.            be displayed.
  77.  
  78.  
  79.        --ttrreeee   This  option  is     like  --cchhiillddrreenn but displays all
  80.            children recursively.
  81.  
  82.  
  83.        --ssttaattss  This  option  causes  the   display   of      various
  84.            attributes  pertaining to the location and appear-
  85.            ance of the  selected  window.    Information  dis-
  86.            played  includes     the  location of the window, its
  87.            width and height, its depth, border width,  class,
  88.            colormap id if any, map state, backing-store hint,
  89.            and location of the corners.
  90.  
  91.  
  92.        --bbiittss   This  option  causes  the   display   of      various
  93.            attributes pertaining to the selected window's raw
  94.            bits and how the selected window is to be  stored.
  95.            Displayed  information  includes the selected win-
  96.            dow's bit gravity, window  gravity,  backing-store
  97.            hint,  backing-planes  value,  backing  pixel, and
  98.            whether or not the window has save-under set.
  99.  
  100.  
  101.        --eevveennttss This option causes  the    selected  window's  event
  102.            masks  to  be  displayed.   Both the event mask of
  103.            events wanted by some client and the event mask of
  104.            events not to propagate are displayed.
  105.  
  106.  
  107.        --ssiizzee   This  option  causes  the selected window's sizing
  108.            hints  to  be  displayed.   Displayed  information
  109.            includes:  for  both the normal size hints and the
  110.            zoom size hints, the  user  supplied  location  if
  111.            any;  the  program  supplied  location if any; the
  112.            user supplied size if any;  the    program     supplied
  113.            size  if any; the minimum size if any; the maximum
  114.            size if any; the resize increments if any; and the
  115.            minimum and maximum aspect ratios if any.
  116.  
  117.  
  118.        --wwmm     This  option  causes  the selected window's window
  119.            manager hints to be displayed.    Information  dis-
  120.            played  may include whether or not the application
  121.            accepts input, what the window's icon window # and
  122.            name  is,  where     the window's icon should go, and
  123.            what the window's initial state should be.
  124.  
  125.  
  126.        --sshhaappee  This option causes the  selected     window's  window
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XWININFO(1)                          XWININFO(1)
  137.  
  138.  
  139.            and border shape extents to be displayed.
  140.  
  141.        --ffrraammee  This  option  causes  window  manager frames to be
  142.            considered when manually selecting windows.
  143.  
  144.  
  145.        --mmeettrriicc This option causes all individual  height,  width,
  146.            and  x and y positions to be displayed in millime-
  147.            ters as well as number of pixels,  based     on  what
  148.            the  server  thinks  the     resolution  is. Geometry
  149.            specifications that  are     in  ++xx++yy  form     are  not
  150.            changed.
  151.  
  152.        --eenngglliisshh
  153.            This  option  causes all individual height, width,
  154.            and x and y positions to be  displayed  in  inches
  155.            (and  feet, yards, and miles if necessary) as well
  156.            as number of pixels. --mmeettrriicc and --eenngglliisshh may both
  157.            be enabled at the same time.
  158.  
  159.  
  160.        --aallll    This option is a quick way to ask for all informa-
  161.            tion possible.
  162.  
  163.  
  164.        --ddiissppllaayy _d_i_s_p_l_a_y
  165.            This option allows you to specify  the  server  to
  166.            connect to; see _X_(_1_).
  167.  
  168. EEXXAAMMPPLLEE
  169.        The  following  is  a sample summary taken with no options
  170.        specified:
  171.  
  172.        xwininfo: Window id: 0x60000f "xterm"
  173.  
  174.      Absolute upper-left X: 2
  175.      Absolute upper-left Y: 85
  176.      Relative upper-left X:     0
  177.      Relative upper-left Y:     25
  178.      Width: 579
  179.      Height: 316
  180.      Depth: 8
  181.      Visual Class: PseudoColor
  182.      Border width: 0
  183.      Class: InputOutput
  184.      Colormap: 0x27 (installed)
  185.      Bit Gravity State: NorthWestGravity
  186.      Window Gravity State: NorthWestGravity
  187.      Backing Store State: NotUseful
  188.      Save Under State: no
  189.      Map State: IsViewable
  190.      Override Redirect State: no
  191.      Corners:  +2+85  -699+85  -699-623  +2-623
  192.      -geometry 80x24+0+58
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XWININFO(1)                          XWININFO(1)
  203.  
  204.  
  205. EENNVVIIRROONNMMEENNTT
  206.        DDIISSPPLLAAYY To get the default host and display number.
  207.  
  208. SSEEEE AALLSSOO
  209.        X(1), xprop(1)
  210.  
  211. BBUUGGSS
  212.        Using --ssttaattss --bbiittss shows some redundant information.
  213.  
  214.        The -geometry string displayed must make assumptions about
  215.        the window's border width and the behavior of the applica-
  216.        tion and the window manager.  As a  result,  the     location
  217.        given is not always correct.
  218.  
  219. AAUUTTHHOORR
  220.        Mark Lillibridge, MIT Project Athena
  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. X Version 11           Release 6.1                4
  263.  
  264.  
  265.