1tkvars(n) Tk Built-In Commands tkvars(n)
2______________________________________________________________________________
6
8 geometry, tk_library, tk_patchLevel, tk_strictMotif, tk_version - Vari‐
9 ables used or set by Tk
10______________________________________________________________________________
11
13 The following Tcl variables are either set or used by Tk at various
14 times in its execution:
15 tk_library This variable holds the file name for a directory con‐
17 taining a library of Tcl scripts related to Tk. These
18 scripts include an initialization file that is normally
19 processed whenever a Tk application starts up, plus
20 other files containing procedures that implement default
21 behaviors for widgets.
22 The initial value of tk_library is set when Tk is added
24 to an interpreter; this is done by searching several
25 different directories until one is found that contains
26 an appropriate Tk startup script. If the TK_LIBRARY en‐
27 vironment variable exists, then the directory it names
28 is checked first. If TK_LIBRARY is not set or does not
29 refer to an appropriate directory, then Tk checks sev‐
30 eral other directories based on a compiled-in default
31 location, the location of the Tcl library directory, the
32 location of the binary containing the application, and
33 the current working directory.
34 The variable can be modified by an application to switch
36 to a different library.
37 tk_patchLevel Contains a dot-separated sequence of decimal integers
39 giving the current patch level for Tk. The patch level
40 is incremented for each new release or patch, and it
41 uniquely identifies an official version of Tk.
42 This value is normally the same as the result of “pack‐
44 age require Tk”.
45 tk_strictMotif This variable is set to zero by default. If an applica‐
47 tion sets it to one, then Tk attempts to adhere as
48 closely as possible to Motif look-and-feel standards.
49 For example, active elements such as buttons and scroll‐
50 bar sliders will not change color when the pointer
51 passes over them. Modern applications should not nor‐
52 mally set this variable.
53 tk_version Tk sets this variable in the interpreter for each appli‐
55 cation. The variable holds the current version number
56 of the Tk library in the form major.minor. Major and
57 minor are integers. The major version number increases
58 in any Tk release that includes changes that are not
59 backward compatible (i.e. whenever existing Tk applica‐
60 tions and scripts may have to change to work with the
61 new release). The minor version number increases with
62 each new release of Tk, except that it resets to zero
63 whenever the major version number changes.
64 INTERNAL AND DEBUGGING VARIABLES
66 These variables should not normally be set by user code.
67 tk::Priv
69 This variable is an array containing several pieces of informa‐
70 tion that are private to Tk. The elements of tk::Priv are used
71 by Tk library procedures and default bindings. They should not
72 be accessed by any code outside Tk.
73 tk_textRedraw
75 tk_textRelayout
77 These variables are set by text widgets when they have debugging
78 turned on. The values written to these variables can be used to
79 test or debug text widget operations. These variables are
80 mostly used by Tk's test suite.
81
83 The following variables are only guaranteed to exist in wish executa‐
84 bles; the Tk library does not define them itself but many Tk environ‐
85 ments do.
86 geometry
88 If set, contains the user-supplied geometry specification to use
89 for the main Tk window.
90
92 package(n), tclvars(n), wish(1)
93
95 environment, text, variables, version
96Tk 4.1 tkvars(n)