"
COPYRIGHT (c) 1995 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.
"
HorizontalPanelView subclass:#CheckBox
instanceVariableNames:'toggleView labelView labelForegroundColor
disabledLabelForegroundColor'
classVariableNames:'DefaultLabelForegroundColor DefaultDisabledLabelForegroundColor'
poolDictionaries:''
category:'Views-Interactors'
!
!CheckBox class methodsFor:'documentation'!
copyright
"
COPYRIGHT (c) 1995 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
"
CheckBox has been added somwehat in a hurry
- obviously, much more protocol is needed.
For now, set actions etc. via sends to the components,
labelView and toggleView.
"
!
examples
"
no-op checkBox:
|b|
b := CheckBox new.
b label:'foo'.
b open
no-op checkBox, disabled:
|b|
b := CheckBox new.
b label:'foo'.
b disable.
b open
changing colors
(a demo only: it is no good style to fight the styleSheet):
|panel b|
panel := VerticalPanelView new.
b := CheckBox in:panel.
b label:'foo'.
b := CheckBox in:panel.
b label:'bar'.
b labelView foregroundColor:Color red.
b := CheckBox in:panel.
b label:'baz'.
b toggleView activeForegroundColor:Color blue.
panel open
using action-blocks:
|b|
b := CheckBox new.
b label:'check'.
b action:[:value | Transcript show:'set to: '; showCr:value].
b open.
with a model (default ST-80 behavior, sending #value: to the model):
(see changing value in the inspector)
|b model|
model := ValueHolder newBoolean.
b := CheckBox new.
b label:'check'.
b model:model.
b open.
model inspect.
with a model and different changeSelector
(using a plug here, for demonstration only):
|b model|
model := Plug new.
model respondTo:#changeCheck: with:[:arg | Transcript showCr:'change to ' , arg printString].
b := CheckBox new.
b label:'check'.
b model:model; changeMessage:#changeCheck:.
b open.
with a model and an enableChannel
|b enaToggle enaHolder|
enaHolder := true asValue.
enaToggle := Toggle label:'enable'.
enaToggle model:enaHolder.
enaToggle open.
b := CheckBox new.
b label:'check'.
b action:[:value | Transcript show:'set to: '; showCr:value].
b enableChannel:enaHolder.
b open.
with models, one checkBox disabling the others:
|dialog translator enableChannel val1 val2 val3 eBox box1 box2 box3|
translator := Plug new.
translator respondTo:#enableDisable
with:[
enableChannel value
ifTrue:[
box1 enable.
box2 enable.
box3 enable.
]
ifFalse:[
box1 disable.
box2 disable.
box3 disable.
]
].
enableChannel := true asValue.
enableChannel onChangeSend:#enableDisable to:translator.
val1 := true asValue.
val2 := false asValue.
val3 := true asValue.
dialog := Dialog new.
dialog addCheckBox:'enable' on:enableChannel.
dialog addVerticalSpace.
dialog leftIndent:30.
box1 := dialog addCheckBox:'value1' on:val1.
dialog addVerticalSpace.
box2 := dialog addCheckBox:'value2' on:val2.
dialog addVerticalSpace.
box3 := dialog addCheckBox:'value3' on:val3.
dialog addVerticalSpace.
dialog addOkButton.
dialog open.
multiple checkBoxes on a single model (using different aspects)
|top panel b model value1 value2|
value1 := true.
value2 := false.
model := Plug new.
model respondTo:#value1 with:[value1].
model respondTo:#value1: with:[:val | value1 := val].
model respondTo:#value2 with:[value2].
model respondTo:#value2: with:[:val | value2 := val].
top := DialogBox new.
top extent:200@300.
panel := VerticalPanelView new.
b := CheckBox in:panel.
b label:'check1'.
b model:model; aspect:#value1; changeMessage:#value1:.
b := CheckBox in:panel.
b label:'check2'.
b model:model; aspect:#value2; changeMessage:#value2:.
top addComponent:panel.
top addAbortButton; addOkButton.
top openModal.
top accepted ifTrue:[
Transcript show:'value1: '; showCr:model value1.
Transcript show:'value2: '; showCr:model value2.
]
"
! !
!CheckBox class methodsFor:'instance creation'!
label:aStringOrImage model:aModel
"create & return a new checkBox, on aModel (typically a ValueHolder),
with aStringOrImage as label."
^ (self new model:aModel) label:aStringOrImage
"Created: 17.9.1995 / 14:20:58 / claus"
!
model:aModel
"create & return a new checkBox, on aModel (typically a ValueHolder)"
^ self new model:aModel
! !
!CheckBox class methodsFor:'defaults'!
updateStyleCache
"extract values from the styleSheet and cache them in class variables"
<resource: #style (#checkBoxLabelForegroundColor
#checkBoxDisabledLabelForegroundColor)>
DefaultLabelForegroundColor := StyleSheet colorAt:'checkBoxLabelForegroundColor'.
DefaultDisabledLabelForegroundColor := StyleSheet colorAt:'checkBoxDisabledLabelForegroundColor'.
"
self updateStyleCache
"
"Created: 14.12.1995 / 14:47:22 / cg"
"Modified: 1.3.1996 / 13:45:47 / cg"
! !
!CheckBox methodsFor:'accessing'!
labelView
"return the labelView; allows manipulation of the
labels attributes (colors etc.)"
^ labelView
!
toggleView
"return the toggleView; allows manipulation of the
toggles attributes (colors etc.)"
^ toggleView
! !
!CheckBox methodsFor:'accessing-behavior'!
action:aBlock
"forward to toggle"
toggleView action:aBlock
!
disable
"forward to toggle & change labels color"
|clr|
toggleView disable.
clr := disabledLabelForegroundColor.
clr isNil ifTrue:[ clr := toggleView disabledForegroundColor ].
labelView foregroundColor:clr.
"Modified: 14.12.1995 / 14:50:54 / cg"
!
enable
"forward to toggle & change labels color"
|clr|
toggleView enable.
clr := labelForegroundColor.
clr isNil ifTrue:[ clr := toggleView foregroundColor ].
labelView foregroundColor:clr.
"Modified: 14.12.1995 / 14:51:19 / cg"
!
pressAction:aBlock
toggleView pressAction:aBlock.
"Created: 22.9.1995 / 15:54:04 / claus"
!
releaseAction:aBlock
toggleView releaseAction:aBlock.
"Created: 22.9.1995 / 15:54:11 / claus"
!
turnOff
"forward to toggle"
toggleView turnOff
!
turnOn
"forward to toggle"
toggleView turnOn
! !
!CheckBox methodsFor:'accessing-channels'!
enableChannel:aChannel
|wasEnabled|
wasEnabled := toggleView enabled.
toggleView enableChannel:aChannel.
aChannel onChangeSend:#enableStateChanged to:self.
aChannel value ~~ wasEnabled ifTrue:[
self enableStateChanged
]
"Created: 17.12.1995 / 16:07:59 / cg"
"Modified: 24.1.1996 / 20:17:24 / cg"
! !
!CheckBox methodsFor:'accessing-look'!
activeLogo:anImageOrString
toggleView activeLogo:anImageOrString
"Created: 22.9.1995 / 15:44:08 / claus"
!
disabledLabelForegroundColor
disabledLabelForegroundColor isNil ifTrue:[ ^ toggleView disabledForegroundColor ].
^ disabledLabelForegroundColor
"Created: 16.12.1995 / 19:47:45 / cg"
"Modified: 16.12.1995 / 19:56:41 / cg"
!
font
"forward from label"
^ labelView font
!
font:aFont
"forward to label & resize"
labelView font:aFont.
labelView forceResize.
self layoutChanged.
self resize.
!
label
"forward from label"
^ labelView label
!
label:aString
"forward to label & resize"
labelView label:aString.
labelView forceResize.
self layoutChanged.
self resize.
!
labelForegroundColor
labelForegroundColor isNil ifTrue:[ ^ toggleView foregroundColor ].
^ labelForegroundColor
"Created: 16.12.1995 / 19:47:20 / cg"
"Modified: 16.12.1995 / 19:56:57 / cg"
!
passiveLogo:anImageOrString
toggleView passiveLogo:anImageOrString
"Created: 22.9.1995 / 15:44:14 / claus"
! !
!CheckBox methodsFor:'accessing-mvc'!
aspectMessage:aspectSymbol
"forward to label & toggle"
labelView aspectMessage:aspectSymbol.
toggleView aspectMessage:aspectSymbol
!
changeMessage:aChangeSelector
"forward to toggle"
toggleView changeMessage:aChangeSelector
!
model:aModel
"forward to label & toggle"
labelView model:aModel.
toggleView model:aModel
! !
!CheckBox methodsFor:'accessing-state'!
isOn
^ toggleView isOn
! !
!CheckBox methodsFor:'change & update'!
enableStateChanged
|clr|
toggleView enabled ifTrue:[
clr := self labelForegroundColor
] ifFalse:[
clr := self disabledLabelForegroundColor
].
labelView foregroundColor:clr
"Modified: 24.1.1996 / 20:04:34 / cg"
! !
!CheckBox methodsFor:'initialization'!
initStyle
super initStyle.
DefaultLabelForegroundColor notNil ifTrue:[
labelForegroundColor := DefaultLabelForegroundColor on:device.
].
DefaultDisabledLabelForegroundColor notNil ifTrue:[
disabledLabelForegroundColor := DefaultDisabledLabelForegroundColor on:device.
].
"Created: 14.12.1995 / 14:50:03 / cg"
!
initialize
super initialize.
borderWidth := 0.
hLayout := #fixLeftSpace.
vLayout := #center.
toggleView := CheckToggle in:self.
labelView := Label in:self.
labelView label:'check'; borderWidth:0.
labelView forceResize.
labelView adjust:#left.
self height:labelView preferredExtent y + ViewSpacing.
"
all of my input goes to the toggle
"
self delegate:(KeyboardForwarder toView:toggleView).
"
|b|
b := CheckBox new.
b label:'foo'.
b open
"
! !
!CheckBox methodsFor:'private'!
sendChangeMessageWith:aValue
"redefined to have mimic changes being sent from the toggle
instead of myself"
toggleView sendChangeMessageWith:aValue
! !
!CheckBox methodsFor:'queries'!
preferredExtent
"compute the boxes preferredExtent from the components' sizes"
|prefCheck prefLabel bw2|
^ super preferredExtent + (10@0).
"/ prefCheck := toggleView preferredExtent.
"/ prefLabel := labelView preferredExtent.
"/ bw2 := borderWidth * 2.
"/ ^ (prefCheck x + prefLabel x + (3 * ViewSpacing)) @ ((prefCheck y max:prefLabel y) + bw2 + 2)
"Modified: 23.4.1996 / 00:14:14 / cg"
! !
!CheckBox class methodsFor:'documentation'!
version
^ '$Header: /cvs/stx/stx/libwidg2/CheckBox.st,v 1.20 1996-04-22 22:20:51 cg Exp $'
! !