Revision: 1350
Author: peterdb
Date: 2006-08-30 04:38:21 -0700 (Wed, 30 Aug 2006)
ViewCVS: http://svn.sourceforge.net/spring-rich-c/?rev=1350&view=rev
Log Message:
-----------
moved form docs to main site
Modified Paths:
--------------
trunk/spring-richclient/src/site/site.xml
Added Paths:
-----------
trunk/spring-richclient/src/site/apt/user/formFramework.apt
trunk/spring-richclient/src/site/apt/user/interceptors.apt
trunk/spring-richclient/src/site/resources/images/interceptor/
trunk/spring-richclient/src/site/resources/images/interceptor/ColorValidationInterceptor.png
trunk/spring-richclient/src/site/resources/images/interceptor/ComboboxAutocompletionInterceptor.png
trunk/spring-richclient/src/site/resources/images/interceptor/DirtyIndicatorInterceptor.png
trunk/spring-richclient/src/site/resources/images/interceptor/OverlayValidationInterceptor.png
trunk/spring-richclient/src/site/resources/images/interceptor/SelectAllInterceptor.png
trunk/spring-richclient/src/site/resources/images/interceptor/ShowCaptionInStatusBarInterceptor.png
trunk/spring-richclient/src/site/resources/images/interceptor/TextComponentInterceptor.png
Added: trunk/spring-richclient/src/site/apt/user/formFramework.apt
===================================================================
--- trunk/spring-richclient/src/site/apt/user/formFramework.apt
(rev 0)
+++ trunk/spring-richclient/src/site/apt/user/formFramework.apt 2006-08-30
11:38:21 UTC (rev 1350)
@@ -0,0 +1,9 @@
+ -----
+ Form Framework
+ -----
+ Peter De Bruycker
+ -----
+
+Form Framework
+
+ Todo...
\ No newline at end of file
Added: trunk/spring-richclient/src/site/apt/user/interceptors.apt
===================================================================
--- trunk/spring-richclient/src/site/apt/user/interceptors.apt
(rev 0)
+++ trunk/spring-richclient/src/site/apt/user/interceptors.apt 2006-08-30
11:38:21 UTC (rev 1350)
@@ -0,0 +1,165 @@
+ -----
+ Form Component Interceptors
+ -----
+ Peter De Bruycker
+ -----
+
+Form Component Interceptors
+
+ Form Component Interceptors provide a way to intercept and add extra
+ functionality to input components on a form.
+
+ The application context specifies the list of interceptors to attach to
controls
+ constructed by the platform. This allows for a declarative model for
specifying
+ "additional" functionality to be added to various components.
+
+ Examples are interceptors to overlay validation error images and
background color
+ changes, provide popup menus in text fields, and autocompletion (as you
type) for
+ comboboxes.
+
+Configuration
+
+ The configuration of the interceptors in the application context is
done by
+ defining the <<<FormComponentInterceptorFactory>>>.
+
+ Sample configuration:
+
++---+
+<bean id="formComponentInterceptorFactory"
+
class="org.springframework.richclient.form.builder.support.ChainedInterceptorFactory">
+ <property name="interceptorFactories">
+ <list>
+ <bean
class="org.springframework.richclient.form.builder.support.ColorValidationInterceptorFactory">
+ <property name="errorColor"
value="255,200,200"/>
+ </bean>
+ <bean
class="org.springframework.richclient.form.builder.support.OverlayValidationInterceptorFactory"/>
+ <bean
class="org.springframework.richclient.form.builder.support.DirtyIndicatorInterceptorFactory"/>
+ <bean
class="org.springframework.richclient.text.TextComponentPopupInterceptorFactory"/>
+ <bean
class="org.springframework.richclient.list.ComboBoxAutoCompletionInterceptorFactory"/>
+ </list>
+ </property>
+</bean>
++---+
+
+Existing Interceptors
+
+ The framework contains some interceptors ready to use.
+
+* Overlay Validation Interceptor
+
+ Shows an error image in the lower left corner of the component if the
contents
+ of the component is invalid. The image also has a tooltip showing the
validation message.
+
+ <<Factory class>>:
<<<org.springframework.richclient.form.builder.support.OverlayValidationInterceptorFactory>>>
+
+
+[../images/interceptor/OverlayValidationInterceptor.png] Overlay Validation
Interceptor screenshot
+
+* Color Validation Interceptor
+
+ Changes the background color of the form component.
+
+ <<Factory class>>:
<<<org.springframework.richclient.form.builder.support.ColorValidationInterceptorFactory>>>
+
+ <<Properties>>:
+
+ * <<<errorColor>>>: the background color
+
+ []
+
+ Sample configuration:
+
++---+
+<!-- This sets the error color to a nice "reddish" tint -->
+<bean
class="org.springframework.richclient.form.builder.support.ColorValidationInterceptorFactory">
+ <property name="errorColor" value="255,200,200"/>
+</bean>
++---+
+
+
+[../images/interceptor/ColorValidationInterceptor.png] Color Validation
Interceptor screenshot
+
+* Text Component Interceptor
+
+ Adds more advanced text editing functionality to text components. It
adds a
+ popup menu with "undo/redo/cut/copy/paste/select all" items. It also
adds
+ the standard keyboard accelerators for these commands to the component.
+
+ <<Factory class>>:
<<<org.springframework.richclient.text.TextComponentPopupInterceptorFactory>>>
+
+[../images/interceptor/TextComponentInterceptor.png] Text Component
Interceptor screenshot
+
+* Combobox Autocompletion Interceptor
+
+ Adds autocompletion to a combobox.
+
+ <<Factory class>>:
<<<org.springframework.richclient.list.ComboBoxAutoCompletionInterceptorFactory>>>
+
+[../images/interceptor/ComboboxAutocompletionInterceptor.png] Combobox
Autocompletion Interceptor screenshot
+
+* Dirty Indicator Interceptor
+
+ Shows an image in the top left corder of the component if the contents
of the
+ component has been changed by the user. The image also has a tooltip
showing the
+ original value. To the right of the image is a small revert button.
Pushing this
+ button restores the original value in the component.
+
+ <<Factory class>>:
<<<org.springframework.richclient.form.builder.support.DirtyIndicatorInterceptorFactory>>>
+
+ <<Properties>>:
+
+ * <<<includedFormModelIds>>>: list of form models that should display
the Dirty Indicator.
+
+ Only one of <<<includedFormModelIds>>> or <<<excludedFormModelIds>>>
can be specified.
+
+ * <<<excludedFormModelIds>>>: list of form models that should not
display the Dirty Indicator
+
+ Only one of <<<includedFormModelIds>>> or <<<excludedFormModelIds>>>
can be specified.
+
+ []
+
++---+
+<!-- The login form will not show the Dirty Indicator -->
+
+<bean
class="org.springframework.richclient.form.builder.support.DirtyIndicatorInterceptorFactory">
+ <property name="excludedFormModelIds">
+ <list>
+ <value>loginForm</value>
+ </list>
+ </property>
+</bean>
++---+
+
+[../images/interceptor/DirtyIndicatorInterceptor.png] Dirty Indicator
Interceptor screenshot
+
+Interceptors in Sandbox
+
+ Note: it's likely that these interceptors will change as they are still
in the
+ sandbox. This can go from a simple rename to a complete change in
implementation
+ and/or behaviour.
+
+* Show Caption in StatusBar Interceptor
+
+ Displays the caption of the component that has focus in the statusbar.
+ For this to work, the form property must have a caption in the message
source.
+
+ <<Factory class>>:
<<<org.springframework.richclient.form.builder.support.ShowCaptionInStatusBarInterceptorFactory>>>
+
+[../images/interceptor/ShowCaptionInStatusBarInterceptor.png] Show Caption in
StatusBar screenshot
+
+* Select All Interceptor
+
+ Selects all the text in text fields and spinners when they receive
focus.
+
+ <<Factory class>>:
<<<org.springframework.richclient.text.SelectAllInterceptorFactory>>>
+
+[../images/interceptor/SelectAllInterceptor.png] Select All Interceptor
screenshot
+
+
+Ideas for Interceptors
+
+ Possible new interceptors:
+
+ * Help Interceptor: use the form id + form property path to show help
using the java help system.
+
+ * ...
\ No newline at end of file
Added:
trunk/spring-richclient/src/site/resources/images/interceptor/ColorValidationInterceptor.png
===================================================================
(Binary files differ)
Property changes on:
trunk/spring-richclient/src/site/resources/images/interceptor/ColorValidationInterceptor.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/spring-richclient/src/site/resources/images/interceptor/ComboboxAutocompletionInterceptor.png
===================================================================
(Binary files differ)
Property changes on:
trunk/spring-richclient/src/site/resources/images/interceptor/ComboboxAutocompletionInterceptor.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/spring-richclient/src/site/resources/images/interceptor/DirtyIndicatorInterceptor.png
===================================================================
(Binary files differ)
Property changes on:
trunk/spring-richclient/src/site/resources/images/interceptor/DirtyIndicatorInterceptor.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/spring-richclient/src/site/resources/images/interceptor/OverlayValidationInterceptor.png
===================================================================
(Binary files differ)
Property changes on:
trunk/spring-richclient/src/site/resources/images/interceptor/OverlayValidationInterceptor.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/spring-richclient/src/site/resources/images/interceptor/SelectAllInterceptor.png
===================================================================
(Binary files differ)
Property changes on:
trunk/spring-richclient/src/site/resources/images/interceptor/SelectAllInterceptor.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/spring-richclient/src/site/resources/images/interceptor/ShowCaptionInStatusBarInterceptor.png
===================================================================
(Binary files differ)
Property changes on:
trunk/spring-richclient/src/site/resources/images/interceptor/ShowCaptionInStatusBarInterceptor.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
trunk/spring-richclient/src/site/resources/images/interceptor/TextComponentInterceptor.png
===================================================================
(Binary files differ)
Property changes on:
trunk/spring-richclient/src/site/resources/images/interceptor/TextComponentInterceptor.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: trunk/spring-richclient/src/site/site.xml
===================================================================
--- trunk/spring-richclient/src/site/site.xml 2006-08-30 11:35:18 UTC (rev
1349)
+++ trunk/spring-richclient/src/site/site.xml 2006-08-30 11:38:21 UTC (rev
1350)
@@ -45,6 +45,9 @@
<item name="Master-detail"
href="http://opensource.atlassian.com/confluence/spring/display/RCP/Master-Detail+Forms"/>
<item name="Acegi security"
href="http://opensource.atlassian.com/confluence/spring/display/RCP/Security"/>
<item name="Command Framework"
href="/user/commandFramework.html"/>
+ <item name="Form Framework" href="/user/formFramework.html"
collapse="false">
+ <item name="Form Component Interceptors"
href="/user/interceptors.html"/>
+ </item>
</item>
<item name="Support" href="/user/support.html"/>
<item name="Upgrading" href="/user/upgrading.html"/>
This was sent by the SourceForge.net collaborative development platform, the
world's largest Open Source development site.
-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________
spring-rich-c-cvs mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/spring-rich-c-cvs
