Author: jgrandy
Date: 2007-06-24 22:29:27 -0700 (Sun, 24 Jun 2007)
New Revision: 5509
Removed:
openlaszlo/branches/doctools/docs/src/wrappers/lz-radiogroup.html
Modified:
openlaszlo/branches/doctools/WEB-INF/lps/lfc/data/LzDatapointer.lzs
openlaszlo/branches/doctools/WEB-INF/lps/lfc/data/LzDataset.lzs
openlaszlo/branches/doctools/WEB-INF/lps/lfc/helpers/LzSelectionManager.lzs
openlaszlo/branches/doctools/WEB-INF/lps/lfc/views/LaszloView.lzs
openlaszlo/branches/doctools/docs/src/reference/preface.dbk
openlaszlo/branches/doctools/lps/components/base/image.lzx
openlaszlo/branches/doctools/lps/components/lz/radio.lzx
Log:
checkpoint work to private branch
Modified: openlaszlo/branches/doctools/WEB-INF/lps/lfc/data/LzDatapointer.lzs
===================================================================
--- openlaszlo/branches/doctools/WEB-INF/lps/lfc/data/LzDatapointer.lzs
2007-06-24 06:44:51 UTC (rev 5508)
+++ openlaszlo/branches/doctools/WEB-INF/lps/lfc/data/LzDatapointer.lzs
2007-06-25 05:29:27 UTC (rev 5509)
@@ -94,6 +94,9 @@
*/
var p = null;
var data = null;
+
+/** The reference to a clonemanager from a clone.
+ @modifiers readonly */
var context = null;
/** @access private */
Modified: openlaszlo/branches/doctools/WEB-INF/lps/lfc/data/LzDataset.lzs
===================================================================
--- openlaszlo/branches/doctools/WEB-INF/lps/lfc/data/LzDataset.lzs
2007-06-24 06:44:51 UTC (rev 5508)
+++ openlaszlo/branches/doctools/WEB-INF/lps/lfc/data/LzDataset.lzs
2007-06-25 05:29:27 UTC (rev 5509)
@@ -457,15 +457,14 @@
/**
* Sets the querystring parameter of the dataset to the given
- * string. The dataset's querystring will be pre-pended to any request made
- * for the dataset.
+ * string. If an object is given instead of a string, the object will be
+ * automatically converted to a string and used instead. The dataset's
+ * querystring will be pre-pended to any request made for the dataset.
* @param String s: A string to be appended to any query made on behalf of
* this dataset.
*/
function setQueryString( s ) {
this.params = null;
- //@field String querystring: A string to be appended to the request that
- //the dataset makes.
if ( typeof( s ) == "object" ){
if (s instanceof LzParam){
this.querystring = s.toString();
Modified:
openlaszlo/branches/doctools/WEB-INF/lps/lfc/helpers/LzSelectionManager.lzs
===================================================================
--- openlaszlo/branches/doctools/WEB-INF/lps/lfc/helpers/LzSelectionManager.lzs
2007-06-24 06:44:51 UTC (rev 5508)
+++ openlaszlo/branches/doctools/WEB-INF/lps/lfc/helpers/LzSelectionManager.lzs
2007-06-25 05:29:27 UTC (rev 5509)
@@ -4,7 +4,7 @@
* Use is subject to license terms.
*
* @affects lzselectionmanager
- * @access private
+ * @access public
* @topic LFC
* @subtopic Helpers
* @lzxname selectionmanager
@@ -133,7 +133,7 @@
/**
* Called with a new member to be selected.
- * @param o: The new element that got selected.
+ * @param LzView o: The new element that got selected.
*/
function select ( o ){
if ( this.isSelected( o ) && ( this.toggle ||
@@ -158,8 +158,8 @@
/**
* Tests for selectedness of input.
- * @param o: The object to test for selectedness.
- * @return: The selectedness of the input object.
+ * @param LzView o: The object to test for selectedness.
+ * @return Boolean: The selectedness of the input object.
*/
function isSelected ( o ) {
return this.selectedHash[ o.getUID() ];
@@ -168,7 +168,7 @@
/**
* Makes the given object selected.
* @access private
- * @param s: The object to make selected
+ * @param LzView s: The object to make selected
*/
function makeSelected ( s ) {
if ( this.selectedHash[ s.getUID() ] ) return;
@@ -182,7 +182,7 @@
/**
* Unselects the given object.
* @access protected
- * @param o: The object to make unselected
+ * @param LzView o: The object to make unselected
*/
function unselect ( o ){
for ( var i= this.selected.length-1 ; i >= 0; i-- ){
@@ -218,6 +218,8 @@
/**
* @access private
+ * @param LzDataPath s: The datapath that was at top of the selection stack
+ * @param LzView e: The newly selected view
*/
function selectRange ( s , e ){
var pview = s.immediateparent;
@@ -409,6 +411,7 @@
/**
* Tests whether the given view is selected
* @param LzView o: The view to test for selectedness
+ * @return Boolean: The selectedness of the input object.
*/
function isSelected ( o){
if ( this.manager == null ) this.manager = o.cloneManager;//try to get a
cloneManager
Modified: openlaszlo/branches/doctools/WEB-INF/lps/lfc/views/LaszloView.lzs
===================================================================
--- openlaszlo/branches/doctools/WEB-INF/lps/lfc/views/LaszloView.lzs
2007-06-24 06:44:51 UTC (rev 5508)
+++ openlaszlo/branches/doctools/WEB-INF/lps/lfc/views/LaszloView.lzs
2007-06-25 05:29:27 UTC (rev 5509)
@@ -306,7 +306,7 @@
super.__LZinstantiationDone.apply(this, arguments);
}
-/** Reference to closest masked view in the hierarchy above
+/** Reference to closest masked view in the hierarchy at or above
* this one
* @type LzView
*/
Modified: openlaszlo/branches/doctools/docs/src/reference/preface.dbk
===================================================================
--- openlaszlo/branches/doctools/docs/src/reference/preface.dbk 2007-06-24
06:44:51 UTC (rev 5508)
+++ openlaszlo/branches/doctools/docs/src/reference/preface.dbk 2007-06-25
05:29:27 UTC (rev 5509)
@@ -16,7 +16,7 @@
<member><ulink url="../guide/index.html"
target="_blank"><citetitle>Developers Guide</citetitle></ulink></member>
<member><ulink url="../../laszlo-explorer/"
target="_blank"><citetitle>Laszlo Explorer</citetitle></ulink></member>
<member><ulink url="http://www.openlaszlo.org/community";
target="_blank"><citetitle>OpenLaszlo Community</citetitle></ulink></member>
- <member><ulink url="http://forum.laszlosystems.com";
target="_blank"><citetitle>Developer Forums</citetitle></ulink></member>
+ <member><ulink url="http://forum.openlaszlo.org";
target="_blank"><citetitle>Developer Forums</citetitle></ulink></member>
</simplelist>
</sect1>
Deleted: openlaszlo/branches/doctools/docs/src/wrappers/lz-radiogroup.html
Modified: openlaszlo/branches/doctools/lps/components/base/image.lzx
===================================================================
--- openlaszlo/branches/doctools/lps/components/base/image.lzx 2007-06-24
06:44:51 UTC (rev 5508)
+++ openlaszlo/branches/doctools/lps/components/base/image.lzx 2007-06-25
05:29:27 UTC (rev 5509)
@@ -5,7 +5,8 @@
<attribute name="prefix" value="" type="string"/>
<!--- The URL to load the image from. May be set directly on this
attribute or indirectly by specifying a datapath for this tag. -->
<attribute name="src" value="" type="string"/>
- <!--- The last URL loaded by this image tag. Used to prevent the same
URL from loading twice. @keywords readonly-->
+ <!--- The last URL loaded by this image tag. Used to prevent the same
URL from loading twice.
+ @keywords readonly-->
<attribute name="lastloaded" value="" type="string"/>
<!--- If true, the same URL will be reloaded. If false, the same URL
will not load multiple times. -->
<attribute name="forcereload" value="false" type="boolean"/>
@@ -16,8 +17,13 @@
this.setAttribute('src', d);
</method>
- <!--- Loads an image in response to the src attribute being set.
Should not be called directly - setAttribute('src' ...) shoudl be used instead.
@keywords private -->
- <method name="loadNow" event="onsrc" args="img">
+ <event name="onsrc" />
+
+ <handler name="onsrc" method="loadNow" />
+
+ <!--- Loads an image in response to the src attribute being set.
Should not be called directly - setAttribute('src' ...) should be used instead.
+ @keywords private -->
+ <method name="loadNow" args="img">
<![CDATA[
// don't reload the same thing unless we're told to
if (this.forcereload == false && this.lastloaded == this.prefix +
img) return;
@@ -26,13 +32,15 @@
]]>
</method>
- <!--- Loads the image on init. @keywords private -->
+ <!--- Loads the image on init.
+ @keywords private -->
<handler name="oninit">
<![CDATA[
if (this.src != '' && this.src != null)
this.loadNow(this.src);
]]>
</handler>
+
<doc>
<tag name="shortdesc"><text>A way to import images</text></tag>
<text>
Modified: openlaszlo/branches/doctools/lps/components/lz/radio.lzx
===================================================================
--- openlaszlo/branches/doctools/lps/components/lz/radio.lzx 2007-06-24
06:44:51 UTC (rev 5508)
+++ openlaszlo/branches/doctools/lps/components/lz/radio.lzx 2007-06-25
05:29:27 UTC (rev 5509)
@@ -15,7 +15,6 @@
<frame src="resources/radio/radiobtn_dsbl_dn.swf" />
</resource>
- <!--- Enables a one-of-many selection of its children. -->
<class name="radiogroup" extends="baselist"
itemclassname="radiobutton" defaultselection="0">
@@ -53,6 +52,64 @@
if( this.onvalue ) this.onvalue.sendEvent( val );
</method>
+ <doc>
+ <tag name="shortdesc"><text>Enables a one-of-many selection of its
children.</text></tag>
+ <text>
+ <p>The <tagname>radiogroup</tagname> component encloses a list of
+ <tagname link="true">radiobutton</tagname>s. It ensures that a
single
+ item is selected at a time. Initially it will select the first
item in
+ a group if none is set to be selected. By default the radio
buttons
+ are spaced vertically.</p>
+
+ <p>
+ In the following example, the second radio button is selected.
The text
+ that appears is separate from the value that is represented by
each item.
+ In this example, <tt>group1.value</tt> is 2.
+ </p>
+
+ <example>
+ <canvas width="200" height="100">
+ <radiogroup id="group1">
+ <radiobutton value="1" text="one"/>
+ <radiobutton value="2" text="two" selected="true"/>
+ <radiobutton value="3" text="three"/>
+ </radiogroup>
+ </canvas>
+ </example>
+
+ <p>
+ You can use radio group with your own layout attribute, by
overriding the
+ <tagname>view</tagname> layout attribute. The example below uses a
wrapping layout
+ to create two columns of radio buttons. Note that a height must
be given to
+ indicate to the layout where to wrap.
+ </p>
+
+ <example>
+ <canvas width="200" height="100">
+ <radiogroup height="60" layout="class:wrappinglayout;
axis:y">
+ <radiobutton value="1" text="one"/>
+ <radiobutton value="2" text="two"/>
+ <radiobutton value="3" text="three"/>
+ <radiobutton value="4" text="four"/>
+ <radiobutton value="5" text="five"/>
+ <radiobutton value="6" text="six"/>
+ </radiogroup>
+ </canvas>
+ </example>
+
+ <p>
+ A <tt>radiogroup</tt> can contain a set of any
<tagname>baselistitem</tagname>.
+ To make radio buttons with
+ a different look and feel, create a subclass of
<tagname>baselistitem</tagname> to use instead
+ of the <tagname>radiobutton</tagname> class.
+ </p>
+
+ <seealso>
+ <tags>radiobutton baselistitem</tags>
+ <component-design id="radio" title="Radio Button"/>
+ </seealso>
+ </text>
+ </doc>
</class>
<!--- Implements a "radio" button, allows a one-of-many selection when
_______________________________________________
Laszlo-checkins mailing list
[email protected]
http://www.openlaszlo.org/mailman/listinfo/laszlo-checkins
