home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat3 / Tk / setappname.z / setappname
Encoding:
Text File  |  1998-10-30  |  3.6 KB  |  67 lines
  1.  
  2.  
  3.  
  4. TTTTkkkk____SSSSeeeettttAAAAppppppppNNNNaaaammmmeeee((((3333TTTTkkkk))))                                          TTTTkkkk____SSSSeeeettttAAAAppppppppNNNNaaaammmmeeee((((3333TTTTkkkk))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      Tk_SetAppName - Set the name of an application for ``send'' commands
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
  13.  
  14.      char *
  15.      TTTTkkkk____SSSSeeeettttAAAAppppppppNNNNaaaammmmeeee(_t_k_w_i_n, _n_a_m_e)
  16.  
  17. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  18.      Tk_Window   _t_k_w_i_n    (in)      Token for window in application.  Used
  19.                                     only to select a particular application.
  20.  
  21.      char        *_n_a_m_e    (in)      Name under which to register the
  22.                                     application.
  23.  
  24.  
  25. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.      TTTTkkkk____SSSSeeeettttAAAAppppppppNNNNaaaammmmeeee associates a name with a given application and records that
  27.      association on the display containing with the application's main window.
  28.      After this procedure has been invoked, other applications on the display
  29.      will be able to use the sssseeeennnndddd command to invoke operations in the
  30.      application.  If _n_a_m_e is already in use by some other application on the
  31.      display, then a new name will be generated by appending `` ####2222'' to _n_a_m_e;
  32.      if this name is also in use, the number will be incremented until an
  33.      unused name is found.  The return value from the procedure is a pointer
  34.      to the name actually used.
  35.  
  36.      If the application already has a name when TTTTkkkk____SSSSeeeettttAAAAppppppppNNNNaaaammmmeeee is called, then
  37.      the new name replaces the old name.
  38.  
  39.      TTTTkkkk____SSSSeeeettttAAAAppppppppNNNNaaaammmmeeee also adds a sssseeeennnndddd command to the application's interpreter,
  40.      which can be used to send commands from this application to others on any
  41.      of the displays where the application has windows.
  42.  
  43.      The application's name registration persists until the interpreter is
  44.      deleted or the sssseeeennnndddd command is deleted from _i_n_t_e_r_p, at which point the
  45.      name is automatically unregistered and the application becomes
  46.      inaccessible via sssseeeennnndddd.  The application can be made accessible again by
  47.      calling TTTTkkkk____SSSSeeeettttAAAAppppppppNNNNaaaammmmeeee.
  48.  
  49.      TTTTkkkk____SSSSeeeettttAAAAppppppppNNNNaaaammmmeeee is called automatically by TTTTkkkk____CCCCrrrreeeeaaaatttteeeeMMMMaaaaiiiinnnnWWWWiiiinnnnddddoooowwww, so
  50.      applications don't normally need to call it explicitly.
  51.  
  52.      The command ttttkkkk aaaappppppppnnnnaaaammmmeeee provides Tcl-level access to the functionality of
  53.      TTTTkkkk____SSSSeeeettttAAAAppppppppNNNNaaaammmmeeee.
  54.  
  55.  
  56. KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  57.      application, name, register, send command
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.