TmCore(3Tm)

NAME
     TmCore - the Core widget class

SYNOPSIS
     No command exists to create this widget - it is for inheritance purposes
     only.

DESCRIPTION
     This is the tcl binding to the Xt Core widget.

RESOURCES
     The new resources are

          background
          backgroundPixmap
          borderColor
          borderPixmap
          borderWidth
          destroyCallback
          height
          mappedWhenManaged
          sensitive
          width
          x
          y

     background
          The value for this resource is the name of a color.

     height
          The value for this resource is an integer number of pixels.

     sensitive
          The values for this resource are
               true
               false

METHODS
     The methods supported for this widget and all its descendants are
          getValues
          setValues
          manageChild
          unmanageChild
          getGC
          callActionProc
          destroyWidget
          dragStart
          dropSiteRegister
          isComposite
          isConstraint
          isManaged
          isSensitive
          isShell
          mapWidget
          processTraversal
          realizeWidget
          resources
          setSensistive
          unmapWidget


     getValues -resource vbl ...
          getValues takes a list of resource/variable pairs and stores the
          value of each resource in the corresponding variable.


     setValues -resource value ...
          setValues takes a list of resource/value pairs and sets each
          resource to the corresponding value.


     manageChild
          This manages the child and brings it under the geometry management
          of the parent.


     unmanageChild
          This removes the child from the geometry management of the parent.

     getGC -background bg -foreground fg
          This method creates a graphics context with the specified foreground
          and background values, and returns an XID that can be used in
          drawing commands requiring a graphics context.


     callActionProc action [options]
          This calls the widget action specified.  The action must be in the
          form it would appear in an action table, The event included given to
          the action is by default of type ClientMessage.  Options include
          -type ButtonRelease | ButtonPress | KeyRelease | KeyPress
               This sets the event type.
     -x x
               This sets the x value in the event.
     -y y
               This sets the y value in the event.
     -keysysm keysym
               This sets the keysym for a KeyRelease or KeyPress event. A
               keysym is the Xt abstraction for keys.
     For example the arrow widget has an action Activate() which requires x
     and y values of the pointer:
          callActionproc Activate() -type ButtonPress -x 0 -y 0

     destroyWidget
          The destroys the widget and the tcl command associated to it.


     dragStart
          This is used in drag and drop. See TmDrag.man.


     dropSiteRegister
          This is used in drag and drop. See TmDrag.man.


     mapWidget
          This maps the widget, causing it to become visible if unmapped.


     processTraversal  direction
          This sets the widget that receives the next keyboard events. The
          possible values are
               current
               down
               home
               left
               next
               next_tab_group
               prev
               prev_tab_group
               right
               up


     realizeWidget
          This realizes the widget and all its children, which creates windows
          for the widget and its children. Generally this would only be used
          on `.', but may be used on other widgets if it is neccessary that
          they have an X window.


     resources
          This returns a list of resources that the widget has.  Each element
          of the list consists of a list of five values:  the resource name as
          used in get/setValues, the resource name as used in resource files,
          the resource class as used in resource files, the resource type as
          known to Motif and the resource value.  in cases where the resource
          value makes no sense (as in a C pointer), it is replaced by an empty
          string.



     setSensitive  true | false
          Sets the sensitivity of the widget to input events to either true or
          false.
     unmapWidget
          This unmaps the widget, removing it from the display.  It does not
          remove it from the geometry management of the parent.


CALLBACK SUBSTITUTIONS
     No substitutions are supported for this class.

BUGS
     None known.

AUTHOR
     Jan Newmarch, University of Canberra