Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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>

       const char *
       Tk_SetAppName(tkwin, name)

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

       const char *name	(in)	      Name under which to register the	appli-
				      cation.
______________________________________________________________________________

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 applica-
       tion on the display, then a new name will be generated by  appending  "
       #2"  to	name;	if this	name is	also in	use, the number	will be	incre-
       mented until an unused name is found.  The return value from the	proce-
       dure 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 application's	inter-
       preter, 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 unregistered and the application becomes inacces-
       sible  via send.	 The application can be	made accessible	again by call-
       ing Tk_SetAppName.

       Tk_SetAppName is	called automatically by	Tk_Init,  so  applications  do
       not normally need to call it explicitly.

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

KEYWORDS
       application, name, register, send command

Tk				      4.0		      Tk_SetAppName(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tk_SetAppName.tk86&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help