Skip to main content
Jump to: navigation, search

Difference between revisions of "Scout/Concepts/ValueField"

(Description: add links for ListBox, TreeBox, RadioButtonGroup)
(Events)
Line 31: Line 31:
 
''Defined with {{ScoutLink|Concepts|Exec_Methods|execXxxxxx()}} methods''.
 
''Defined with {{ScoutLink|Concepts|Exec_Methods|execXxxxxx()}} methods''.
  
{{note|TODO|Add a description of important events. The idea is not to recreate the JavaDoc of the execXxxxxx() methods but to provide explanations, best practice, example... Group the events by domain.}}
+
See also the {{ScoutLink|Concepts|Field|Field}} page for the events that all fields have in common.
  
{{note|TODO|Schema of the validation of an input}}
+
=== Input validation ===
 +
[[Image:Scout ValueField Validation.png]]
  
 +
* {{ScoutEvent|ParseValue}}: event to define how the text (String) typed in the UI is converted in a value.
 +
* {{ScoutEvent|ValidateValue}}: event to add business logic to define if the value is valid.
 +
* {{ScoutEvent|FormatValue}}: event to define how the value is displayed in the field (as String). This function need to be "compatible" with {{ScoutEvent|ParseValue}}
 +
* {{ScoutEvent|ChangedValue}}: At this point the validValue is accessible with getValue().
 +
 +
=== Other events ===
 +
* {{ScoutEvent|IsSaveNeeded}}
 +
* {{ScoutEvent|MarkSaved}}
 +
* {{ScoutEvent|IsEmpty}}
  
 
== See Also ==
 
== See Also ==
 
* {{ScoutLink|Concepts|Field|Fields}}  
 
* {{ScoutLink|Concepts|Field|Fields}}  
 
* {{ScoutLink|Concepts|Form|Form}}
 
* {{ScoutLink|Concepts|Form|Form}}

Revision as of 16:36, 12 October 2011


Scout
Wiki Home
Website
DownloadGit
Community
ForumsBlogTwitterG+
Bugzilla
Bugzilla


Specific type of Fields that contains a value. Depending on the type of value, one of the child class needs to be considered.

  • implements: I obj.pngIValueField<T>
  • extends: C obj.pngAbstractValueField<T>

Description

Value fields allow the user to enter some values in the form. Scout provides different implementation of the value fields, in order to add properties and event specific to the type (MinValue on IntegerField, or InputMasked for StringField)

Type of Value Fields

Properties

Defined with getConfiguredXxxxxx() methods.

Note.png
TODO
Add a description of important properties. The idea is not to recreate the JavaDoc of the getConfiguredXxxxxx() methods but to provide explanations, best practice, example... Group the properties by domain.


Events

Defined with execXxxxxx() methods.

See also the Field page for the events that all fields have in common.

Input validation

Scout ValueField Validation.png

  • ParseValue: event to define how the text (String) typed in the UI is converted in a value.
  • ValidateValue: event to add business logic to define if the value is valid.
  • FormatValue: event to define how the value is displayed in the field (as String). This function need to be "compatible" with ParseValue
  • ChangedValue: At this point the validValue is accessible with getValue().

Other events

  • IsSaveNeeded
  • MarkSaved
  • IsEmpty

See Also

Back to the top