Skip to main content
Jump to: navigation, search

Difference between revisions of "Scout/Concepts/Field"

m (→‎Value fields)
(→‎Contribution to the Form lifecycle)
 
(27 intermediate revisions by 2 users not shown)
Line 6: Line 6:
 
* extends: {{ScoutJavadoc|AbstractFormField|C}}
 
* extends: {{ScoutJavadoc|AbstractFormField|C}}
  
−
== Description ==
+
== Type of fields ==
−
{{note|TODO|Add a description}}
+
 
It is possible to distinguish different types of fields:  
 
It is possible to distinguish different types of fields:  
  
Line 20: Line 19:
 
! Swing Rayo
 
! Swing Rayo
 
|-
 
|-
−
| {{ScoutLink|Concepts|StringField|StringField}} || [[Image:Scout_3.8_StringField_RAP.png]] || [[Image:Scout_3.8_StringField_SWT.png]] || [[Image:Scout_3.8_StringField_Swing.png]] || [[Image:Scout_3.8_StringField_Swing_Rayo.png]]
+
| {{ScoutLink|Concepts|StringField}} || [[Image:Scout_3.8_StringField_RAP.png]] || [[Image:Scout_3.8_StringField_SWT.png]] || [[Image:Scout_3.8_StringField_Swing.png]] || [[Image:Scout_3.8_StringField_Swing_Rayo.png]]
 
|-
 
|-
−
| {{ScoutLink|Concepts|FileChooserField|FileChooserField}} || [[Image:Scout_3.8_FileChooserField_RAP.png]] || [[Image:Scout_3.8_FileChooserField_SWT.png]] || [[Image:Scout_3.8_FileChooserField_Swing.png]] || [[Image:Scout_3.8_FileChooserField_Swing_Rayo.png]]
+
| {{ScoutLink|Concepts|LabelField}} || [[Image:Scout_3.8_LabelField_RAP.png]] || [[Image:Scout_3.8_LabelField_SWT.png]] || [[Image:Scout_3.8_LabelField_Swing.png]] || [[Image:Scout_3.8_LabelField_Swing_Rayo.png]]
 
|-
 
|-
−
| {{ScoutLink|Concepts|DateField|DateField}} || [[Image:Scout_3.8_DateField_RAP.png]] || [[Image:Scout_3.8_DateField_SWT.png]] || [[Image:Scout_3.8_DateField_Swing.png]] || [[Image:Scout_3.8_DateField_Swing_Rayo.png]]
+
| {{ScoutLink|Concepts|IntegerField}} || [[Image:Scout_3.8_IntegerField_RAP.png]] || [[Image:Scout_3.8_IntegerField_SWT.png]] || [[Image:Scout_3.8_IntegerField_Swing.png]] || [[Image:Scout_3.8_IntegerField_Swing_Rayo.png]]
 
|-
 
|-
−
| {{ScoutLink|Concepts|TimeField|TimeField}} || [[Image:Scout_3.8_TimeField_RAP.png]] || [[Image:Scout_3.8_TimeField_SWT.png]] || [[Image:Scout_3.8_TimeField_Swing.png]] || [[Image:Scout_3.8_TimeField_Swing_Rayo.png]]
+
| {{ScoutLink|Concepts|LongField}} || [[Image:Scout_3.8_LongField_RAP.png]] || [[Image:Scout_3.8_LongField_SWT.png]] || [[Image:Scout_3.8_LongField_Swing.png]] || [[Image:Scout_3.8_LongField_Swing_Rayo.png]]
 
|-
 
|-
−
| {{ScoutLink|Concepts|DateTimeField|DateTimeField}} || [[Image:Scout_3.8_DateTimeField_RAP.png]] || [[Image:Scout_3.8_DateTimeField_SWT.png]] || [[Image:Scout_3.8_DateTimeField_Swing.png]] || [[Image:Scout_3.8_DateTimeField_Swing_Rayo.png]]
+
| {{ScoutLink|Concepts|BigIntegerField}} || [[Image:Scout_3.8_BigIntegerField_RAP.png]] || [[Image:Scout_3.8_BigIntegerField_SWT.png]] || [[Image:Scout_3.8_BigIntegerField_Swing.png]] || [[Image:Scout_3.8_BigIntegerField_Swing_Rayo.png]]
 
