Class: ComboView

• Inheritance
• Description
• Class protocol
  • defaults
  • image specs
  • private
  • queries
• Instance protocol
  • accessing-behavior
  • accessing-channels
  • accessing-components
  • accessing-contents
  • accessing-look
  • accessing-mvc
  • change & update
  • event handling
  • initialization & release
  • menu interaction
  • message delegation
  • private
  • queries
  • testing
• Examples

Inheritance:

   Object
   |
   +--GraphicsMedium
      |
      +--DisplaySurface
         |
         +--SimpleView
            |
            +--View
               |
               +--ComboView
                  |
                  +--ComboBoxView
                  |
                  +--ComboListView

Package:

stx:libwidg2

Category:

Views-Interactors

Version:

rev: 1.145 date: 2024/02/25 13:15:50

user: cg

file: ComboView.st directory: libwidg2

module: stx stc-classLibrary: libwidg2

Description:

A ComboView combines some field (typically an enterField or Label)
with a drop down list of default inputs;
ComboView is abstract, providing protocol common to ComboBoxView and
ComboListView. See documentation & examples there.


[instance variables:]
    currentIndex    Integer     index into the list, that is currently selected

copyright
COPYRIGHT (c) 1996 by eXept Software AG / 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.

Class protocol:

 activeForm

 buttonForm

return the pull-buttons image

 comboButtonFor: aComboView

 defaultFont

for now - should come from the styleSheet

Usage example(s):

^ SelectionInListView defaultFont.

 defaultListMessage

 disabledForm

 enteredForm

 updateStyleCache

flush the forms cache

 defaultButtonForm

This resource specification was automatically generated
by the ImageEditor of ST/X.

Usage example(s):

self defaultButtonForm inspect ImageEditor openOnClass:self andSelector:#defaultButtonForm Icon flushCachedIcons

 formForKey: key styleFormKey: styleFormKey styleFilenameKey: styleFilenameKey

 isAbstract

Return if this class is an abstract class.
True is returned here for myself only; false for subclasses.
Abstract subclasses must redefine this again.

Instance protocol:

 action: aBlock

specify, a block, which is evaluated when the lists selection changes.
This is an additional hook - normally, you would communicate with the model
alone

 enabled

return true, if it is enabled

 enabled: aBoolean

enable/disable components

 resizableMenu

return true, if the menu is to be resizable.
This feature is as yet unimplemented.

 resizableMenu: aBoolean

enable/disable, if the menu is to be resizable.
This feature is as yet unimplemented.

 enableChannel

return a valueHolder for enable/disable

 field

return the field (input or label) component.
For knowledgable users only.

 menuButton

return the menuButton component

 shownMenu

returns the currently shown menu, or nil.
(only valid while the menu is pulled)

 contents

get the contents of my field

 contents: something

set the contents of my field; questionable

 list

return the list

 list: aList

set the list explicitely; used internally or
to be sent from the outside if no model/listHolder is used.

 backgroundColor

(comment from inherited method)
return the background color of the contents -
here, (since there is no contents), the viewBackground is returned.

 backgroundColor: aColor

(comment from inherited method)
set the background color of the contents -
here, (since there is no contents), the viewBackground is changed.

 font: aFont

(comment from inherited method)
set the font for drawing if it has changed.
This should be redefined in some widget to perform an automatic
redraw/invalidate. See also: #basicFont:

 foregroundColor

(comment from inherited method)
return the foreground color of the contents -
here, (since there is no contents), some default is returned.

 foregroundColor: aColor

(comment from inherited method)
set the foreground color of the contents -
ignored here, since there is no contents.

 comboMenuHolder

 comboMenuHolder: aMenuHolder

allows for arbitrary menus to be opened via the combo button

 comboMenuHolder: aMenuHolder comboMenuMessage: aSelectorToTheHolder

allows for arbitrary menus to be opened via the combo button

 comboMenuMessage

 comboMenuMessage: aSelectorToTheHolder

allows for arbitrary menus to be opened via the combo button

 currentIndex

 listHolder: aValueHolder

set the listHolder.
If not set, the list is supposed to be set explicitely

 listMessage: aSymbol

define the message selector sent to the model, to fetch
the list. If not defined, #list is used

 model: aModel

set the model, which is supposed to provide the boxes value.
If a listMessage was defined, it is also responsible for providing
the list

 update: something with: aParameter from: changedObject

 enableStateChanged

the enable state has changed - pass this to my field and pullDownButton

 handlesMouseWheelMotion: event inView: aView

we handle delegated mousewheel events

 keyPress: key x: x y: y

pull the menu on space and return keys

 mouseWheelMotion: buttonState x: x y: y amount: amount deltaTime: dTime view: delegatingView

scroll through the list items

 processEvent: anEvent

care for buttonpress in my field.
Return true, if I have eaten the event

see examples in ComboListView and ComboBoxView