[jboss-cvs] jboss-seam/doc/reference/en/modules ...
Norman Richards
norman.richards at jboss.com
Wed Feb 7 18:49:44 EST 2007
User: nrichards
Date: 07/02/07 18:49:44
Modified: doc/reference/en/modules annotations.xml controls.xml
itext.xml
Log:
minor doc updates
Revision Changes Path
1.54 +5 -0 jboss-seam/doc/reference/en/modules/annotations.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: annotations.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/annotations.xml,v
retrieving revision 1.53
retrieving revision 1.54
diff -u -b -r1.53 -r1.54
--- annotations.xml 5 Feb 2007 05:55:39 -0000 1.53
+++ annotations.xml 7 Feb 2007 23:49:44 -0000 1.54
@@ -435,6 +435,11 @@
<programlisting><![CDATA[@Observer("somethingChanged")]]></programlisting>
<para> Specifies that the method should be called when a component-driven event of the specified
type occurs. </para>
+ <programlisting><![CDATA[@Observer(value="somethingChanged",create=false)]]></programlisting>
+ <para>Specifies that the method should be called when an event of the specified type occurs but
+ that an instance should not be created if one doesn't exist. If an instance does not exist
+ and create is false, the event will not be observed. The default value for create is true.
+ </para>
</listitem>
</varlistentry>
</variablelist>
1.19 +7 -2 jboss-seam/doc/reference/en/modules/controls.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: controls.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/controls.xml,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -b -r1.18 -r1.19
--- controls.xml 6 Feb 2007 16:35:41 -0000 1.18
+++ controls.xml 7 Feb 2007 23:49:44 -0000 1.19
@@ -294,9 +294,10 @@
<listitem>
<para>
Displays a dynamic date picker component that selects a date
- for the specified input field. The body of the selectDate element should
+ for the specified input field. The body of the <literal>selectDate</literal> element should
contain HTML elements, such as text or an image, that prompt the user to click
- to display the date picker.
+ to display the date picker. The date picker can be styled using CSS. An example CSS file
+ can be found in the Seam booking demo as <literal>date.css</literal>.
</para>
<itemizedlist>
@@ -304,6 +305,10 @@
The id of the input field that the date picker will insert the
selected date into.
</para></listitem>
+ <listitem><para><literal>dateFormat</literal> —
+ The date format string. This should match the date format of the
+ input field.
+ </para></listitem>
</itemizedlist>
1.5 +24 -5 jboss-seam/doc/reference/en/modules/itext.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: itext.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/itext.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -b -r1.4 -r1.5
--- itext.xml 5 Feb 2007 01:54:34 -0000 1.4
+++ itext.xml 7 Feb 2007 23:49:44 -0000 1.5
@@ -6,15 +6,15 @@
<section id="itext.intro">
<title>Using PDF Support</title>
- <para>iText support is provided by jboss-seam-pdf.jar. This JAR contains the iText JSF controls, which are used
+ <para>iText support is provided by <literal>jboss-seam-pdf.jar</literal>. This JAR contains the iText JSF controls, which are used
to construct views that can render to PDF, and the DocumentStore component, which serves the rendered
- documents to the user. To include PDF support in your application, included jboss-seam-pdf.jar in your
- WEB-INF/lib directory along with the iText JAR file. There is no further configuration needed to use Seam's
+ documents to the user. To include PDF support in your application, included <literal>jboss-seam-pdf.jar</literal> in your
+ <literal>WEB-INF/lib</literal> directory along with the iText JAR file. There is no further configuration needed to use Seam's
iText support. </para>
<para> The Seam iText module requires the use of Facelets as the view technology. Future versions of the library
may also support the use of JSP. Additionally, it requires the use of the seam-ui package.</para>
- <para> The <literal>examples/pdf</literal> project contains an example of the PDF support in action. It
+ <para> The <literal>examples/itext</literal> project contains an example of the PDF support in action. It
demonstrates proper deployment packaging, and it contains a number examples that demonstrate the key PDF
generation features current supported. </para>
</section>
@@ -316,7 +316,18 @@
<section>
<title>p:image</title>
- <para><literal>p:image</literal> inserts an image into the document.</para>
+ <para><literal>p:image</literal> inserts an image into the document.
+ Images can be be loaded from the classpath or from the web application context using the <literal>resource</literal> attribute.
+ </para>
+
+ <programlisting><p:image resource="/jboss.jpg" /></programlisting>
+
+ <para>Resources can also be dynamically generated by application code. The <literal>imageData</literal> attribute can specify
+ a value binding expression whose value is a <literal>java.awt.Image</literal> object.
+ </para>
+
+ <programlisting><p:image imageData="#{images.chart}" /></programlisting>
+
<variablelist>
<varlistentry>
<term>
@@ -329,6 +340,14 @@
</varlistentry>
<varlistentry>
<term>
+ <literal>imageData</literal>
+ </term>
+ <listitem>
+ <para>A method expression binding to an application-generated image.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
<literal>rotation</literal>
</term>
<listitem>
More information about the jboss-cvs-commits
mailing list