Tk_SetAppName man page on BSDi

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDi logo
[printable version]



Tk_SetAppName(3)      Tk Library Procedures	 Tk_SetAppName(3)

_________________________________________________________________

NAME
       Tk_SetAppName  -	 Set  the  name	 of  an	 application  for
       ``send'' commands

SYNOPSIS
       #include <tk.h>

       char *
       Tk_SetAppName(tkwin, name)

ARGUMENTS
       Tk_Window   tkwin    (in)      Token for window in  appli-
				      cation.	 Used	only   to
				      select a particular  appli-
				      cation.

       char	   *name    (in)      Name  under which to regis-
				      ter the application.
_________________________________________________________________

DESCRIPTION
       Tk_SetAppName associates a name with a  given  application
       and  records  that  association	on the display containing
       with the application's main window.  After this	procedure
       has  been  invoked, other applications on the display will
       be able to use the send command to  invoke  operations  in
       the  application.  If name is already in use by some other
       application on the display, then a new name will be gener-
       ated  by	 appending `` #2'' to name;  if this name is also
       in use, the number will be  incremented	until  an  unused
       name  is	 found.	 The return value from the procedure is a
       pointer to the name actually used.

       If the application already has a name  when  Tk_SetAppName
       is called, then the new name replaces the old name.

       Tk_SetAppName  also  adds  a  send command to the applica-
       tion's interpreter, which can be	 used  to  send	 commands
       from  this  application	to  others on any of the displays
       where the application has windows.

       The application's name  registration  persists  until  the
       interpreter is deleted or the send command is deleted from
       interp, at which point the name is automatically	 unregis-
       tered  and  the application becomes inaccessible via send.
       The application can be made accessible  again  by  calling
       Tk_SetAppName.

       Tk_SetAppName  is  called  automatically	 by  Tk_Init,  so
       applications don't normally need to call it explicitly.

Tk			       4.0				1

Tk_SetAppName(3)      Tk Library Procedures	 Tk_SetAppName(3)

       The command tk appname provides Tcl-level  access  to  the
       functionality of Tk_SetAppName.

KEYWORDS
       application, name, register, send command

Tk			       4.0				2

[top]

List of man pages available for BSDi

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net