|-
 
|-
−
| colspan="2" align="center" | See also the main article on {{ScoutLink|Concepts|ValueField|value fields}}
+
| {{ScoutLink|Concepts|DoubleField}} || [[Image:Scout_3.8_DoubleField_RAP.png]] || [[Image:Scout_3.8_DoubleField_SWT.png]] || [[Image:Scout_3.8_DoubleField_Swing.png]] || [[Image:Scout_3.8_DoubleField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|BigDecimalField}} || [[Image:Scout_3.8_BigDecimalField_RAP.png]] || [[Image:Scout_3.8_BigDecimalField_SWT.png]] || [[Image:Scout_3.8_BigDecimalField_Swing.png]] || [[Image:Scout_3.8_BigDecimalField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|FileChooserField}} || [[Image:Scout_3.8_FileChooserField_RAP.png]] || [[Image:Scout_3.8_FileChooserField_SWT.png]] || [[Image:Scout_3.8_FileChooserField_Swing.png]] || [[Image:Scout_3.8_FileChooserField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|BooleanField|BooleanField or CheckBox}} || [[Image:Scout_3.8_BooleanField_RAP.png]] || [[Image:Scout_3.8_BooleanField_SWT.png]] || [[Image:Scout_3.8_BooleanField_Swing.png]] || [[Image:Scout_3.8_BooleanField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|SmartField}} || [[Image:Scout_3.8_SmartField_RAP.png]] || [[Image:Scout_3.8_SmartField_SWT.png]] || [[Image:Scout_3.8_SmartField_Swing.png]] || [[Image:Scout_3.8_SmartField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|ProposalField}} || [[Image:Scout_4.0_ProposalField_RAP.png]] || [[Image:Scout_4.0_ProposalField_SWT.png]] || [[Image:Scout_4.0_ProposalField_Swing.png]] || [[Image:Scout_4.0_ProposalField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|DateField}} || [[Image:Scout_3.8_DateField_RAP.png]] || [[Image:Scout_3.8_DateField_SWT.png]] || [[Image:Scout_3.8_DateField_Swing.png]] || [[Image:Scout_3.8_DateField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|TimeField}} || [[Image:Scout_3.8_TimeField_RAP.png]] || [[Image:Scout_3.8_TimeField_SWT.png]] || [[Image:Scout_3.8_TimeField_Swing.png]] || [[Image:Scout_3.8_TimeField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|DateTimeField}} || [[Image:Scout_3.8_DateTimeField_RAP.png]] || [[Image:Scout_3.8_DateTimeField_SWT.png]] || [[Image:Scout_3.8_DateTimeField_Swing.png]] || [[Image:Scout_3.8_DateTimeField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|CalendarField}} || [[Image:Scout_3.8_CalendarField_RAP.png]] || [[Image:Scout_3.8_CalendarField_SWT.png]] || [[Image:Scout_3.8_CalendarField_Swing.png]] || [[Image:Scout_3.8_CalendarField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|ListBox}} || [[Image:Scout_3.8_ListBox_RAP.png]] || [[Image:Scout_3.8_ListBox_SWT.png]] || [[Image:Scout_3.8_ListBox_Swing.png]] || [[Image:Scout_3.8_ListBox_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|TreeBox}} || [[Image:Scout_3.8_TreeBox_RAP.png]] || [[Image:Scout_3.8_TreeBox_SWT.png]] || [[Image:Scout_3.8_TreeBox_Swing.png]] || [[Image:Scout_3.8_TreeBox_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|MailField}} || only Swing available || only Swing available || [[Image:Scout_3.8_MailField_Swing.png]] || [[Image:Scout_3.8_MailField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|HtmlField}} || [[Image:Scout_3.8_HtmlField_RAP.png]] || [[Image:Scout_3.8_HtmlField_SWT.png]] || [[Image:Scout_3.8_HtmlField_Swing.png]] || [[Image:Scout_3.8_HtmlField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|BrowserField}} || [[Image:Scout_3.8_BrowserField_RAP.png]] || [[Image:Scout_3.8_BrowserField_SWT.png]] || [[Image:Scout_3.8_BrowserField_Swing.png]] || [[Image:Scout_3.8_BrowserField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|DocumentField}} ||  colspan="4" align="center" | This will be released soon as a scout swing fragment under epl.
 +
