87 lines
2.5 KiB
C
87 lines
2.5 KiB
C
/*
|
||
* tkWinSend.c --
|
||
*
|
||
* This file provides procedures that implement the "send"
|
||
* command, allowing commands to be passed from interpreter
|
||
* to interpreter.
|
||
*
|
||
* Copyright (c) 1997 by Sun Microsystems, Inc.
|
||
*
|
||
* See the file "license.terms" for information on usage and redistribution
|
||
* of this file, and for a DISCLAIMER OF ALL WARRANTIES.
|
||
*
|
||
* SCCS: @(#) tkWinSend.c 1.4 97/06/10 09:39:50
|
||
*/
|
||
|
||
#include "tkPort.h"
|
||
#include "tkInt.h"
|
||
|
||
|
||
/*
|
||
*--------------------------------------------------------------
|
||
*
|
||
* Tk_SetAppName --
|
||
*
|
||
* This procedure is called to associate an ASCII name with a Tk
|
||
* application. If the application has already been named, the
|
||
* name replaces the old one.
|
||
*
|
||
* Results:
|
||
* The return value is the name actually given to the application.
|
||
* This will normally be the same as name, but if name was already
|
||
* in use for an application then a name of the form "name #2" will
|
||
* be chosen, with a high enough number to make the name unique.
|
||
*
|
||
* Side effects:
|
||
* Registration info is saved, thereby allowing the "send" command
|
||
* to be used later to invoke commands in the application. In
|
||
* addition, the "send" command is created in the application's
|
||
* interpreter. The registration will be removed automatically
|
||
* if the interpreter is deleted or the "send" command is removed.
|
||
*
|
||
*--------------------------------------------------------------
|
||
*/
|
||
|
||
char *
|
||
Tk_SetAppName(tkwin, name)
|
||
Tk_Window tkwin; /* Token for any window in the application
|
||
* to be named: it is just used to identify
|
||
* the application and the display. */
|
||
char *name; /* The name that will be used to
|
||
* refer to the interpreter in later
|
||
* "send" commands. Must be globally
|
||
* unique. */
|
||
{
|
||
return name;
|
||
}
|
||
|
||
/*
|
||
*----------------------------------------------------------------------
|
||
*
|
||
* TkGetInterpNames --
|
||
*
|
||
* This procedure is invoked to fetch a list of all the
|
||
* interpreter names currently registered for the display
|
||
* of a particular window.
|
||
*
|
||
* Results:
|
||
* A standard Tcl return value. Interp->result will be set
|
||
* to hold a list of all the interpreter names defined for
|
||
* tkwin's display. If an error occurs, then TCL_ERROR
|
||
* is returned and interp->result will hold an error message.
|
||
*
|
||
* Side effects:
|
||
* None.
|
||
*
|
||
*----------------------------------------------------------------------
|
||
*/
|
||
|
||
int
|
||
TkGetInterpNames(interp, tkwin)
|
||
Tcl_Interp *interp; /* Interpreter for returning a result. */
|
||
Tk_Window tkwin; /* Window whose display is to be used
|
||
* for the lookup. */
|
||
{
|
||
return TCL_OK;
|
||
}
|