TmCore(3Tm)							   TmCore(3Tm)

NAME    [Toc]    [Back]

     TmCore - the Core widget class

SYNOPSIS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

     This is the tcl binding to	the Xt Core widget.

RESOURCES    [Toc]    [Back]

     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    [Toc]    [Back]

     The methods supported for this widget and all its descendants are
	  getValues
	  setValues
	  manageChild
	  unmanageChild
	  getGC
	  callActionProc
	  destroyWidget
	  dragStart
	  dropSiteRegister
	  isComposite
	  isConstraint
	  isManaged
	  isSensitive



									Page 1






TmCore(3Tm)							   TmCore(3Tm)



	  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






									Page 2






TmCore(3Tm)							   TmCore(3Tm)



     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.



									Page 3






TmCore(3Tm)							   TmCore(3Tm)



     unmapWidget
	  This unmaps the widget, removing it from the display.	 It does not
	  remove it from the geometry management of the	parent.

CALLBACK SUBSTITUTIONS    [Toc]    [Back]

     No	substitutions are supported for	this class.

BUGS    [Toc]    [Back]

     None known.

AUTHOR    [Toc]    [Back]

     Jan Newmarch, University of Canberra


									PPPPaaaaggggeeee 4444