SimpleList prototype

Select an element in a list.
Maximum 5 elements , non scrollable list.

PROTO SimpleList [
  # Events out
  eventOut SFInt32 currentElement # Selected element
  eventOut SFTime selection
  
  # Events in
  eventIn SFInt32 update	# Update the list and position focus on the given element
  eventIn SFInt32 goToElement
  exposedField SFBool enable TRUE
  exposedField SFBool enableCycle TRUE
  
  # Data
  field MFString elementsLabels [""]
  field MFInt32 elementsStates [0]
  field MFInt32 elementsSeparators []
  field SFInt32 nbElements 0
  
  # Style
  field MFString focusbarStyle ["FocusBar"]
  field MFString style ["SimpleList"]
  field SFVec2f size -1 -1
  field SFVec2f textScale 1 1
  field MFString focusbarImages ["focusBarBg.png" "focusBarOver.png"]
  field MFString images ["listSeparator.png"]

  # Private fields (shared by items)
  field SFVec2f separatorSize 0 0
  field SFColor separatorColor 0 0 0
  field SFVec2f labelPos 0 0
  field SFNode labelFontstyle FontStyle {}
  field MFString separatorImage []
]

Data fields

SFInt32 nbElements - Number of elements
MFString elementsLabels - Elements labels
MFInt32 elementsStates - Enable/disable elements. Enable>=0; disable=-1
MFInt32 elementsSeparators - Elements separators. 0 = separator; -1 = no separator

Style fields

MFString focusbarStyle - Path to the CSS specific node associated to the FocusBar of SimpleList proto
MFString style - Path to the CSS node associated to SimpleList proto
SFVec2f size - Size of the area where the SimpleList proto is displayed
SFVec2f textScale - Use for scaling text if necessary (phone with small fonts)1
MFString focusbarImages - FocusBar background and reflect
MFString images - Image separator

Warning:
Define style is required (we can use the default style - see Style node).

Exposed Fields

SFBool enable - Enable/disable SimpleList focus
SFBool enableCycle

Event in

SFInt32 update - Update the list and position focus on the given element
Call update is needed if Styles fields are modified
SFInt32 goToElement - Force list to focus a given element

Event Out

SFInt32 currentElement - The selected element
SFTime selection - The time when an item is selected

SimpleList {
  color: black;
  disabled-color: gray;
  border-width: 90%;
  border-color: gray;
  font-filter: true;  
  font-size: 12;
  font-style: bold;
  horizontal-align: left;
  vertical-align: middle;
  text-position: -35.5% 0%;
}

List, FocusBar

EXTERNPROTO SizeNotifier [] "SizeNotifier.wrl"
EXTERNPROTO SimpleList [] "SimpleList.wrl"
EXTERNPROTO Slider [] "Slider.wrl"

Group {
  children [
    Style {
      url ["default.css"]
    }
    
    DEF SIZE_NOTIFIER SizeNotifier {}
    
    Shape {
      appearance  Appearance {
        material Material2D { emissiveColor 1 1 1 }
      }
      geometry DEF BACKGROUND Rectangle {
        size 10 10
      }
    }
		
    DEF LIST SimpleList {
      elementsLabels [
        "Element 1"
        "Element 2"
        "Element 3"
        "Element 4"
        "Element 5"
      ]
      nbElements 5
          
      focusbarStyle ["FocusBar" "Menu-FocusBar"]
      images ["listSeparator.png"]
          
      enable TRUE
      
      size 100 200
    }
		
    ROUTE SIZE_NOTIFIER.screenSize TO BACKGROUND.size
  ]
}