|-
 +
| colspan="5" align="center" | See also the main article on {{ScoutLink|Concepts|ValueField|value fields}}
 
|-
 
|-
 
|}
 
|}
Line 39: Line 70:
 
|-{{BMTHStyle}}
 
|-{{BMTHStyle}}
 
! Field
 
! Field
−
! Preview
+
! RAP
 +
! SWT
 +
! Swing
 +
! Swing Rayo
 
|-
 
|-
−
| {{ScoutLink|Concepts|GroupBox|GroupBox field}} || ...TODO...
+
| {{ScoutLink|Concepts|GroupBox|GroupBox}} || [[Image:Scout_3.8_GroupBox_RAP.png]] || [[Image:Scout_3.8_GroupBox_SWT.png]] || [[Image:Scout_3.8_GroupBox_Swing.png]] || [[Image:Scout_3.8_GroupBox_Swing_Rayo.png]]
 
|-
 
|-
−
| {{ScoutLink|Concepts|TabBox|TabBox field}} || ...TODO...
+
| {{ScoutLink|Concepts|TabBox|TabBox}} || [[Image:Scout_3.8_TabBox_RAP.png]] || [[Image:Scout_3.8_TabBox_SWT.png]] || [[Image:Scout_3.8_TabBox_Swing.png]] || [[Image:Scout_3.8_TabBox_Swing_Rayo.png]]
 
|-
 
|-
−
| {{ScoutLink|Concepts|SequenceBox|SequenceBox field}} || ...TODO...
+
| {{ScoutLink|Concepts|SequenceBox|SequenceBox}} || [[Image:Scout_3.8_SequenceBox_RAP.png]] || [[Image:Scout_3.8_SequenceBox_SWT.png]] || [[Image:Scout_3.8_SequenceBox_Swing.png]] || [[Image:Scout_3.8_SequenceBox_Swing_Rayo.png]]
 
|-
 
|-
−
| ... || ...
+
| {{ScoutLink|Concepts|SplitBox|SplitBox}} || [[Image:Scout_3.8_SplitBox_RAP.png]] || [[Image:Scout_3.8_SplitBox_SWT.png]] || [[Image:Scout_3.8_SplitBox_Swing.png]] || [[Image:Scout_3.8_SplitBox_Swing_Rayo.png]]
 
|-
 
|-
−
| colspan="2" align="center" | See also the main article on {{ScoutLink|Concepts|CompositeField|composite field}}
+
| {{ScoutLink|Concepts|RadioButtonGroup|RadioButtonGroup}} || [[Image:Scout_3.8_RadioButtonGroup_RAP.png]] || [[Image:Scout_3.8_RadioButtonGroup_SWT.png]] || [[Image:Scout_3.8_RadioButtonGroup_Swing.png]] || [[Image:Scout_3.8_RadioButtonGroup_Swing_Rayo.png]]
 +
|-
 +
| colspan="5" align="center" | See also the main article on {{ScoutLink|Concepts|CompositeField|composite field}}
 +
|-
 +
|}
 +
 
 +
===Buttons===
 +
{|{{BMTableStyle}}
 +
|-{{BMTHStyle}}
 +
! Button
 +
! RAP
 +
! SWT
 +
! Swing
 +
! Swing Rayo
 +
|-
 +
| {{ScoutLink|Concepts|Button|Button}} || [[Image:Scout_3.8_Button_RAP.png]] || [[Image:Scout_3.8_Button_SWT.png]] || [[Image:Scout_3.8_Button_Swing.png]] || [[Image:Scout_3.8_Button_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|ToggleButton|ToggleButton}} || [[Image:Scout_3.8_ToggleButton_RAP.png]] || [[Image:Scout_3.8_ToggleButton_SWT.png]] || [[Image:Scout_3.8_ToggleButton_Swing.png]] || [[Image:Scout_3.8_ToggleButton_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|LinkButton|LinkButton}} || [[Image:Scout_3.8_LinkButton_RAP.png]] || [[Image:Scout_3.8_LinkButton_SWT.png]] || [[Image:Scout_3.8_LinkButton_Swing.png]] || [[Image:Scout_3.8_LinkButton_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|RadioButton|RadioButton}} || [[Image:Scout_3.8_RadioButton_RAP.png]] || [[Image:Scout_3.8_RadioButton_SWT.png]] || [[Image:Scout_3.8_RadioButton_Swing.png]] || [[Image:Scout_3.8_RadioButton_Swing_Rayo.png]]
 
|-
 
|-
 
|}
 
