Class: VisualComponent

• Inheritance
• Description
• Related information
• Class protocol
  • instance creation
  • queries
• Instance protocol
  • accessing
  • accessing-STX-attributes
  • accessing-color & font
  • accessing-dimensions
  • accessing-mvc
  • change & update
  • displaying
  • event handling
  • initialization
  • queries
  • testing

Inheritance:

   Object
   |
   +--DisplayObject
      |
      +--VisualComponent
         |
         +--VisualPart

Package:

stx:libview2

Category:

Compatibility-ST80-Graphics-Display Objects

Version:

rev: 1.38 date: 2018/11/23 14:09:43

user: stefan

file: VisualComponent.st directory: libview2

module: stx stc-classLibrary: libview2

Author:

Claus Gittinger

Description:

abstract superclass for all kinds of visual components.
This class and its subclasses (currently) exist mostly for
ST-80 compatibility - to provide a home for ported PD classes,
which depend on the VisualComponent hierarchy.

Notice: 
    this class was implemented using protocol information
    from alpha testers, from reading PD programs and 
    from the Hopkins/Horan book.
    - it may not be complete or compatible to the corresponding ST-80 class. 
    If you encounter any incompatibilities, please forward a note 
    describing the incompatibility verbal (i.e. no code) to the ST/X team.
    This is still being constructed - not yet finished.

Related information:

    GeometricWrapper

Class protocol:

 new

 defaultFont

 defaultViewBackgroundColor

 isAbstract

Return if this class is an abstract class.
True is returned here for myself only; false for subclasses.
Abstract subclasses must redefine this again.

Instance protocol:

 container: someContainer

ignored here

 geometryLayout

ignored here

 geometryLayout: aLayout

ignored here

 hiddenOnRealize: aBoolean

ignored here

 id

ignored here

 setParentViewIn: aView

ignored here - for now

 superView

 application

 borderWidth

 borderWidth: aNumber

 canTab: aBoolean

 layout

 layout: newLayout

 level

 level: newLevel

 name

 realized

return true, if the receiver is realized.
Realized means that it has been mapped (i.e. made visible) on
the display (as opposed to being only created and possibly invisible)

 viewBackground

 backgroundColor

 backgroundColor: aColor

ignored here

 defaultFont

 font: aFont

ignored here

 foregroundColor

 foregroundColor: aColor

ignored here

 bottom

return my bottom y coordinate

 bounds

return my bounds

 bounds: aRectangle

set my bounds

 computePreferredExtent

 defaultExtent

 extent: anExtent

set my extent

 left

return my left x coordinate

 origin: newOrigin

move my origin

 preferredBounds

return my preferredBounds

 preferredExtent

 right

return my right x coordinate

 top

return my top y coordinate

 viewRectangle

 model

return nil - generic components have no model

 changedPreferredBounds: oldPreferredBoundsOrNil

The receiver is notifying any dependents that its preferredBounds has changed.

 displayOn: aGCOrStream

display the receiver on some graphicsContext.
The sender is repsonsible for restoring the GC's state
(i.e. it may be left in any undefined state)

** This method raises an error - it must be redefined in concrete classes **

 displayOn: aGC at: aPoint

display the receiver translated by some amount on some graphicsContext

 displayOn: aGC x: x y: y

display the receiver translated by some amount on some graphicsContext

 buttonPress: button x: x y: y

button was pressed over me - ignored here

 buttonRelease: button x: x y: y

button was released over me - ignored here

 containerChangedSize

(comment from inherited method)
ignored here - added to allow images to be used like
VisualComponents (later, Image should inherit from it)

 containerMapped

 containerUnmapped

 destroy

(comment from inherited method)
SimpleView>>destroySubviews wants to destroy us (if we are a view's component).
Do nothing here

 hasKeyboardFocus: aBoolean

notification from the windowGroup that I got the keyboardFocus.

 keyPress: key x: x y: y

key was pressed over me - ignored here

 keyRelease: key x: x y: y

key was released over me - ignored here

 mapped

 showFocus: explicit

 showNoFocus: explicit