"

 COPYRIGHT (c) 1997 by eXept Software AG

              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:libwidg2' }"

Model subclass:#TabItem

	instanceVariableNames:'rawLabel label enabled argument canvas adornments activeHelpText'

	classVariableNames:''

	poolDictionaries:''

	category:'Views-Support'

!

!TabItem class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 1997 by eXept Software AG

              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

"

    describes one tab entry; could be used for tabs instead of a string. Whenever

    a value changed, a change notification is raised

    [see also:]

        TabItemEditor

        TabView

        NoteBookView

        UIPainter

    [author:]

        Claus Atzkern

"

!

examples

"

    labels derived from item

                                                                                [exBegin]                                      

    |top tab|

    top := StandardSystemView new label:'tabs at top'; extent:250@100.

    tab  := TabView origin:0.0 @ 0.0 corner:1.0 @ 0.5 in:top.

    tab direction:#top.

    tab list:(#( 'Foo' 'Bar' 'Baz' ) collect:[:l| TabItem label:l ]).

    tab action:[:aName|Transcript showCR:aName].

    top open.

                                                                                [exEnd]

    testing tab configuration and change notifications

                                                                                [exBegin]                                      

    |top tab list idx label|

    top := StandardSystemView new label:'tabs at top'; extent:250@100.

    tab  := TabView origin:0.0 @ 0.0 corner:1.0 @ 0.5 in:top.

    tab direction:#top.

    list := (#( 'Foo' 'Bar' 'Baz' ) collect:[:l| TabItem label:l ]).

    tab list:list.

    tab action:[:aName|Transcript showCR:aName].

    top openAndWait.

    [

        idx := 0.

        label := LabelAndIcon icon:(Image fromFile:('xpmBitmaps/document_images/tiny_yellow_dir.xpm' ))

                            string:'Test Tab'.

        [top shown] whileTrue:[

            |aTab lbl|

            (idx := idx + 1) > list size ifTrue:[idx := 1].

            aTab := list at:idx.

            lbl  := aTab label.

            Delay waitForSeconds:0.5. aTab label:label.

            Delay waitForSeconds:0.5. aTab enabled:false.

            Delay waitForSeconds:0.5. aTab enabled:true.

            Delay waitForSeconds:0.5. aTab foregroundColor:(Color red).

            Delay waitForSeconds:0.5. aTab foregroundColor:nil.

            aTab label:lbl.

        ]

    ] forkAt:1.

                                                                                [exEnd]

"

! !

!TabItem class methodsFor:'instance creation'!

label:aLabel

    ^ self new label:aLabel

!

new

    ^ self basicNew initialize

! !

!TabItem class methodsFor:'tests'!

test

    |top tab list item|

    top := StandardSystemView new label:'tabs at top'; extent:400@400.

    tab  := NoteBookView origin:0.0 @ 0.0 corner:1.0 @ 1.0 in:top.

    tab direction:#top.

    list := #( 'Foo' 'Bar' 'Baz' ) collect:[:l| TabItem label:l ].

    item := list at:1.

    item majorKey:ClockView.

    item := list at:2.

    item majorKey:CodingExamples_GUI::GUIDemoNoteBook.

    item := list at:3.

    item majorKey:CodingExamples_GUI::GUIDemoMenu.

    tab list:list.

    top open.

! !

!TabItem methodsFor:'accessing'!

accessCharacterPosition

    "get the index of the access character in the label text or string, or 0 if none

    "

    ^ self adornmentAt:#accessCharacterPosition ifAbsent:0

!

accessCharacterPosition:anIndex

    "get the index of the access character in the label text or string, or 0 if none

    "

    |idx|

    anIndex ~~ 0 ifTrue:[

        idx := anIndex

    ].

    self adornmentAt:#accessCharacterPosition put:idx

!

argument

    "returns a user defined argument or nil

    "

    ^ argument

!

argument:anArgument

    "set a user defined argument

    "

    (anArgument isString and:[anArgument isEmpty]) ifTrue:[

        argument := nil

    ] ifFalse:[

        argument := anArgument

    ].

    argument := anArgument

!

createNewBuilder

    "returns true if a new builder is used to create the canvas;

     the default is true

    "

    ^ self adornmentAt:#createNewBuilder ifAbsent:true

!

createNewBuilder:aBool

    "returns true if a new builder is used to create the canvas;

     the default is true

    "

    |flag|

    aBool == false ifTrue:[

        flag := false

    ].

    ^ self adornmentAt:#createNewBuilder put:flag

!

enabled

    "get the enabled state of the tab

    "

    ^ enabled ? true

!

enabled:aState

    "set the enabled state of the tab

    "

    |s|

    s := aState ? true.

    self enabled ~~ s ifTrue:[

        enabled := s.

        self changed:#enabled

    ]

!

foregroundColor

    "get the label color or nil

    "

    ^ self adornmentAt:#foregroundColor

!

foregroundColor:aColor

    "set the label color or nil

    "

    self foregroundColor ~= aColor ifTrue:[

        self adornmentAt:#foregroundColor put:aColor.

        self changed:#foregroundColor

    ].

!

label

    "get the label or selector to access a label/bitmap. To get the label to be shown

     use: #rawLabel

    "

    ^ label

!

label:aLabel

    "set the label or selector to access the label/bitmap

    "

    label := aLabel.

    (aLabel ~= rawLabel

    or:[aLabel isString 

        and:[rawLabel isString

        and:[(aLabel sameStringAndEmphasisAs:rawLabel) not]]])

    ifTrue:[

        rawLabel := aLabel.

        self changed

    ]

!

labelForegroundColor

    "get the label color or nil

    "

    ^ self foregroundColor

!

labelForegroundColor:aColor

    "set the label color or nil

    "

    self foregroundColor:aColor

!

shortcutKey

    "get the key to press to select the tab item from the keyboard; a symbol or nil

    "

    ^ self adornmentAt:#shortcutKey

!

shortcutKey:aKeyOrNil

    "set the key to press to select the tab item from the keyboard; a symbol or nil

    "

    |key|

    aKeyOrNil size ~~ 0 ifTrue:[

        key := aKeyOrNil asSymbol

    ].

    self adornmentAt:#shortcutKey put:key

! !

!TabItem methodsFor:'accessing-canvas'!

canvas

    "returns the application or nil

    "

    |view cls wsel ckey builder appl|

    canvas notNil ifTrue:[

        ^ canvas

    ].

    (ckey := self majorKey) notNil ifTrue:[

        builder := self adornmentAt:#builder.

        (appl := builder application) notNil ifTrue:[

            (cls := appl resolveName:ckey) isNil ifTrue:[

                canvas := appl perform:ckey ifNotUnderstood:nil

            ]

        ] ifFalse:[

            cls := Smalltalk resolveName:ckey inClass:self class.

        ].

        canvas isNil ifTrue:[

            cls isNil ifTrue:[

                self majorKey:nil.

              ^ nil

            ].

            canvas := cls new.

        ].

        (canvas isKindOf:ApplicationModel) ifTrue:[

            view := SimpleView new.

            wsel := self minorKey ? #windowSpec.

            canvas builder notNil ifTrue:[

                builder := canvas builder

            ] ifFalse:[

                builder isNil ifTrue:[

                    builder := canvas createBuilder.

                ] ifFalse:[

                    canvas builder:builder.

                ].

            ].

            (appl notNil and:[canvas masterApplication isNil]) ifTrue:[

                canvas masterApplication:appl

            ].

            self createNewBuilder ifTrue:[

                "/ set the application to the new application

                builder application:canvas

            ].

            view client:canvas spec:wsel builder:builder.

            canvas window:(self setupCanvasView:view).

        ] ifFalse:[

            canvas := self setupCanvasView:canvas

        ]

    ].

    ^ canvas

!

canvasView

    "returns the view the canvas is running in or nil if no canvas

     specified or not yet created

    "

    |canvas|

    (canvas := self canvas) notNil ifTrue:[

        ^ canvas perform:#window ifNotUnderstood:[canvas]

    ].

    ^ nil

!

destroyCanvas

    canvas notNil ifTrue:[

        self canvasView destroy.

        canvas := nil

    ].

!

majorKey

    ^ self adornmentAt:#majorKey

!

majorKey:aMajorKey

    |key|

    aMajorKey notNil ifTrue:[

        aMajorKey isBehavior ifTrue:[

            key := aMajorKey name asSymbol

        ] ifFalse:[

            aMajorKey size ~~ 0 ifTrue:[

                key := aMajorKey asSymbol

            ]

        ]

    ].

    self majorKey ~~ key ifTrue:[

        self destroyCanvas

    ].

    self adornmentAt:#majorKey put:key.

!

minorKey

    ^ self adornmentAt:#minorKey

!

minorKey:aMinorKey

    self adornmentAt:#minorKey put:aMinorKey.

!

setupCanvasView:aView

    |frame isV isH auto|

    isH := self hasHorizontalScrollBar.

    isV := self hasVerticalScrollBar.

    (isH or:[isV]) ifFalse:[

        frame := aView

    ] ifTrue:[

        frame := ScrollableView for:ViewScroller.

        frame horizontalScrollable:isH.

        frame verticalScrollable:isV.

        isH ifTrue:[frame horizontalMini:(self miniScrollerHorizontal)].

        isV ifTrue:[frame verticalMini:(self miniScrollerVertical)].

        (auto := self autoHideScrollBars) notNil ifTrue:[

            frame autoHideScrollBars:auto

        ].

        frame scrolledView scrolledView:aView.

    ].

    frame objectAttributeAt:#isTabItem put:true.

  ^ frame

! !

!TabItem methodsFor:'accessing-scrollbars'!

autoHideScrollBars

    ^ self adornmentAt:#autoHideScrollBars

!

autoHideScrollBars:aBoolOrNil

    self adornmentAt:#autoHideScrollBars put:aBoolOrNil

!

hasHorizontalScrollBar

    ^ self adornmentAt:#hasHorizontalScrollBar ifAbsent:false

!

hasHorizontalScrollBar:aBool

    |flag|

    aBool == true ifTrue:[flag := true]

                 ifFalse:[self miniScrollerHorizontal:false].

    self adornmentAt:#hasHorizontalScrollBar put:flag

!

hasVerticalScrollBar

    ^ self adornmentAt:#hasVerticalScrollBar ifAbsent:false

!

hasVerticalScrollBar:aBool

    |flag|

    aBool == true ifTrue:[flag := true]

                 ifFalse:[self miniScrollerVertical:false].

    self adornmentAt:#hasVerticalScrollBar put:flag

!

miniScrollerHorizontal

    ^ self adornmentAt:#miniScrollerHorizontal ifAbsent:false

!

miniScrollerHorizontal:aBool

    |flag|

    aBool == true ifTrue:[

        flag := true

    ].

    self adornmentAt:#miniScrollerHorizontal put:flag

!

miniScrollerVertical

    ^ self adornmentAt:#miniScrollerVertical ifAbsent:false

!

miniScrollerVertical:aBool

    |flag|

    aBool == true ifTrue:[

        flag := true

    ].

    self adornmentAt:#miniScrollerVertical put:flag

! !

!TabItem methodsFor:'building'!

editAgument

    "used by TabItemEditor to get the argument

    "

    ^ argument isSymbol ifTrue:['#', argument] ifFalse:[argument]