"

 COPYRIGHT (c) 1990 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

"{ Package: 'stx:libwidg' }"

EnterBox subclass:#ListSelectionBox

	instanceVariableNames:'selectionList selectionChangeCallback'

	classVariableNames:''

	poolDictionaries:''

	category:'Views-DialogBoxes'

!

!ListSelectionBox class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 1990 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

!

documentation

"

    this class implements boxes for selection from a list. It offers

    both an ok- and abort-buttons. The ok-button, if pressed will

    evaluate the okAction (see EnterBox>>action).

    see examples for typical uses.

    Notice, for file selections there is a specialized FileSelectionBox,

    which supports matchPatterns, changing directory etc.

    [author:]

        Claus Gittinger

"

!

examples 

"

    simple:

                                                                        [exBegin]

        |box|

        box := ListSelectionBox new.

        box title:'select something:'.

        box list:#('foo' 'bar' 'baz').

        box okAction:[:sel | Transcript showCR:'the selection was:' , sel].

        box showAtPointer

                                                                        [exEnd]

    with a default:

                                                                        [exBegin]

        |box|

        box := ListSelectionBox new.

        box title:'select something:'.

        box list:#('foo' 'bar' 'baz').

        box okAction:[:sel | Transcript showCR:'the selection was:' , sel].

        box initialText:'foo'.

        box showAtPointer

                                                                        [exEnd]

    opening the box modeless (a stand-by box):

    (in this case, the default ok- and abortActions do not hide the box;

     therefore, we have to set those explicitely)

                                                                        [exBegin]

        |box|

        box := ListSelectionBox new.

        box title:'select something:'.

        box list:#('foo' 'bar' 'baz').

        box abortText:'close'.

        box okText:'apply'.

        box okAction:[:sel | Transcript showCR:'the selection was:' , sel].

        box abortAction:[:dummy | box hide].

        box openModeless

                                                                        [exEnd]

    showing fileNames:

                                                                        [exBegin]

        |box|

        box := ListSelectionBox new.

        box title:'select something:'.

        box list:('.' asFilename directoryContents).

        box okAction:[:sel | Transcript showCR:'the selection was:' , sel].

        box showAtPointer

                                                                        [exEnd]

"

! !

!ListSelectionBox class methodsFor:'instance creation'!

title:titleString okText:okText abortText:abortText list:aList action:aBlock

    "create and return a new listSelectionBox with list already defined"

    |newBox|

    newBox := super title:titleString okText:okText abortText:abortText

		    action:aBlock.

    ^ newBox list:aList

! !

!ListSelectionBox class methodsFor:'defaults'!

defaultExtent

    "return the default extent of my instances.

     The value returned here is usually ignored, and

     the value from preferredExtent taken instead."

    ^ (Screen current pixelPerMillimeter * (80 @ 100)) rounded

    "Modified: 5.7.1996 / 13:53:46 / cg"

!

listViewType

    "return the type of listView 

     - for easier redefinition in subclasses"

    ^ SelectionInListView

! !

!ListSelectionBox methodsFor:'accessing'!

contents

    "return my contents"

    enterField isNil ifTrue:[

        ^ selectionList selectionValue

    ].

    ^ super contents

    "Created: 26.2.1996 / 20:05:47 / cg"

!

initialText:someString

    "in addition to showing the initial text, also select it in the list"

    super initialText:someString.

    selectionList setSelectElement:someString.

    "Modified: 26.5.1996 / 15:03:37 / cg"

!

list:aList

    "set the list to be displayed in selection list"

    selectionList list:aList

!

selectionChangeCallback:aBlock

    "allows special actions to be hooked in, whe nthe selection changes"

    selectionChangeCallback := aBlock.

!

selectionIndex

    ^ selectionList selection

    "Created: 14.10.1996 / 16:28:50 / cg"

! !

!ListSelectionBox methodsFor:'accessing-components'!

listView

    "return the listView component"

    ^ selectionList

    "Created: 26.10.1995 / 17:08:32 / cg"

! !

!ListSelectionBox methodsFor:'accessing-look'!

noEnterField

    "suppress the enterField - now only existing items are selectable;

     the default is to present an enterField."

    enterField destroy.

    enterField := nil

    "Created: 26.10.1995 / 17:12:38 / cg"

    "Modified: 12.5.1996 / 21:49:14 / cg"

! !

!ListSelectionBox methodsFor:'initialization'!

