Class: Workspace

• Inheritance
• Description
• Related information
• Class protocol
  • accessing
  • defaults
  • getting a new Workspace
  • history
  • queries
  • workspace variables
• Instance protocol
  • accessing
  • compiler interface
  • compiler interface-error handling
  • drag & drop
  • editing
  • event handling
  • executing
  • initialization & release
  • menu & menu actions
  • misc
  • queries
• Demonstration

Inheritance:

   Object
   |
   +--GraphicsMedium
      |
      +--DisplaySurface
         |
         +--SimpleView
            |
            +--View
               |
               +--ListView
                  |
                  +--TextView
                     |
                     +--EditTextView
                        |
                        +--TextCollector
                           |
                           +--Workspace
                              |
                              +--CodeView

Package:

stx:libwidg

Category:

Interface-Smalltalk

Version:

rev: 1.394 date: 2019/06/26 21:25:11

user: cg

file: Workspace.st directory: libwidg

module: stx stc-classLibrary: libwidg

Author:

Claus Gittinger

Description:

a view for editable text which can evaluate expressions.
I.e. its basically a view for editable text, with added
'doIt', 'printIt' and 'inspectIt' functions on the popup-menu.

The action to be performed on doIt is defined by a block,
which can be defined by the owner of this view.
(thus you can put a workspace into more complex widgets, and
 control what should happen on 'doIt').

A useful default action is automatically defined, which simply
evaluates the selection as a smalltalk expression.
(but, a lisp or prolog workspace would define its own action,
 to call for another compiler/interpreter  ...)

Special workspace- and doIt variables:
    workspaces can be configured to automatically define undefined variables
    as either workspace- or doIt variables. When encountering undefined variables,
    the parser asks for an action, which is responded with #workspace or doIt if a
    workspace is the requestor of a doIt. Both are implemented as value holders, and
    the parser will generate code sending value/value: instead of normal assignment.
    Workspace variables are kept in the Workspace class and will both persist between doIts
    and also be visible across workspaces. They are perfect for scripting (and therefore enabled
    by default when stx is started with one of the scripting options).
    DoIt variables are only valid during a single doIt.
    Be aware that when you ask from the outside via workspaceVariableAt:, you'll get a valueHolder.
    This is by purbose, as it allows for easy monitoring and tracing of changes.

Caveat:
    in this version, Workspace does not yet support doIt in MVC setups.
    For now, simulate this by setting the doItAction, to notify the
    model manually about the doIt.


[instance variables:]

  doItAction      <Block>         block to evaluate for doIt

  errorFgColor    <Color>         fg-Color to be used when highlighting errors

  errorBgColor    <Color>         bg-Color to be used when highlighting errors

  codeStartPosition               private temporary


[styleSheet values:]

  codeErrorSelectionForegroundColor     fg color to highlight errors
                                        (default: selection fg)

  codeErrorSelectionBackgroundColor     bg color to highlight errors
                                        (default: selection bg)

Related information:

    Workspace
    EditTextView
    Parser
    ByteCodeCompiler

Class protocol:

 sniplets

Snippets := nil


** This is an obsolete interface - do not use it (it may vanish in future versions) **

 sniplets: something

 snippets

Snippets := nil

 snippets: aDictionary

 defaultCompletionSupportClass

 defaultLabel

my default window label

 initializeDefaultAbbreviations

default snippets/abbreviations. TODO: save/load snippets

usage example(s):

after a code change below, update with: self initializeDefaultAbbreviations.

 updateStyleCache

extract values from the styleSheet and cache them in class variables

 open

launch a new workspace

usage example(s):

Workspace open

 openForRemote: hostName

launch a new workspace to evaluate expression on some remote machine.
Entered expressions are sent over to some partner machine, evaluated there,
and the result is shown here.
This requires the RemoteObjects package to be loaded.

usage example(s):

Workspace openForRemote:'andi'

 openWith: initialText selected: selectedBoolean

launch a new workspace with some initial contents

usage example(s):

Workspace openWith:'Transcript showCR:''hello world'''

 clearDoItHistory

 doItHistory

 doItHistorySize

the number of remembered doIts

 rememberDoIt: aString

unparsable

 isVisualStartable

returns whether this application class can be started via #open
(i.e. via a double click on the class in the browser)

 addWorkspaceVariable: name

create a new workspace variable

 anyWorkspaceVariableIsDefined

 rememberResultAsWorkspaceVariable: lastResult

remember some last result as _0,
and shift the previous results (i.e. _0 -> _1 -> .. _9)

 removeAllWorkspaceVariables

delete all workspace variables

 removeWorkspaceVariable: name

delete a workspace variable

 workspaceVariableAt: name

retrieve a workspace variable's value

usage example(s):

Workspace workspaceVariableAt:'foo' put:1234. Workspace workspaceVariableAt:'foo'

 workspaceVariableAt: name put: aValue

set or define a workspace variable

 workspaceVariableHolderAt: name

retrieve a workspace variable (actually, a holder onto it)

 workspaceVariableNames

retrieve the collection of workspace variable names only

 workspaceVariables

retrieve the collection of workspace variable holders.
That is a dictionary associating names to values.

Instance protocol:

 allowValueDrop: aBoolean

if on (the default), any smalltalk value can be dropped and leads to a workspace variable
holding on to that being defined. Can be turned off, if you don't like this (for standAlone apps)

 autoDefineVariables

