Class: TwoColumnTextView

• Inheritance
• Description
• Related information
• Class protocol
  • instance creation
  • instance creation-basic
  • specification
• Instance protocol
  • accessing
  • actions
  • initialization
• Examples

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:

 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)

 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.

 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)

 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'

 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'

 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.

 numberOfViews

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

Instance protocol:

 leftTextView

 numberOfChanges

 rightTextView

 text1: t1 text2: t2

 moveToLine: aLineNr

 moveToNextChanged

 moveToNextChangedAfter: startLine

find the first line which is not a plain string

 moveToPreviousChanged

 addNextPreviousButtons

set up-down buttons

Examples:

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'