home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.3 / ConfigWind.3 < prev    next >
Encoding:
Text File  |  1995-07-26  |  18.5 KB  |  331 lines

  1.  
  2.  
  3.  
  4.      TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333))))       TTTTkkkk ((((3333....3333))))        TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           Tk_ConfigureWindow, Tk_MoveWindow, Tk_ResizeWindow,
  12.           Tk_MoveResizeWindow, Tk_SetWindowBorderWidth
  13.           Tk_ChangeWindowAttributes, Tk_SetWindowBackground,
  14.           Tk_SetWindowBackgroundPixmap, Tk_SetWindowBorder,
  15.           Tk_SetWindowBorderPixmap, Tk_SetWindowColormap,
  16.           Tk_DefineCursor, Tk_UndefineCursor - change window
  17.           configuration or attributes
  18.  
  19.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  20.           ####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
  21.  
  22.           TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww(_t_k_w_i_n, _v_a_l_u_e_M_a_s_k, _v_a_l_u_e_P_t_r)
  23.  
  24.           TTTTkkkk____MMMMoooovvvveeeeWWWWiiiinnnnddddoooowwww(_t_k_w_i_n, _x, _y)
  25.  
  26.           TTTTkkkk____RRRReeeessssiiiizzzzeeeeWWWWiiiinnnnddddoooowwww(_t_k_w_i_n, _w_i_d_t_h, _h_e_i_g_h_t)
  27.  
  28.           TTTTkkkk____MMMMoooovvvveeeeRRRReeeessssiiiizzzzeeeeWWWWiiiinnnnddddoooowwww(_t_k_w_i_n, _x,  _y, _w_i_d_t_h, _h_e_i_g_h_t)
  29.  
  30.           TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwBBBBoooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh(_t_k_w_i_n, _b_o_r_d_e_r_W_i_d_t_h)
  31.  
  32.           TTTTkkkk____CCCChhhhaaaannnnggggeeeeWWWWiiiinnnnddddoooowwwwAAAAttttttttrrrriiiibbbbuuuutttteeeessss(_t_k_w_i_n, _v_a_l_u_e_M_a_s_k, _a_t_t_s_P_t_r)
  33.  
  34.           TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwBBBBaaaacccckkkkggggrrrroooouuuunnnndddd(_t_k_w_i_n, _p_i_x_e_l)
  35.  
  36.           TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwBBBBaaaacccckkkkggggrrrroooouuuunnnnddddPPPPiiiixxxxmmmmaaaapppp(_t_k_w_i_n, _p_i_x_m_a_p)
  37.  
  38.           TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwBBBBoooorrrrddddeeeerrrr(_t_k_w_i_n, _p_i_x_e_l)
  39.  
  40.           TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwBBBBoooorrrrddddeeeerrrrPPPPiiiixxxxmmmmaaaapppp(_t_k_w_i_n, _p_i_x_m_a_p)
  41.  
  42.           TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwCCCCoooolllloooorrrrmmmmaaaapppp(_t_k_w_i_n, _c_o_l_o_r_m_a_p)                         |
  43.  
  44.           TTTTkkkk____DDDDeeeeffffiiiinnnneeeeCCCCuuuurrrrssssoooorrrr(_t_k_w_i_n, _c_u_r_s_o_r)                                |
  45.  
  46.           TTTTkkkk____UUUUnnnnddddeeeeffffiiiinnnneeeeCCCCuuuurrrrssssoooorrrr(_t_k_w_i_n)                                      |
  47.  
  48.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  49.           Tk_Window              _t_k_w_i_n         (in)      Token     for
  50.                                                          window.
  51.  
  52.           unsigned int           _v_a_l_u_e_M_a_s_k     (in)      OR-ed mask of
  53.                                                          values   like
  54.                                                          CCCCWWWWXXXX        or
  55.                                                          CCCCWWWWBBBBoooorrrrddddeeeerrrrPPPPiiiixxxxeeeellll,
  56.                                                          indicating
  57.                                                          which  fields
  58.                                                          of  *_v_a_l_u_e_P_t_r
  59.                                                          or   *_a_t_t_s_P_t_r
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333))))       TTTTkkkk ((((3333....3333))))        TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333))))
  71.  
  72.  
  73.  
  74.                                                          to use.
  75.  
  76.           XWindowChanges         *_v_a_l_u_e_P_t_r     (in)      Points  to  a
  77.                                                          structure
  78.                                                          containing
  79.                                                          new    values
  80.                                                          for       the
  81.                                                          configuration
  82.                                                          parameters
  83.                                                          selected   by
  84.                                                          _v_a_l_u_e_M_a_s_k.
  85.                                                          Fields    not
  86.                                                          selected   by
  87.                                                          _v_a_l_u_e_M_a_s_k are
  88.                                                          ignored.
  89.  
  90.           int                    _x             (in)      New        x-
  91.                                                          coordinate
  92.                                                          for   _t_k_w_i_n's
  93.                                                          top      left
  94.                                                          pixel
  95.                                                          (including
  96.                                                          border,    if
  97.                                                          any)   within
  98.                                                          tkwin's
  99.                                                          parent.
  100.  
  101.           int                    _y             (in)      New        y-
  102.                                                          coordinate
  103.                                                          for   _t_k_w_i_n's
  104.                                                          top      left
  105.                                                          pixel
  106.                                                          (including
  107.                                                          border,    if
  108.                                                          any)   within
  109.                                                          tkwin's
  110.                                                          parent.
  111.  
  112.           unsigned int           _w_i_d_t_h         (in)      New width for
  113.                                                          _t_k_w_i_n
  114.                                                          (interior,
  115.                                                          not including
  116.                                                          border).
  117.  
  118.           unsigned int           _h_e_i_g_h_t        (in)      New    height
  119.                                                          for     _t_k_w_i_n
  120.                                                          (interior,
  121.                                                          not including
  122.                                                          border).
  123.  
  124.           unsigned int           _b_o_r_d_e_r_W_i_d_t_h   (in)      New width for
  125.                                                          _t_k_w_i_n's
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/23/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333))))       TTTTkkkk ((((3333....3333))))        TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333))))
  137.  
  138.  
  139.  
  140.                                                          border.
  141.  
  142.           XSetWindowAttributes   *_a_t_t_s_P_t_r      (in)      Points  to  a
  143.                                                          structure
  144.                                                          containing
  145.                                                          new    values
  146.                                                          for       the
  147.                                                          attributes
  148.                                                          given by  the
  149.                                                          _v_a_l_u_e_M_a_s_k
  150.                                                          argument.
  151.                                                          Attributes
  152.                                                          not  selected
  153.                                                          by  _v_a_l_u_e_M_a_s_k
  154.                                                          are ignored.
  155.  
  156.           unsigned long          _p_i_x_e_l         (in)      New
  157.                                                          background or
  158.                                                          border  color
  159.                                                          for window.
  160.  
  161.           Pixmap                 _p_i_x_m_a_p        (in)      New pixmap to
  162.                                                          use       for
  163.                                                          background or
  164.                                                          border     of
  165.                                                          _t_k_w_i_n.
  166.                                                          WARNING:
  167.                                                          cannot
  168.                                                          necessarily
  169.                                                          be    deleted
  170.                                                          immediately,
  171.                                                          as  for  Xlib
  172.                                                          calls.    See
  173.                                                          note below.
  174.  
  175.           Colormap               _c_o_l_o_r_m_a_p      (in)      New  colormap  |
  176.                                                          to   use  for  |
  177.                                                          _t_k_w_i_n.         |
  178.  
  179.           Cursor                 _c_u_r_s_o_r        (in)                          ||
  180.                                                          New cursor to  |
  181.                                                          use       for  |
  182.                                                          _t_k_w_i_n.     If  |
  183.                                                          NNNNoooonnnneeee       is  |
  184.                                                          specified,  |
  185.                                                          then    _t_k_w_i_n  |
  186.                                                          will not have  |
  187.                                                          its       own  |
  188.                                                          cursor;    it  |
  189.                                                          will use  the  |
  190.                                                          cursor of its  |
  191.                                                          parent.
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 7/23/95)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333))))       TTTTkkkk ((((3333....3333))))        TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333))))
  203.  
  204.  
  205.  
  206.      _________________________________________________________________
  207.  
  208.  
  209.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  210.           These procedures are analogous to the X  library  procedures
  211.           with  similar  names, such as XXXXCCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww.  Each one of
  212.           the above procedures calls the corresponding X procedure and
  213.           also  saves  the  configuration  information  in  Tk's local
  214.           structure for the window.  This allows the information to be
  215.           retrieved  quickly  by the application (using macros such as
  216.           TTTTkkkk____XXXX and TTTTkkkk____HHHHeeeeiiiigggghhhhtttt) without having to contact the X  server.
  217.           In  addition,  if  no X window has actually been created for
  218.           _t_k_w_i_n yet, these procedures do not  issue  X  operations  or
  219.           cause   event   handlers  to  be  invoked;   they  save  the
  220.           information in Tk's local structure for  the  window;   when
  221.           the  window  is created later, the saved information will be
  222.           used to configure the window.
  223.  
  224.           See the X library documentation for details  on  what  these
  225.           procedures do and how they use their arguments.
  226.  
  227.           In   the   procedures   TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww,   TTTTkkkk____MMMMoooovvvveeeeWWWWiiiinnnnddddoooowwww,
  228.           TTTTkkkk____RRRReeeessssiiiizzzzeeeeWWWWiiiinnnnddddoooowwww,           TTTTkkkk____MMMMoooovvvveeeeRRRReeeessssiiiizzzzeeeeWWWWiiiinnnnddddoooowwww,          and
  229.           TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwBBBBoooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh, if _t_k_w_i_n is an internal window then
  230.           event  handlers  interested  in configure events are invoked
  231.           immediately, before the procedure returns.  If _t_k_w_i_n isn't a
  232.           top-level  window  then  the  event handlers will be invoked
  233.           later, after X has seen the request and  returned  an  event
  234.           for it.
  235.  
  236.           Applications using Tk  should  never  call  procedures  like
  237.           XXXXCCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww  directly;   they  should  always  use  the
  238.           corresponding Tk procedures.
  239.  
  240.           The size and location of a window should only be modified by  |
  241.           the  appropriate  geometry manager for that window and never  |
  242.           by a window itself (but see TTTTkkkk____MMMMoooovvvveeeeTTTToooopppplllleeeevvvveeeellllWWWWiiiinnnnddddoooowwww for moving  |
  243.           a top-level window).
  244.  
  245.           It is not allowable to use TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww to change  the  |
  246.           stacking  order  of  a window (_v_a_l_u_e_M_a_s_k may not contain the  |
  247.           CCCCWWWWSSSSiiiibbbblllliiiinnnngggg or CCCCWWWWSSSSttttaaaacccckkkkMMMMooooddddeeee  bits).   To  change  the  stacking  |
  248.           order, use the procedure TTTTkkkk____RRRReeeessssttttaaaacccckkkkWWWWiiiinnnnddddoooowwww.
  249.  
  250.  
  251.      BBBBUUUUGGGGSSSS
  252.           TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwBBBBaaaacccckkkkggggrrrroooouuuunnnnddddPPPPiiiixxxxmmmmaaaapppp  and   TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwBBBBoooorrrrddddeeeerrrrPPPPiiiixxxxmmmmaaaapppp
  253.           differ  slightly  from  their  Xlib counterparts in that the
  254.           _p_i_x_m_a_p argument may not necessarily be  deleted  immediately
  255.           after  calling  one  of  these  procedures.  This is because
  256.           _t_k_w_i_n's window may not exist yet at the time of the call, in
  257.           which  case  _p_i_x_m_a_p  is  merely  saved  and  used later when
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 7/23/95)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333))))       TTTTkkkk ((((3333....3333))))        TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333))))
  269.  
  270.  
  271.  
  272.           _t_k_w_i_n's window is actually created.  If you wish  to  delete
  273.           _p_i_x_m_a_p,  then  call TTTTkkkk____MMMMaaaakkkkeeeeWWWWiiiinnnnddddoooowwwwEEEExxxxiiiisssstttt first to be sure that
  274.           _t_k_w_i_n's window exists and _p_i_x_m_a_p has been passed  to  the  X
  275.           server.
  276.  
  277.           A similar problem occurs for the _c_u_r_s_o_r argument  passed  to  |
  278.           TTTTkkkk____DDDDeeeeffffiiiinnnneeeeCCCCuuuurrrrssssoooorrrr.   The  solution  is the same as for pixmaps  |
  279.           above: call TTTTkkkk____MMMMaaaakkkkeeeeWWWWiiiinnnnddddoooowwwwEEEExxxxiiiisssstttt before freeing the cursor.
  280.  
  281.  
  282.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  283.           Tk_MoveToplevelWindow, Tk_RestackWindow
  284.  
  285.  
  286.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  287.           attributes, border, color, configure, height, pixel, pixmap,
  288.           width, window, x, y
  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.      Page 5                                          (printed 7/23/95)
  328.  
  329.  
  330.  
  331.