Debian Codegraph @

pTk/mTk/win/tkWinSend.c

raw
1 /*
2 * tkWinSend.c --
3 *
4 * This file provides procedures that implement the "send"
5 * command, allowing commands to be passed from interpreter
6 * to interpreter.
7 *
8 * Copyright (c) 1997 by Sun Microsystems, Inc.
9 *
10 * See the file "license.terms" for information on usage and redistribution
11 * of this file, and for a DISCLAIMER OF ALL WARRANTIES.
12 *
13 * RCS: @(#) $Id: tkWinSend.c,v 1.3 2002/08/05 04:30:41 dgp Exp $
14 */
15
16 #include "tkPort.h"
17 #include "tkInt.h"
18
19
20 /*
21 *--------------------------------------------------------------
22 *
23 * Tk_SetAppName --
24 *
25 * This procedure is called to associate an ASCII name with a Tk
26 * application. If the application has already been named, the
27 * name replaces the old one.
28 *
29 * Results:
30 * The return value is the name actually given to the application.
31 * This will normally be the same as name, but if name was already
32 * in use for an application then a name of the form "name #2" will
33 * be chosen, with a high enough number to make the name unique.
34 *
35 * Side effects:
36 * Registration info is saved, thereby allowing the "send" command
37 * to be used later to invoke commands in the application. In
38 * addition, the "send" command is created in the application's
39 * interpreter. The registration will be removed automatically
40 * if the interpreter is deleted or the "send" command is removed.
41 *
42 *--------------------------------------------------------------
43 */
44
45 CONST char *
46 Tk_SetAppName(tkwin, name)
47 Tk_Window tkwin; /* Token for any window in the application
48 * to be named: it is just used to identify
49 * the application and the display. */
50 CONST char *name; /* The name that will be used to
51 * refer to the interpreter in later
52 * "send" commands. Must be globally
53 * unique. */
54 {
55 return name;
56 }
57
58 /*
59 *----------------------------------------------------------------------
60 *
61 * TkGetInterpNames --
62 *
63 * This procedure is invoked to fetch a list of all the
64 * interpreter names currently registered for the display
65 * of a particular window.
66 *
67 * Results:
68 * A standard Tcl return value. Interp->result will be set
69 * to hold a list of all the interpreter names defined for
70 * tkwin's display. If an error occurs, then TCL_ERROR
71 * is returned and interp->result will hold an error message.
72 *
73 * Side effects:
74 * None.
75 *
76 *----------------------------------------------------------------------
77 */
78
79 int
80 TkGetInterpNames(interp, tkwin)
81 Tcl_Interp *interp; /* Interpreter for returning a result. */
82 Tk_Window tkwin; /* Window whose display is to be used
83 * for the lookup. */
84 {
85 return TCL_OK;
86 }