NAME

       scopedobject  -  Create and manipulate a scoped Tcl] class
       object.


SYNOPSIS

       scopedobject objName ?options?


INHERITANCE

       None


STANDARD OPTIONS

       Name:     enterscopecommand:
       Command-Line Switch:     -enterscopecommand

              Specifies a Tcl command to invoke  when  an  object
              enters  scope  (i.e.  when  it  is  created..). The
              default is {}.

       Name:     enterscopecommand:
       Command-Line Switch:     -enterscopecommand

              Specifies a Tcl command to invoke  when  an  object
              exits  scope  (i.e.  when  it  is  deleted..).  The
              default is {}.

_________________________________________________________________


DESCRIPTION

       The scopedobject command creates a base class for defining
       Itcl  classes  which posses scoped behavior like Tcl vari­
       ables.  The objects are only accessible within the  proce­
       dure  in  which they are instantiated and are deleted when
       the procedure returns.  This class was designed  to  be  a
       general  purpose base class for supporting scoped incr Tcl
       classes.  The options include the  execute  a  Tcl  script
       command when an object enters and exits its scope.


METHODS

       The  scopedobject  command creates a new Tcl command whose
       name is pathName.  This command may be used to invoke var­
       ious  operations on the object.  It has the following gen­
       eral form:

              pathName option ?arg arg ...?

       Option and the args determine the exact  behavior  of  the
       command.   The  following commands are possible for scope­
       dobject objects:


OBJECT-SPECIFIC METHODS


              Returns the  current  value  of  the  configuration
              option given by option.  Option may have any of the
              values accepted by the scopedobject command.

       pathName configure ?option? ?value option value ...?
              Query or modify the configuration  options  of  the
              object.   If no option is specified, returns a list
              describing all of the available options  for  path­
              Name.   If  option is specified with no value, then
              the command returns a list describing the one named
              option  (this  list will be identical to the corre­
              sponding sublist of the value returned if no option
              is  specified).   If one or more option-value pairs
              are specified, then the command modifies the  given
              objects  option(s)  to have the given value(s);  in
              this case the  command  returns  an  empty  string.
              Option  may  have any of the values accepted by the
              scopedobject command.


EXAMPLE

              The scopedobject was primarily meant to be  a  base
              class.   The following is an example of usage with­
              out inheritance:

                proc scopedobject_demo {} {
                  scopedobject #auto         -exitscopecommand {puts "enter scopedobject_demo"}         -exitscopecommand {puts "exit scopedobject_demo"}
                }

                scopedobject_demo


AUTHOR

       John A. Tucker


KEYWORDS

       scopedobject, object


Man(1) output converted with man2html