NAME

       scopedobject - Create and manipulate a scoped [incr 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 variables.  The objects are only accessible within the procedure 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 various operations on the object.  It has the following general form:  pathName  option  ?arg  arg
       ...?   Option  and  the  args  determine  the  exact behavior of the command.  The following commands are
       possible for scopedobject objects:

OBJECT-SPECIFIC METHODS

       pathName cget option
              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 pathName.  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 corresponding 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
              without inheritance:

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

         scopedobject_demo

AUTHOR

       John A. Tucker

KEYWORDS

       scopedobject, object