eXept Software AG Logo

Smalltalk/X Webserver

Documentation of class 'TwoColumnTextView':

Home

Documentation
www.exept.de
Everywhere
for:
[back]

Class: TwoColumnTextView


Inheritance:

   Object
   |
   +--GraphicsMedium
      |
      +--DisplaySurface
         |
         +--SimpleView
            |
            +--SyncedMultiColumnTextView
               |
               +--TwoColumnTextView
                  |
                  +--DiffTextView
                  |
                  +--Tools::DiffCodeView2

Package:
stx:libwidg2
Category:
Views-Text
Version:
rev: 1.27 date: 2019/03/07 09:42:40
user: cg
file: TwoColumnTextView.st directory: libwidg2
module: stx stc-classLibrary: libwidg2
Author:
Claus Gittinger

Description:


a view showing two texts side-by-side.
Scrolling is synced, by always scrolling both views.
This type of view is especially useful to show diff-lists,
code-versions, or other one-by-one viewable texts.

Usually, it does not make much sense, to put totally different
or unrelated texts into this kind of view.

See subclass DiffTextView for a real class;
see ChangesBrowsers compare operation for a real application
of this kind of views.


Related information:

    DiffTextView
    TextView
    EditTextView

Class protocol:

instance creation
o  openOn: firstText and: secondText
open up a view showing firstText and secondText side-by-side.
This does not make much sense for unrelated texts - of course.

usage example(s):

     TwoColumnTextView
        openOn:('smalltalk.rc' asFilename contentsOfEntireFile)
        and:('display.rc' asFilename contentsOfEntireFile)


     TwoColumnTextView
        openOn:('display.rc' asFilename contentsOfEntireFile)
        and:('smalltalk.rc' asFilename contentsOfEntireFile)

o  openOn: firstText and: secondText in: aView
open up a view showing firstText and secondText side-by-side.
This does not make much sense for unrelated texts - of course.

o  openOn: firstText and: secondText title: titleOrNil
open up a view showing firstText and secondText side-by-side.
This does not make much sense for unrelated texts - of course.

usage example(s):

     TwoColumnTextView
        openOn:('smalltalk.rc' asFilename contentsOfEntireFile)
        and:('display.rc' asFilename contentsOfEntireFile)


     TwoColumnTextView
        openOn:('display.rc' asFilename contentsOfEntireFile)
        and:('smalltalk.rc' asFilename contentsOfEntireFile)

o  openOn: firstText label: firstLabel and: secondText label: secondLabel
open up a view showing firstText and secondText side-by-side,
and labels for both views.
This does not make much sense for unrelated texts - of course.

usage example(s):

     TwoColumnTextView
        openOn:('smalltalk.rc' asFilename contentsOfEntireFile)
        label:'smalltalk.rc'
        and:('display.rc' asFilename contentsOfEntireFile)
        label:'display.rc'

o  openOn: firstText label: firstLabel and: secondText label: secondLabel title: titleOrNil
open up a view showing firstText and secondText side-by-side,
and labels for both views.
This does not make much sense for unrelated texts - of course.

usage example(s):

     TwoColumnTextView
        openOn:('smalltalk.rc' asFilename contentsOfEntireFile)
        label:'smalltalk.rc'
        and:('display.rc' asFilename contentsOfEntireFile)
        label:'display.rc'

instance creation-basic
o  openOn: firstText label: firstLabel and: secondText label: secondLabel in: aView
open up a view showing firstText and secondText side-by-side,
and labels for both views. Return the (wrapped) diff-view.
This does not make much sense for unrelated texts - of course.

specification
o  numberOfViews
(comment from inherited method)
return the number of the synced subViews.
Usually redefined in subclasses


Instance protocol:

accessing
o  leftTextView

o  numberOfChanges

o  rightTextView

o  text1: t1 text2: t2

actions
o  moveToLine: aLineNr

o  moveToNextChanged

o  moveToNextChangedAfter: startLine
find the first line which is not a plain string

o  moveToPreviousChanged

initialization
o  addNextPreviousButtons
set up-down buttons


Examples:


TwoColumnTextView are currently not directly used by the system. However, it is used as an abstract superclass for DiffTextView. See more examples there. (you may find nice uses for it anyway ...)
TwoColumnTextView
   openOn:('smalltalk.rc' asFilename contents)
   and:('display.rc' asFilename contents)
TwoColumnTextView
   openOn:('display.rc' asFilename contents)
   and:('smalltalk.rc' asFilename contents)
TwoColumnTextView
   openOn:('smalltalk.rc' asFilename contents)
   label:'smalltalk.rc'
   and:('display.rc' asFilename contents)
   label:'display.rc'


ST/X 7.2.0.0; WebServer 1.670 at bd0aa1f87cdd.unknown:8081; Tue, 11 Aug 2020 00:21:53 GMT