Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Scout/Concepts/Field"
(→Value fields: add ProposalField) |
(add Contribution to the Form lifecycle) |
||
Line 6: | Line 6: | ||
* extends: {{ScoutJavadoc|AbstractFormField|C}} | * extends: {{ScoutJavadoc|AbstractFormField|C}} | ||
− | == | + | == Type of fields == |
− | + | ||
It is possible to distinguish different types of fields: | It is possible to distinguish different types of fields: | ||
Line 133: | Line 132: | ||
|- | |- | ||
|} | |} | ||
+ | |||
+ | |||
+ | == Contribution to the Form lifecycle == | ||
+ | Each field control if he contains modifications or not. This information is used by the form for the lifecycle management (for example: when is a save action is required). | ||
+ | |||
+ | Each field define if it contains modifications with the method <tt>isSaveNeeded()</tt>. The property is updated when <tt>checkSaveNeeded()</tt> is called. The implementation of this method check: | ||
+ | * the value of the touch flag. | ||
+ | * the value returned by execIsSaveNeeded() ({{ScoutEvent|IsSaveNeeded}} event). | ||
+ | |||
+ | The touch 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. | ||
+ | |||
+ | 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 == |
Revision as of 08:11, 25 September 2014
The Scout documentation has been moved to https://eclipsescout.github.io/.
Field are elements in The Scout documentation has been moved to https://eclipsescout.github.io/.
- implements: The Scout documentation has been moved to https://eclipsescout.github.io/.
- extends: The Scout documentation has been moved to https://eclipsescout.github.io/.
Contents
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 The Scout documentation has been moved to https://eclipsescout.github.io/.:
Field | RAP | SWT | Swing | Swing Rayo |
---|---|---|---|---|
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | File:Scout 4.0 ProposalField RAP.png | File:Scout 4.0 ProposalField Swing.png | File:Scout 4.0 ProposalField Swing Rayo.png | |
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | only Swing available | only Swing available | ||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | This will be released soon as a scout swing fragment under epl. | |||
See also the main article on The Scout documentation has been moved to https://eclipsescout.github.io/. |
Composite fields
To group other fields
Field | RAP | SWT | Swing | Swing Rayo |
---|---|---|---|---|
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
See also the main article on The Scout documentation has been moved to https://eclipsescout.github.io/. |
Buttons
Button | RAP | SWT | Swing | Swing Rayo |
---|---|---|---|---|
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. |
Other fields
Field | RAP | SWT | Swing | Swing Rayo |
---|---|---|---|---|
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | ||||
The Scout documentation has been moved to https://eclipsescout.github.io/. | only Swing available | only Swing available | ||
The Scout documentation has been moved to https://eclipsescout.github.io/. | Contains another form |
Contribution to the Form lifecycle
Each field control if he contains modifications or not. This information is used by the form for the lifecycle management (for example: when is a save action is required).
Each field define if it contains modifications with the method isSaveNeeded(). The property is updated when checkSaveNeeded() is called. The implementation of this method check:
- the value of the touch flag.
- the value returned by execIsSaveNeeded() (The Scout documentation has been moved to https://eclipsescout.github.io/. event).
The touch 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 The Scout documentation has been moved to https://eclipsescout.github.io/. is triggered.
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 The Scout documentation has been moved to https://eclipsescout.github.io/. methods.
Events
Defined with The Scout documentation has been moved to https://eclipsescout.github.io/. methods.
See Also
- The Scout documentation has been moved to https://eclipsescout.github.io/.
- The Scout documentation has been moved to https://eclipsescout.github.io/.