initialize

    |space2 halfSpace v vbw|

    super initialize.

    label := resources string:'Select or enter'.

    "need more space than an enterBox"

    "self height:(height + (font height * 5)).  "

    space2 := 2 * ViewSpacing.

    halfSpace := ViewSpacing // 2.

"/ old:

"/    v origin:[0.0

"/              @

"/              (enterField origin y + enterField height + ViewSpacing)]

"/      extent:[1.0

"/              @ 

"/              (height

"/               - ViewSpacing - labelField heightIncludingBorder

"/               - ViewSpacing - enterField heightIncludingBorder

"/               - buttonPanel heightIncludingBorder - ViewSpacing

"/               - space2)

"/             ].

"/ new:

    v origin:[enterField notNil ifTrue:[

                0.0 @ (enterField origin y + enterField height + ViewSpacing)

              ] ifFalse:[

                0.0 @ (labelField origin y + labelField height + ViewSpacing)

              ]

             ]

      corner:(1.0 @ 1.0).

    v bottomInset:(buttonPanel preferredExtent y + ViewSpacing).

    vbw := v borderWidth.

    v leftInset:halfSpace+vbw;

      rightInset:halfSpace+vbw.

    selectionList := v scrolledView.

    self makeTabable:selectionList.

    "self updateList."

    "I am interested in what is done in the selectionList

     (could also create a SelectionInList-model and catch its changes ...)"

    selectionList action:[:lineNr | self selectionChanged].

    selectionList doubleClickAction:[:lineNr | self doubleClick].

    enterField removeDependent:self. "dont want preferredExtent-changes"

    enterField immediateAccept:true.

    enterField acceptAction:

                    [:text | |string index|

                        enterField notNil ifTrue:[

                            string := enterField contents.

                            "/ find the first list-entry, starting with entered text

                            index := (selectionList list ? #()) findFirst:[:line | line string startsWith:string string].

                            index ~~ 0 ifTrue:[

                                selectionList makeLineVisible:index.

                            ].

                        ].

                    ].

    "

     mhm: the lists keyboard functions are disabled,

     and input passed to the enterfield (except cursor keys)

    "

    selectionList delegate:(

        KeyboardForwarder 

            toView:enterField 

            condition:#noFocus

            filter:[:key | (key ~~ #CursorUp) and:[key ~~ #CursorDown]]

        )

    "Modified: 31.5.1996 / 22:02:33 / cg"

!

postRealize

    "update the list now.

     This was not done in #initialize to allow settings to be changed before,

     in case list-updating is a slow operation - such as reading a directory"

    super postRealize.

    self updateList.

    "Modified: 12.5.1996 / 21:50:50 / cg"

    "Created: 24.7.1997 / 18:22:19 / cg"

!

updateList

    "setup contents of list; 

     nothing done here but typically redefined in subclasses."

    ^ self

    "Modified: 12.5.1996 / 21:51:10 / cg"

! !

!ListSelectionBox methodsFor:'queries'!

preferredExtent

    "return my preferred extent - thats the minimum size 

     I like to have, to make everything visible"

    |wWanted hWanted eH mm|

    "/ If I have an explicit preferredExtent ..

    preferredExtent notNil ifTrue:[

        ^ preferredExtent

    ].

    mm := ViewSpacing.

    wWanted := mm + labelField width + mm.

    (wWanted > width) ifFalse:[

        wWanted := width

    ].

    enterField notNil ifTrue:[

        eH := enterField height + mm

    ] ifFalse:[

        eH := 0

    ].

    hWanted := mm + labelField height +

               eH +

               mm + selectionList height +

               mm + buttonPanel preferredExtent y +

               mm - (mm * 2).

    (hWanted < height) ifTrue:[

        hWanted := height

    ].

    ^ (wWanted @ hWanted)

    "Modified: 19.7.1996 / 20:44:52 / cg"

! !

!ListSelectionBox methodsFor:'user actions'!

doubleClick

    "doubleClick on an entry is select & ok"

    enterField notNil ifTrue:[

        enterField contents:(selectionList selectionValue).

    ].

    self okPressed

    "Modified: 26.2.1996 / 20:05:45 / cg"

!

selectionChanged

    "selections in list get forwarded to enterfield"

    enterField notNil ifTrue:[

        enterField contents:(selectionList selectionValue)

    ].

    selectionChangeCallback notNil ifTrue:[

        selectionChangeCallback value:selectionList selection

    ].

    "Modified: 26.10.1995 / 17:20:06 / cg"

! !

!ListSelectionBox class methodsFor:'documentation'!

version

! !