"

 COPYRIGHT (c) 1989 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.

"

PanelView subclass:#VerticalPanelView

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	category:'Views-Layout'

!

copyright

"

 COPYRIGHT (c) 1989 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

"

    a View which arranges its child-views in a vertical column.

    All real work is done in PanelView - except the layout computation is

    redefined here.

    The layout is controlled by the instance variables: 

        horizontalLayout and verticalLayout

    in addition to 

        horizontalSpace and verticalSpace.

    The vertical layout can be any of:

        #top            arrange elements at the top

        #topSpace       arrange elements at the top, start with spacing

        #bottom         arrange elements at the bottom

        #bottomSpace    arrange elements at the bottom, start with spacing

        #center         arrange elements in the center; ignore verticalSpace

        #spread         spread elements evenly; ignore verticalSpace

        #spreadSpace    spread elements evenly with spacing at ends; ignore verticalSpace

        #fit            like #spread, but resize elements for tight packing; ignore verticalSpace

        #fitSpace       like #fit, with spacing; ignore verticalSpace

        #topFit         like #top, but extend the last element to the bottom

        #topSpaceFit    like #topSpace, but extend the last element to the bottom

    the horizontal layout can be:

        #left           place element at the left

        #leftSpace      place element at the left, offset by horizontalSpace

        #center         place elements horizontally centered; ignore horizontalSpace

        #right          place it at the right

        #rightSpace     place it at the right, offset by horizontalSpace

        #fit            resize elements horizontally to fit this panel; ignore horizontalSpace

        #fitSpace       like #fit, but add spacing; ignore horizontalSpace

        #leftMax        like #left, but resize elements to max of them

        #leftSpaceMax   like #leftSpace, but resize elements

        #centerMax      like #center, but resize elements

        #rightMax       like #right, but resize elements to max of them

        #rightSpaceMax  like #rightSpace, but resize elements

    The defaults is #center for both directions.

    The layout is changed by the messages #verticalLayout: and #horizontalLayout:.

    For backward compatibility (to times, where only vLayout existed), the simple

    #layout: does the same as #verticalLayout:. Do not use this old method.

    The panel assumes, that the elements do not resize themselfes, after it

    became visible. This is not true for all widgets (buttons or labels may

    like to change). If you have changing elements, tell this to the panel

    with 'aPanel elementsChangeSize:true'. In that case, the panel will react

    to size changes, and reorganize things.

    If none of these layout/space combinations is exactly what you need in

    your application, create a subclass, and redefine the setChildPositions method.

    CAVEAT: this class started with #top and no horizontal alignments;

    as time went by, more layouts were added and the setup should be changed

    to use different selectors for space, max-resize and alignment

    (i.e. having more and more layout symbols makes things a bit confusing ...)

    [see also:]

        HorizontalPanelView

        VariableVerticalPanel VariableHorizontalPanel

        Label

    [author:]

        Claus Gittinger

"

!

examples

"

    These examples demonstrate the effect of different layout

    settings.

    You should try more examples, combining spacing and different

    verticalLayout:/horizontalLayout: combinations.

    example: default layout (centered)

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'center (default)'.

        p := VerticalPanelView in:v.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'b2' in:p.

        b3 := Button label:'butt3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: horizontal centerMax

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'hL=centerMax'.

        p := VerticalPanelView in:v.

        p horizontalLayout:#centerMax.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'b2' in:p.

        b3 := Button label:'butt3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: horizontal leftMax

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'hL=leftMax'.

        p := VerticalPanelView in:v.

        p horizontalLayout:#leftMax.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'b2' in:p.

        b3 := Button label:'butt3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: horizontal leftSpaceMax

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'hL=leftMax'.

        p := VerticalPanelView in:v.

        p horizontalLayout:#leftSpaceMax.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'b2' in:p.

        b3 := Button label:'butt3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: horizontal rightMax

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'hL=rightMax'.

        p := VerticalPanelView in:v.

        p horizontalLayout:#rightMax.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'b2' in:p.

        b3 := Button label:'butt3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: horizontal rightSpaceMax

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'hL=rightMaxSpace'.

        p := VerticalPanelView in:v.

        p horizontalLayout:#rightSpaceMax.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'b2' in:p.

        b3 := Button label:'butt3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: top-layout

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=top; hL=center (default)'.

        p := VerticalPanelView in:v.

        p verticalLayout:#top.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: topSpace-layout

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=topSpace; hL=center (default)'.

        p := VerticalPanelView in:v.

        p verticalLayout:#topSpace.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: top-layout; horizontal fit

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        p := VerticalPanelView in:v.

        v label:'vL=top; hL=fit'.

        p verticalLayout:#top.

        p horizontalLayout:#fit.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: top-layout; horizontal fit with space

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=top; hL=fitSpace'.

        p := VerticalPanelView in:v.

        p verticalLayout:#top.

        p horizontalLayout:#fitSpace.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: topSpace-layout; horizontal fit with space

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=topSpace; hL=fitSpace'.

        p := VerticalPanelView in:v.

        p verticalLayout:#topSpace.

        p horizontalLayout:#fitSpace.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: bottom-layout

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=bottom; hL=center (default)'.

        p := VerticalPanelView in:v.

        p verticalLayout:#bottom.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: bottomSpace-layout

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=bottomSpace; hL=center (default)'.

        p := VerticalPanelView in:v.

        p verticalLayout:#bottomSpace.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: topFit-layout

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=topFit; hL=center (default)'.

        p := VerticalPanelView in:v.

        p verticalLayout:#topFit.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: topSpaceFit-layout; combined with horizontal #fitSpace

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=topFit; hL=center (default)'.

        p := VerticalPanelView in:v.

        p verticalLayout:#topSpaceFit.

        p horizontalLayout:#fitSpace.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: spread-layout

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=spread; hL=center (default)'.

        p := VerticalPanelView in:v.

        p verticalLayout:#spread.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: spreadSpace-layout

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=spreadSpace; hL=center (default)'.

        p := VerticalPanelView in:v.

        p verticalLayout:#spreadSpace.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: fit-layout

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=fit; hL=center (default)'.

        p := VerticalPanelView in:v.

        p verticalLayout:#fit.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: fitSpace-layout

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=fitSpace; hL=center (default)'.

        p := VerticalPanelView in:v.

        p verticalLayout:#fitSpace.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: fully fitSpace

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=fitSpace; hL=fitSpace'.

        p := VerticalPanelView in:v.

        p verticalLayout:#fitSpace.

        p horizontalLayout:#fitSpace.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: combine fully fitSpace with scaling button labels

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=fitSpace; hL=fitSpace'.

        p := VerticalPanelView in:v.

        p verticalLayout:#fitSpace.

        p horizontalLayout:#fitSpace.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b1 adjust:#fit.

        b2 := Button label:'butt2' in:p.

        b2 adjust:#fit.

        b3 := Button label:'button3' in:p.

        b3 adjust:#fit.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: from top, each at left:

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=top; hL=left'.

        p := VerticalPanelView in:v.

        p verticalLayout:#top.

        p horizontalLayout:#left.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.

        b2 := Button label:'butt2' in:p.

        b3 := Button label:'button3' in:p.

        v extent:100 @ 300.

        v open

                                                                        [exEnd]

    example: center, right:

                                                                        [exBegin]

        |v p b1 b2 b3|

        v := StandardSystemView new.

        v label:'vL=center; hL=right'.

        p := VerticalPanelView in:v.

        p verticalLayout:#center.

        p horizontalLayout:#right.

        p origin:(0.0 @ 0.0) corner:(1.0 @ 1.0).

        b1 := Button label:'button1' in:p.