Hi Jono,
There are three functions;
setProperty(node, property, value, type) to set or update a value
node is the field or subform to add the property to
(fields get a element in the <desc> element, subforms get a <variable> element
property is the name of the property
value is the value
type is one of the XFA types (see comments in code) ... this defaults to Text (or string)
getProperty(node, property, defaultValue) to return a value
node is the field or subform that holds the property
property is the name of the property
defaultValue optional (is returned if the value does not exist)
deleteProperty to delete value
node is the field or subform that holds the property
property is the name of the property
So if XFAUtil was the name of the script then this code would set an integer property "selectedIndex".
XFAUtil.setProperty(this, "selectedIndex", i, XFAUtil.ContentType.Integer);
Do an app.alert(this.saveXML("pretty")) afterwords to see what it has done.
So to get the value back use;
XFAUtil.setProperty(this, "selectedIndex")
The value returned will be a JavaScript equivilent of the XFA type passed in, which can avoid some problem. So if you specified Integer on the setProperty you will get a JavaScript Number value back. So in this example (if i was 10) then var si = XFAUtil.setProperty(this, "selectedIndex") + 10; would equal 20 ... not "1010" that it does if using form variables (as these are always strings).
I've been using it pretty much since John's post and haven't had any trouble.
Hope it Helps
Bruce
form1.#subform[0].#variables[0].XFAUtil - (JavaScript, client)
var ContentType = { Boolean : "boolean", // Creates an element with zero (true) or one (false)
Date : "date", // Seems to work as a string
DateTime : "dateTime", // Seems to work as a string
Decimal : "decimal",
ExData : "exData", // Seems to work as a string
Float : "float",
Image : "image",
Integer : "integer", // Carefull: this is a 32 bit signed integer, JavaScript only has a float so some truncation can occur
Text : "text",
Time : "time" // Seems to work as a string
}
/*
* Sets a custom property against a field or subform.
* @param {field or subform} node The field or subform to hold the value.
* @param {string} property The name of the property.
* @param {object} value The value of the property.
* @param {ContentType} type The type of the property.
*/
function setProperty(node, property, value, type)
{
// Debug.trace(arguments);
var item;
if (type == undefined) type = XFAUtil.ContentType.Text;
if (node.className == "subform")
{
item = node.variables.nodes.namedItem(property);
if (item == null)
{
item = xfa.form.createNode(type, property);
node.variables.nodes.append(item);
}
}
else
{
item = node.desc.nodes.namedItem(property);
if (item == null)
{
item = xfa.form.createNode(type, property);
node.desc.nodes.append(item);
}
}
if (typeof(value) === "boolean")
{
// "item.value" is typed so avoid the toString() below, otherwise we'll always be false;
item.value = value;
}
else
{
// Some not very JavaScript like conversions (or lack of them) going on here ... so use toString()
item.value = value.toString();
}
}
/*
* Gets a custom property against a field or subform.
* @param {field or subform} node The field or subform containing the value.
* @param {string} property The name of the property.
* @param {object} defaultValue The default value of the property if it does not exist.
* @return The value of the object typed as per comments above
*/
function getProperty(node, property, defaultValue)
{
// Debug.trace(arguments);
var childNode;
if (node.className == "subform")
{
childNode = node.variables.nodes.namedItem(property);
}
else
{
childNode = node.desc.nodes.namedItem(property);
}
if (childNode === null)
{
if (defaultValue === undefined)
return null;
else
return defaultValue;
}
else
{
return childNode.value;
}
}
/*
* Deletes a custom property against a field or subform.
* @param {field or subform} node The field or subform containing the value.
* @param {string} property The name of the property.
*/
function deleteProperty(node, property)
{
// Debug.trace(arguments);
if (node.className == "subform")
{
var item = node.variables.nodes.namedItem(property);
if (item !== null)
{
node.variables.nodes.remove(item);
}
}
else
{
var item = node.desc.nodes.namedItem(property);
if (item !== null)
{
node.desc.nodes.remove(item);
}
}
}
