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

FreeBSD Manual Pages


home | help
Tk_InitStubs(3)		     Tk	Library	Procedures	       Tk_InitStubs(3)


       Tk_InitStubs - initialize the Tk	stubs mechanism

       #include	<tk.h>

       const char *
       Tk_InitStubs(interp, version, exact)

       Tcl_Interp *interp (in)		Tcl interpreter	handle.

       char *version (in)		A  version string consisting of	one or
					more  decimal  numbers	separated   by

       int exact (in)			Non-zero  means	that only the particu-
					lar Tk version specified by version is
					acceptable.   Zero means that versions
					newer than version are also acceptable
					as  long  as  they have	the same major
					version	number as version.

       The Tcl stubs mechanism defines a way to	dynamically bind extensions to
       a  particular  Tcl implementation at run	time.  the stubs mechanism re-
       quires no changes to applications  incorporating	 Tcl/Tk	 interpreters.
       Only  developers	 creating C-based Tcl/Tk extensions need to take steps
       to use the stubs	mechanism with their extensions.   See	the  Tcl_Init-
       Stubs page for more information.

       Enabling	 the  stubs mechanism for a Tcl/Tk extension requires the fol-
       lowing steps:

       1)   Call Tcl_InitStubs in the extension	before calling any  other  Tcl

       2)   Call  Tk_InitStubs	if  the	 extension before calling any other Tk

       2)   Define the USE_TCL_STUBS and the USE_TK_STUBS symbols.  Typically,
	    you	would include the -DUSE_TCL_STUBS and the -DUSE_TK_STUBS flags
	    when compiling the extension.

       3)   Link the extension with the	Tcl and	Tk stubs libraries instead  of
	    the	standard Tcl and Tk libraries.	On Unix	platforms, the library
	    names are libtclstub8.4.a and  libtkstub8.4.a;  on	Windows	 plat-
	    forms,  the	 library names are tclstub84.lib and tkstub84.lib. Ad-
	    just the library names with	appropriate version  number  but  note
	    that  the  extension may only be used with versions	of Tcl/Tk that
	    have that version number or	higher.

       Tk_InitStubs attempts to	initialize the Tk stub table pointers and  en-
       sure  that  the correct version of Tk is	loaded.	 In addition to	an in-
       terpreter handle, it accepts as arguments a version number and a	 Bool-
       ean  flag  indicating  whether  the extension requires an exact version
       match or	not.  If exact is 0, then the  extension  is  indicating  that
       newer versions of Tk are	acceptable as long as they have	the same major
       version number as version; non-zero means that only the specified  ver-
       sion  is	acceptable.  Tcl_InitStubs returns a string containing the ac-
       tual version of Tk satisfying the request, or NULL if the Tk version is
       not  acceptable,	does not support the stubs mechanism, or any other er-
       ror condition occurred.



Tk				      8.4		       Tk_InitStubs(3)


Want to link to this manual page? Use this URL:

home | help