|}
  
 
===Other fields===
 
===Other fields===
−
* Container fields: They contain other Scout Element ({{ScoutLink|Concepts|TableField|TableField}}, {{ScoutLink|Concepts|PageField|PageField}}, FormField, ...)
+
{|{{BMTableStyle}}
 +
|-{{BMTHStyle}}
 +
! Field
 +
! RAP
 +
! SWT
 +
! Swing
 +
! Swing Rayo
 +
|-
 +
| {{ScoutLink|Concepts|TableField|TableField}} || [[Image:Scout_3.8_TableField_RAP.png]] || [[Image:Scout_3.8_TableField_SWT.png]] || [[Image:Scout_3.8_TableField_Swing.png]] || [[Image:Scout_3.8_TableField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|TableField|TreeField}} || colspan="4" align="center" | {{Note|TODO|Add screenshots for the TreeField}}
 +
|-
 +
| {{ScoutLink|Concepts|PageField|PageField}} || [[Image:Scout_3.8_PageField_RAP.png]] || [[Image:Scout_3.8_PageField_SWT.png]] || [[Image:Scout_3.8_PageField_Swing.png]] || [[Image:Scout_3.8_PageField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|ImageField|ImageField}} || [[Image:Scout_3.8_ImageField_RAP.png]] || [[Image:Scout_3.8_ImageField_SWT.png]] || [[Image:Scout_3.8_ImageField_Swing.png]] || [[Image:Scout_3.8_ImageField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|SVGField|SVGField}} || [[Image:Scout_3.8_SVGField_RAP.png]] || [[Image:Scout_3.8_SVGField_SWT.png]] || [[Image:Scout_3.8_SVGField_Swing.png]] || [[Image:Scout_3.8_SVGField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|PlannerField|PlannerField}} || only Swing available || only Swing available || [[Image:Scout_3.8_PlannerField_Swing.png]] || [[Image:Scout_3.8_PlannerField_Swing_Rayo.png]]
 +
|-
 +
| {{ScoutLink|Concepts|WrappedFormField|WrappedFormField}} || colspan="4" align="center" | Contains another form
 +
|-
 +
|}
 +
 
 +
 
 +
== Contribution to unsaved changes ==
 +
