TriggerBox.st
author Claus Gittinger <cg@exept.de>
Thu, 19 Sep 2013 13:02:05 +0200
changeset 4393 52cc2a73099a
child 4406 72cf3a074996
permissions -rw-r--r--
initial checkin
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
4393
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     1
"
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     2
 COPYRIGHT (c) 2013 by Claus Gittinger
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     3
              All Rights Reserved
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     4
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     5
 This software is furnished under a license and may be used
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     6
 only in accordance with the terms of that license and with the
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     8
 be provided or otherwise made available to, or used by, any
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     9
 other person.  No title to or ownership of the software is
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    10
 hereby transferred.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    11
"
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    12
"{ Package: 'stx:libwidg2' }"
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    13
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    14
CheckBox subclass:#TriggerBox
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    15
	instanceVariableNames:''
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    16
	classVariableNames:''
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    17
	poolDictionaries:''
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    18
	category:'Views-Interactors'
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    19
!
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    20
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    21
!TriggerBox class methodsFor:'documentation'!
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    22
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    23
copyright
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    24
"
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    25
 COPYRIGHT (c) 2013 by Claus Gittinger
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    26
              All Rights Reserved
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    27
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    28
 This software is furnished under a license and may be used
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    29
 only in accordance with the terms of that license and with the
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    30
 inclusion of the above copyright notice.   This software may not
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    31
 be provided or otherwise made available to, or used by, any
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    32
 other person.  No title to or ownership of the software is
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    33
 hereby transferred.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    34
"
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    35
!
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    36
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    37
documentation
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    38
"
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    39
    A TriggerBox looks similar to a CheckBox (it contains a button and a label),
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    40
    but does not show a check-icon.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    41
    Instead, a trigger button (unlabelled) performs a momentary action when pressed.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    42
"
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    43
!
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    44
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    45
examples
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    46
"
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    47
  no-op TriggerBox without a label:
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    48
                                                                        [exBegin]
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    49
     |b|
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    50
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    51
     b := TriggerBox new.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    52
     b open
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    53
                                                                        [exEnd]
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    54
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    55
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    56
  no-op TriggerBox:
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    57
                                                                        [exBegin]
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    58
     |b|
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    59
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    60
     b := TriggerBox new.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    61
     b label:'foo'.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    62
     b open
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    63
                                                                        [exEnd]
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    64
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    65
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    66
  combined instance creation & label setup:
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    67
                                                                        [exBegin]
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    68
     |b|
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    69
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    70
     b := TriggerBox label:'foo'.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    71
     b open
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    72
                                                                        [exEnd]
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    73
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    74
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    75
  no-op trigger, disabled:
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    76
                                                                        [exBegin]
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    77
     |b|
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    78
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    79
     b := TriggerBox label:'foo'.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    80
     b disable.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    81
     b open
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    82
                                                                        [exEnd]
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    83
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    84
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    85
  changing colors 
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    86
                                                                        [exBegin]
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    87
     |panel b|
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    88
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    89
     panel := VerticalPanelView new.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    90
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    91
     b := TriggerBox label:'foo' in:panel.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    92
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    93
     b := TriggerBox label:'bar' in:panel.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    94
     b labelView foregroundColor:Color red.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    95
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    96
     b := TriggerBox label:'baz' in:panel.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    97
     b toggleView activeForegroundColor:Color blue.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    98
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    99
     panel open
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   100
                                                                        [exEnd]
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   101
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   102
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   103
  using action-blocks:
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   104
                                                                        [exBegin]
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   105
     |b|
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   106
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   107
     b := TriggerBox label:'check'.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   108
     b action:[:value | Transcript show:'trigger called: '].
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   109
     b open.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   110
                                                                        [exEnd]
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   111
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   112
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   113
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   114
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   115
  with an enableChannel
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   116
                                                                        [exBegin]
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   117
     |b enaToggle enaHolder|
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   118
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   119
     enaHolder := true asValue.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   120
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   121
     enaToggle := Toggle label:'enable'.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   122
     enaToggle model:enaHolder.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   123
     enaToggle open.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   124
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   125
     b := TriggerBox label:'check'.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   126
     b action:[:value | Transcript showCR:'triggered'].
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   127
     b enableChannel:enaHolder.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   128
     b open.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   129
                                                                        [exEnd]
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   130
"
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   131
! !
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   132
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   133
!TriggerBox methodsFor:'initialization & release'!
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   134
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   135
defaultCheckToggleClass
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   136
    ^ Toggle "/ Button
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   137
!
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   138
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   139
defaultControllerClass
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   140
    ^ ButtonController
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   141
!
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   142
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   143
initialize
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   144
    super initialize.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   145
    toggleView extent:16@16.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   146
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   147
    toggleView activeLogo:nil.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   148
    toggleView passiveLogo:nil.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   149
    toggleView activeLevel:-2.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   150
    toggleView passiveLevel:2.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   151
    toggleView extent:10@10.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   152
    toggleView sizeFixed:true.
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   153
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   154
    toggleView controller:(ButtonController new).
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   155
! !
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   156
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   157
!TriggerBox class methodsFor:'documentation'!
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   158
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   159
version
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   160
    ^ '$Header: /cvs/stx/stx/libwidg2/TriggerBox.st,v 1.1 2013-09-19 11:02:05 cg Exp $'
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   161
!
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   162
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   163
version_CVS
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   164
    ^ '$Header: /cvs/stx/stx/libwidg2/TriggerBox.st,v 1.1 2013-09-19 11:02:05 cg Exp $'
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   165
! !
52cc2a73099a initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   166