Class: EnterBox2

• Inheritance
• Description
• Related information
• Class protocol
  • instance creation
• Instance protocol
  • accessing
  • initialization
  • user interaction

Inheritance:

   Object
   |
   +--GraphicsMedium
      |
      +--DisplaySurface
         |
         +--SimpleView
            |
            +--View
               |
               +--TopView
                  |
                  +--StandardSystemView
                     |
                     +--ModalBox
                        |
                        +--DialogBox
                           |
                           +--EnterBox
                              |
                              +--EnterBox2

Package:

stx:libwidg

Category:

Views-DialogBoxes

Version:

rev: 1.28 date: 2016/10/06 21:14:32

user: mawalch

file: EnterBox2.st directory: libwidg

module: stx stc-classLibrary: libwidg

Author:

Claus Gittinger

Description:

Historic note:
     originally, ST/X had separate classes for the various entry methods;
     there were YesNoBox, EnterBox, InfoBox and so on.
     In the meantime, the DialogBox class (and therefore its alias: Dialog)
     is going to duplicate most functionality found in these classes.

     In the future, those existing subclasses' functionality is going to
     be moved fully into Dialog, and the subclasses will be replaced by dummy
     delegators. (They will be kept for backward compatibility, though).

 An EnterBox2 is like an EnterBox but with 2 action buttons.
 This is used (for example) in the search-boxes, where two ok-buttons
 'find-previous' and 'find-next' are needed in addition to the abort button.
 The protocol is like that of EnterBox, the additional buttons label
 can be set with 'okText2:aString' and its action with 'action2:aBlock'.

Related information:

    DialogBox
    EnterBox
    YesNoBox
    ListSelectionBox
    FileSelectionBox
    FileSaveBox

Class protocol:

 title: titleString okText1: text1 okText2: text2 abortText: abortText action1: block1 action2: block2

create and return a new EnterBox-with-2 buttons
and define its text, button-labels and actions

Instance protocol:

 action2: aBlock

set the action to be performed when user presses the 2nd ok-button;
aBlock must be nil or a block with one argument

 okText2: aString

set the text to be displayed in the 2nd ok-button

 okText2: aString action2: aBlock

set the text to be displayed in the 2nd ok-button,
and its action

 initialize

add a second ok-button (a return button)

 keyPress: aKey x: x y: y

return-key duplicates ok-function if acceptReturnAsOK is true

 ok2Pressed

user pressed 2nd ok button - evaluate action