*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> Tk/setappname (3)              
Title
Content
Arch
Section
 

Contents


Tk_SetAppName(3Tk)					    Tk_SetAppName(3Tk)


NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #include <tk.h>

     char *
     Tk_SetAppName(tkwin, name)

ARGUMENTS    [Toc]    [Back]

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

     char	 *name	  (in)	    Name under which to	register the
				    application.

DESCRIPTION    [Toc]    [Back]

     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 generated	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 application'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 unregistered	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_CreateMainWindow, so
     applications don't	normally need to call it explicitly.

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

KEYWORDS    [Toc]    [Back]

     application, name,	register, send command


									PPPPaaaaggggeeee 1111
[ Back ]
 Similar pages
Name OS Title
intro IRIX introduction to commands, application programs, and programming commands.
tsm.command HP-UX send commands to the Terminal Session Manager (TSM)
intro HP-UX introduction to system maintenance commands and application programs
MrmFetchWidgetOverride IRIX Fetches any indexed (UIL named) application widget. It overrides the arguments specified for this application
MrmFetchWidgetOverride HP-UX Fetches any indexed (UIL named) application widget. It overrides the arguments specified for this application
DtActionCallbackProc HP-UX notify application that the status of an application has changed
tt_message_send HP-UX send a message
tclxtsend IRIX the Tk "send" protocol for Xt
mailx FreeBSD send and receive mail
procset Tru64 Send a signal to one or more processes
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service