undefined variables handling:
are automatically defined as workspace variable if autoDefineVariables is #workspace.
are automatically defined as doit variable if autoDefineVariables is #doit.
are left undefined if autoDefineVariables is nil.

 autoDefineVariables: nilOrSymbol

undefined variables handling:
are automatically defined as workspace variable if nilOrSymbol is #workspace.
are automatically defined as doit variable if nilOrSymbol is #doit.
are left undefined if nilOrSymbol is nil.

 commentStrings: anArrayOfCommentStrings

define the comment strings

 doItAction

return the action to be performed when 'doIt' is selected

 doItAction: aOneArgBlock

define the action to be performed when 'doIt' is selected.
The block will be evaluated, passing the selection as a String argument.
A default doItAction is set for you in the initialize method.

 editedClass

for the code completion

 editedLanguage

get the programming language (for comments, indentation etc.)

 editedLanguage: aProgrammingLanguageOrNil

set the programming language (for comments, indentation etc.)

 editedMethod

for the code completion

 editedMethodOrClass

for the code completion

 editedMethodOrClass: aMethodOrClass

Sets the edited method or class (for code completion)

 errorBackgroundColor

 errorForegroundColor

 nameSpaceForDoits

can be used by the embedding application to control doIt execution
(especially: for tools like expecco, to provide better workspaces

 nameSpaceForDoits: aNameSpaceOrNil

can be used by the embedding application to control doIt execution
(especially: for tools like expecco, to provide better workspaces

 namespaceForDoits: aNameSpaceOrNil

can be used by the embedding application to control doIt execution
(especially: for tools like expecco, to provide better workspaces

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 poolsConsideredInDoIts: aCollectionOfPools

can be used by the embedding application to control doIt execution
(especially: for tools like expecco, to provide better workspaces

 simulatedSelf

the 'self' instance used in an evaluation (also used in code completion of self messages)

 simulatedSelf: anObject

define what self is in an evaluation (also useful in code completion of self messages)

 warningBackgroundColor

 warningForegroundColor

 compilerClass

? Compiler

 compilerClass: aCompilerClass

 currentSourceCode

special interface to compiler - called by parser
to get the updated source code after a corrected error

 wantChangeLog

sent by the compiler to ask if a changeLog entry should
be written. Return true here.

 correctableError: aString position: relPos to: relEndPos from: aCompiler

compiler notifies us of a correctable error;
hilight the error (relPos to relEndPos) and show a Box asking for continue/correct/abort;
this method should return true to the compiler if user wants the error
to be corrected; false otherwise

 correctableSelectorWarning: aString position: relPos to: relEndPos from: aCompiler

compiler notifies us of a correctable selector warning;
hilight the error (relPos to relEndPos) and show a Box asking for continue/correct/abort;
this method should return true to the compiler if user wants the error
to be corrected; false otherwise

 correctableWarning: aString position: relPos to: relEndPos from: aCompiler

compiler notifies us of a correctable warning;
hilight the error (relPos to relEndPos) and show a Box asking for continue/correct/abort;
this method should return true to the compiler if user wants the error
to be corrected; false otherwise

 error: aString position: relPos to: relEndPos asWarning: asWarning

obsolete - no longer invoked

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 error: aString position: relPos to: relEndPos from: aCompiler

compiler notifies us of an error; hilight the error (relPos to relEndPos)
and show a Box asking for continue/abort.
Return true for correction, false of not (or not possible)

 error: aString position: relPos to: relEndPos from: aCompiler asWarning: asWarning

compiler notifies us of an error; hilight the error (relPos to relEndPos)
and show a Box asking for continue/abort.

 highlightingErrorLine: lineNr do: aBlock

evaluate aBlock while some selection is shown highlighted with error colors.

 highlightingErrorPosition: relPos to: relEndPos do: aBlock

evaluate aBlock while some selection is shown highlighted with error colors.

 highlightingErrorPosition: relPos to: relEndPos withForeground: hilightFg andBackground: hilightBg do: aBlock

evaluate aBlock while some selection is shown highlighted with colors passed as args.

 highlightingWarningPosition: relPos to: relEndPos do: aBlock

evaluate aBlock while some selection is shown highlighted with warning colors.

 unusedVariableWarning: aString position: relPos to: relEndPos from: aCompiler

compiler notifies us of a (or some) unused variables;
hilight the error (relPos to relEndPos) and show a Box asking for continue/correct/abort;
this method should return true to the compiler if user wants the error
to be corrected; false otherwise

 warning: aString position: relPos to: relEndPos from: aCompiler

compiler notifies us of a warning - same behavior as error

 canDrop: aDropContext

if allowValueDrop is true, any text- or file-object can be dropped into workspace
(printString); otherwise, only ...

 doDrop: aDropContext

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 drop: aDropContext

Any object can be dropped into workspace...

 commentFrom: line1 to: line2

convenient function to comment out a block.
All lines from line1 to line2 get an end-of-line comment
in the first col
(if no eol comment is available, a bracketing comment is used).

 commentSelection

convenient function to comment out a block.
All lines from line1 to line2 get an end-of-line comment
in the first col.

 uncommentFrom: line1 to: line2

convenient function to comment out a block.
All lines from line1 to line2 get an end-of-line comment
in the first col.
(if no eol comment is available, a bracketing comment is removed)

 uncommentSelection

convenient function to comment out a block.
All lines from line1 to line2 get an end-of-line comment
in the first col.

 keyPress: key x: x y: y

(comment from inherited method)
handle keyboard input

    Workspace open