Each field controls if he contains modifications or not. This information is used by the form for its {{ScoutLink|Concepts|Form#Form_lifecycle|lifecycle management}} in particular to decide if a save action is required or not.
 +
 
 +
Each field defines if it contains unsaved modifications with the method <tt>isSaveNeeded()</tt>. The property is updated when <tt>checkSaveNeeded()</tt> is called on the field. The implementation of this method checks:
 +
* the value of the <tt>m_touched</tt> flag.
 +
* the value returned by <tt>execIsSaveNeeded()</tt> ({{ScoutEvent|IsSaveNeeded}} event).
 +
 
 +
The <tt>m_touched</tt> flag can be modified with <tt>touch()</tt> (flag is set to true) and <tt>markSaved()</tt> (flag is set to false). Additionally when the flag is set to false the event {{ScoutEvent|MarkSaved}} is triggered. Depending on the type of field this event will: reset the initial value to the current value for value fields or propagate the call to all the children for a composite field.
  
−
TODO: also HTML field...
+
The <tt>execIsSaveNeeded()</tt> method provides a way to add field-specific logic to tell if the field contains informations that require a save action (at form level) or not. The default implementation just compares the initial value with the current value. If they are not equals the method return true (to indicate that a save action is needed to save the content of this field).
  
 
== Properties ==
 
== Properties ==

Latest revision as of 13:27, 25 September 2014


Scout
Wiki Home
Website
Download • Git
Community
Forums • Blog • Twitter • G+
Bugzilla
Bugzilla


Field are elements in Form

  • implements: I obj.pngIFormField
  • extends: C obj.pngAbstractFormField

Type of fields

It is possible to distinguish different types of fields:

Value fields

These fiels contain a value. There are specific implementation depending on the type of data:

Field RAP SWT Swing Swing Rayo
StringField Scout 3.8 StringField RAP.png Scout 3.8 StringField SWT.png Scout 3.8 StringField Swing.png Scout 3.8 StringField Swing Rayo.png
LabelField Scout 3.8 LabelField RAP.png Scout 3.8 LabelField SWT.png Scout 3.8 LabelField Swing.png Scout 3.8 LabelField Swing Rayo.png
IntegerField Scout 3.8 IntegerField RAP.png Scout 3.8 IntegerField SWT.png Scout 3.8 IntegerField Swing.png Scout 3.8 IntegerField Swing Rayo.png
LongField Scout 3.8 LongField RAP.png Scout 3.8 LongField SWT.png Scout 3.8 LongField Swing.png Scout 3.8 LongField Swing Rayo.png
BigIntegerField Scout 3.8 BigIntegerField RAP.png Scout 3.8 BigIntegerField SWT.png Scout 3.8 BigIntegerField Swing.png Scout 3.8 BigIntegerField Swing Rayo.png
DoubleField Scout 3.8 DoubleField RAP.png Scout 3.8 DoubleField SWT.png Scout 3.8 DoubleField Swing.png Scout 3.8 DoubleField Swing Rayo.png
BigDecimalField Scout 3.8 BigDecimalField RAP.png Scout 3.8 BigDecimalField SWT.png Scout 3.8 BigDecimalField Swing.png Scout 3.8 BigDecimalField Swing Rayo.png
FileChooserField Scout 3.8 FileChooserField RAP.png Scout 3.8 FileChooserField SWT.png Scout 3.8 FileChooserField Swing.png Scout 3.8 FileChooserField Swing Rayo.png
BooleanField or CheckBox Scout 3.8 BooleanField RAP.png Scout 3.8 BooleanField SWT.png Scout 3.8 BooleanField Swing.png Scout 3.8 BooleanField Swing Rayo.png
SmartField Scout 3.8 SmartField RAP.png Scout 3.8 SmartField SWT.png Scout 3.8 SmartField Swing.png Scout 3.8 SmartField Swing Rayo.png
ProposalField File:Scout 4.0 ProposalField RAP.png Scout 4.0 ProposalField SWT.png File:Scout 4.0 ProposalField Swing.png File:Scout 4.0 ProposalField Swing Rayo.png
DateField Scout 3.8 DateField RAP.png Scout 3.8 DateField SWT.png Scout 3.8 DateField Swing.png Scout 3.8 DateField Swing Rayo.png
TimeField Scout 3.8 TimeField RAP.png Scout 3.8 TimeField SWT.png Scout 3.8 TimeField Swing.png Scout 3.8 TimeField Swing Rayo.png
DateTimeField Scout 3.8 DateTimeField RAP.png Scout 3.8 DateTimeField SWT.png Scout 3.8 DateTimeField Swing.png Scout 3.8 DateTimeField Swing Rayo.png
CalendarField Scout 3.8 CalendarField RAP.png Scout 3.8 CalendarField SWT.png Scout 3.8 CalendarField Swing.png Scout 3.8 CalendarField Swing Rayo.png
ListBox Scout 3.8 ListBox RAP.png Scout 3.8 ListBox SWT.png Scout 3.8 ListBox Swing.png Scout 3.8 ListBox Swing Rayo.png
TreeBox Scout 3.8 TreeBox RAP.png Scout 3.8 TreeBox SWT.png Scout 3.8 TreeBox Swing.png Scout 3.8 TreeBox Swing Rayo.png
MailField only Swing available only Swing available Scout 3.8 MailField Swing.png Scout 3.8 MailField Swing Rayo.png
HtmlField Scout 3.8 HtmlField RAP.png Scout 3.8 HtmlField SWT.png Scout 3.8 HtmlField Swing.png Scout 3.8 HtmlField Swing Rayo.png
BrowserField Scout 3.8 BrowserField RAP.png Scout 3.8 BrowserField SWT.png Scout 3.8 BrowserField Swing.png Scout 3.8 BrowserField Swing Rayo.png
DocumentField This will be released soon as a scout swing fragment under epl.
See also the main article on value fields

Composite fields

To group other fields

Field RAP SWT Swing Swing Rayo
GroupBox Scout 3.8 GroupBox RAP.png Scout 3.8 GroupBox SWT.png Scout 3.8 GroupBox Swing.png Scout 3.8 GroupBox Swing Rayo.png
TabBox Scout 3.8 TabBox RAP.png Scout 3.8 TabBox SWT.png Scout 3.8 TabBox Swing.png Scout 3.8 TabBox Swing Rayo.png
SequenceBox Scout 3.8 SequenceBox RAP.png Scout 3.8 SequenceBox SWT.png Scout 3.8 SequenceBox Swing.png Scout 3.8 SequenceBox Swing Rayo.png
SplitBox Scout 3.8 SplitBox RAP.png Scout 3.8 SplitBox SWT.png Scout 3.8 SplitBox Swing.png Scout 3.8 SplitBox Swing Rayo.png
RadioButtonGroup Scout 3.8 RadioButtonGroup RAP.png Scout 3.8 RadioButtonGroup SWT.png Scout 3.8 RadioButtonGroup Swing.png Scout 3.8 RadioButtonGroup Swing Rayo.png
See also the main article on composite field

Buttons

Button RAP SWT Swing Swing Rayo
Button Scout 3.8 Button RAP.png Scout 3.8 Button SWT.png Scout 3.8 Button Swing.png Scout 3.8 Button Swing Rayo.png
ToggleButton Scout 3.8 ToggleButton RAP.png Scout 3.8 ToggleButton SWT.png Scout 3.8 ToggleButton Swing.png Scout 3.8 ToggleButton Swing Rayo.png
LinkButton Scout 3.8 LinkButton RAP.png Scout 3.8 LinkButton SWT.png Scout 3.8 LinkButton Swing.png Scout 3.8 LinkButton Swing Rayo.png
RadioButton Scout 3.8 RadioButton RAP.png Scout 3.8 RadioButton SWT.png Scout 3.8 RadioButton Swing.png Scout 3.8 RadioButton Swing Rayo.png

Other fields

Field RAP SWT Swing Swing Rayo
TableField Scout 3.8 TableField RAP.png Scout 3.8 TableField SWT.png Scout 3.8 TableField Swing.png Scout 3.8 TableField Swing Rayo.png
TreeField
Note.png
TODO
Add screenshots for the TreeField
PageField Scout 3.8 PageField RAP.png Scout 3.8 PageField SWT.png Scout 3.8 PageField Swing.png Scout 3.8 PageField Swing Rayo.png
ImageField Scout 3.8 ImageField RAP.png Scout 3.8 ImageField SWT.png Scout 3.8 ImageField Swing.png Scout 3.8 ImageField Swing Rayo.png
SVGField Scout 3.8 SVGField RAP.png Scout 3.8 SVGField SWT.png Scout 3.8 SVGField Swing.png Scout 3.8 SVGField Swing Rayo.png
PlannerField only Swing available only Swing available Scout 3.8 PlannerField Swing.png Scout 3.8 PlannerField Swing Rayo.png
WrappedFormField Contains another form


Contribution to unsaved changes

Each field controls if he contains modifications or not. This information is used by the form for its lifecycle management in particular to decide if a save action is required or not.

Each field defines if it contains unsaved modifications with the method isSaveNeeded(). The property is updated when checkSaveNeeded() is called on the field. The implementation of this method checks:

  • the value of the m_touched flag.
  • the value returned by execIsSaveNeeded() (IsSaveNeeded event).

The m_touched flag can be modified with touch() (flag is set to true) and markSaved() (flag is set to false). Additionally when the flag is set to false the event MarkSaved is triggered. Depending on the type of field this event will: reset the initial value to the current value for value fields or propagate the call to all the children for a composite field.

The execIsSaveNeeded() method provides a way to add field-specific logic to tell if the field contains informations that require a save action (at form level) or not. The default implementation just compares the initial value with the current value. If they are not equals the method return true (to indicate that a save action is needed to save the content of this field).

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.

Note.png
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

Retrieved from "https://wiki.eclipse.org/index.php?title=Scout/Concepts/Field&oldid=370901"

This page was last modified 13:27, 25 September 2014 by Jérémie Bresson. Based on work by Sandro Schwager, Claudio Guglielmo and Jeremie Bresson.

Back to the top