/*************************************************************************
*
* ADOBE CONFIDENTIAL
* ___________________
*
* Copyright 2012 Adobe Systems Incorporated
* All Rights Reserved.
*
* NOTICE: All information contained herein is, and remains
* the property of Adobe Systems Incorporated and its suppliers,
* if any. The intellectual and technical concepts contained
* herein are proprietary to Adobe Systems Incorporated and its
* suppliers and are protected by trade secret or copyright law.
* Dissemination of this information or reproduction of this material
* is strictly forbidden unless prior written permission is obtained
* from Adobe Systems Incorporated.
*
**************************************************************************/
/**
* This object represents an Acrobat form field (that is, a field created using the Acrobat
* form tool or the Doc addField method). In the same manner that a form author can modify an
* existing field's properties, the JavaScript user can use the Field object to perform the
* same modifications.
*
* @class Field
* @param name {String} The name of the field.
*/
function Field(name)
{
this.name = name;
};
Field.prototype =
{
/**
* Returns the type of the field as a string.
*
* @property type
* @type {String}
* @readonly
*/
get type()
{
return window._field.getType(this.name);
},
/**
* The value of the field data that the user has entered. Depending on the type of the field,
* may be a String, Date, or Number. Typically, the value is used to create calculated fields.
*
* @property value
* @type {Any}
*/
get value()
{
var val = window._field.getValue(this.name);
if ((window._field.isNumberFormatType(this.name) || !isNaN(val)) && val != "")
val = parseFloat(val);
return val;
},
set value(_val)
{
window._field.setValue(_val, this.name);
},
/**
* The foreground color of a field. It represents the text color for text, button,
* or list box fields and the check color for check box or radio button fields. Values
* are defined by Color arrays.
*
* @private
* @property textColor
* @type {Object}
*/
set textColor(_textColor)
{
if (_textColor.length >= 2 && typeof _textColor[0] == "string" && _textColor[0] == "G" &&
typeof _textColor[1] == "number")
{
window._field.setGrayTextColor(_textColor[1], this.name);
}
else if (_textColor.length >= 4 && typeof _textColor[0] == "string" && _textColor[0] == "RGB" &&
typeof _textColor[1] == "number" && typeof _textColor[2] == "number" && typeof _textColor[3] == "number")
{
window._field.setRGBTextColor(_textColor[1], _textColor[2], _textColor[3], this.name);
}
}
};
/**
* Gets the array of terminal child fields (that is, fields that can have a value) for
* this Field object, the parent field.
*
* @method getArray
* @return {Object} An array of Field objects.
*/
Field.prototype.getArray = function()
{
var returnVal;
// get the comma separated field names from native
var fieldNames = window._field.getArray(this.name);
if (!isNullOrUndefined(fieldNames) && fieldNames.length > 0)
{
returnVal = new Array();
// split the comma separate field names and create field object
// using each field name
var fieldNameArray = fieldNames.split(",");
for (var i = 0; i<fieldNameArray.length; i++)
{
returnVal[i] = new Field(fieldNameArray[i]);
}
}
return returnVal;
};
/**
* Sets the focus to this field. This can involve changing the page that the user is
* currently on or causing the view to scroll to a new position in the document.
*
* @method setFocus
*/
Field.prototype.setFocus = function()
{
window._field.setFocus(this.name);
};
//register undefined properties on the Field.prototype object
registerUndefinedProperty(Field.prototype, 'Field', 'alignment');
registerUndefinedProperty(Field.prototype, 'Field', 'borderStyle');
registerUndefinedProperty(Field.prototype, 'Field', 'buttonAlignX');
registerUndefinedProperty(Field.prototype, 'Field', 'buttonAlignY');
registerUndefinedProperty(Field.prototype, 'Field', 'buttonFitBounds');
registerUndefinedProperty(Field.prototype, 'Field', 'buttonPosition');
registerUndefinedProperty(Field.prototype, 'Field', 'buttonScaleHow');
registerUndefinedProperty(Field.prototype, 'Field', 'buttonScaleWhen');
registerUndefinedProperty(Field.prototype, 'Field', 'calcOrderIndex');
registerUndefinedProperty(Field.prototype, 'Field', 'charLimit');
registerUndefinedProperty(Field.prototype, 'Field', 'comb');
registerUndefinedProperty(Field.prototype, 'Field', 'commitOnSelChange');
registerUndefinedProperty(Field.prototype, 'Field', 'currentValueIndices');
registerUndefinedProperty(Field.prototype, 'Field', 'defaultStyle');
registerUndefinedProperty(Field.prototype, 'Field', 'defaultValue');
registerUndefinedProperty(Field.prototype, 'Field', 'doNotScroll');
registerUndefinedProperty(Field.prototype, 'Field', 'doNotSpellCheck');
registerUndefinedProperty(Field.prototype, 'Field', 'delay');
registerUndefinedProperty(Field.prototype, 'Field', 'display');
registerUndefinedProperty(Field.prototype, 'Field', 'doc');
registerUndefinedProperty(Field.prototype, 'Field', 'editable');
registerUndefinedProperty(Field.prototype, 'Field', 'exportValues');
registerUndefinedProperty(Field.prototype, 'Field', 'fileSelect');
registerUndefinedProperty(Field.prototype, 'Field', 'fillColor');
registerUndefinedProperty(Field.prototype, 'Field', 'hidden');
registerUndefinedProperty(Field.prototype, 'Field', 'highlight');
registerUndefinedProperty(Field.prototype, 'Field', 'lineWidth');
registerUndefinedProperty(Field.prototype, 'Field', 'multiline');
registerUndefinedProperty(Field.prototype, 'Field', 'multipleSelection');
registerUndefinedProperty(Field.prototype, 'Field', 'numItems');
registerUndefinedProperty(Field.prototype, 'Field', 'page');
registerUndefinedProperty(Field.prototype, 'Field', 'password');
registerUndefinedProperty(Field.prototype, 'Field', 'print');
registerUndefinedProperty(Field.prototype, 'Field', 'radiosInUnison');
registerUndefinedProperty(Field.prototype, 'Field', 'readonly');
registerUndefinedProperty(Field.prototype, 'Field', 'rect');
registerUndefinedProperty(Field.prototype, 'Field', 'required');
registerUndefinedProperty(Field.prototype, 'Field', 'richText');
registerUndefinedProperty(Field.prototype, 'Field', 'richValue');
registerUndefinedProperty(Field.prototype, 'Field', 'rotation');
registerUndefinedProperty(Field.prototype, 'Field', 'strokeColor');
registerUndefinedProperty(Field.prototype, 'Field', 'style');
registerUndefinedProperty(Field.prototype, 'Field', 'submitName');
registerUndefinedProperty(Field.prototype, 'Field', 'textFont');
registerUndefinedProperty(Field.prototype, 'Field', 'textSize');
registerUndefinedProperty(Field.prototype, 'Field', 'userName');
registerUndefinedProperty(Field.prototype, 'Field', 'valueAsString');
