analytics/webcontent/prompting/CMultipleTimePicker.js

/*
 *+------------------------------------------------------------------------+
 *| Licensed Materials - Property of IBM
 *| BI and PM: prmt
 *| (C) Copyright IBM Corp. 2002, 2011
 *|
 *| US Government Users Restricted Rights - Use, duplication or
 *| disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
 *|
 *+------------------------------------------------------------------------+
*/


/*
	CMultipleTextPicker.js

	This script is used to provide interactivity for the
	multiple select selectTime prompt component.  This component is
	a combination of the time picker and a list box.
*/

//Constructor to create a checkboxlist component
//	oTimePicker: the time picker control
//	oLstChoices: the name of the select form control
//	oSubmit: the form control to submit selections to the server
//  bRequired: is this a required field true/false
//  sSubmitType: submit this as a standard form, or as XML
//  oErrorFeedback: object used to provide validation feedback
//  oSizer: image object used to control the minimum size of the list
//  oInsertButton: the insert button
//  oRemoveButton: the remove button

function CMultipleTimePicker(oTimePicker, oLstChoices, oSubmit,  bRequired, sSubmitType, oErrorFeedback, oSizer, oInsertButton, oRemoveButton, sCVId)
{
	this.setCVId(sCVId);
	this.m_oTimePicker = oTimePicker;
	this.m_oLstChoices = oLstChoices;
	this.m_oSubmit = oSubmit;
	this.m_bRequired = bRequired;
	this.m_bValid = false;
	this.m_sSubmitType = sSubmitType;
	this.m_oErrorFeedback = oErrorFeedback;

	if (oInsertButton)
	{
		this.m_oInsertButton = oInsertButton;
	}

	if (oRemoveButton)
	{
		this.m_oRemoveButton = oRemoveButton;
	}

	this.checkData();
	//resize the list if necessary
	if(oSizer)
	{
		this.m_oSizer = oSizer;
		this.resizeList();
	}

	//check the states of the insert and remove buttons
	this.checkInsertRemove();
}

CMultipleTimePicker.prototype = new CPromptControl();

//add an item to the list without any checking by the control
//this method provides an efficient way to add items, but
//the update() method should be called to clean up the control
//when finished adding
function CMultipleTimePicker_addNoUpdate(sDisplayValue, sInsertText, sel)
{
	sDisplayValue = sDecodeU003( sDisplayValue );
	sInsertText = sDecodeU003( sInsertText );
	if (sel == true) {
		this.m_oLstChoices.options[this.m_oLstChoices.options.length] = new Option(sDisplayValue, sInsertText, true, true);
	}
	else {
		this.m_oLstChoices.options[this.m_oLstChoices.options.length] = new Option(sDisplayValue, sInsertText, false, false);
	}
}

//clean up the control
function CMultipleTimePicker_update()
{
	this.checkData();
	this.resizeList();
	this.resizeList();
	//check the states of the insert and remove buttons
	this.checkInsertRemove();
}

//select all items
function CMultipleTimePicker_selectAll()
{
	for (var i=0; i < this.m_oLstChoices.options.length; i++)
	{
		this.m_oLstChoices.options[i].selected =  true;
	}
	//check the states of the insert and remove buttons
	this.checkInsertRemove();
}

//remove selection from all items
function CMultipleTimePicker_deSelectAll()
{
	for (var i=0; i < this.m_oLstChoices.options.length; i++)
	{
		this.m_oLstChoices.options[i].selected =  false;
	}
	//check the states of the insert and remove buttons
	this.checkInsertRemove();
}

//insert values from the picker control
function CMultipleTimePicker_insert()
{
	var sDisplayValue = this.m_oTimePicker.sGetFormatTime ();
	var sUseValue = this.m_oTimePicker.sGetSQLTime();
	this.m_oLstChoices.options[this.m_oLstChoices.options.length] = new Option(sDisplayValue, sUseValue, false, false);
	this.checkData();
	this.resizeList();
	this.resizeList();
	//check the states of the insert and remove buttons
	this.checkInsertRemove();
}

//remove selections from the list of choices
function CMultipleTimePicker_remove()
{
	this.removeSelectedChoices();
	//check the states of the insert and remove buttons
	this.checkInsertRemove();
}

//perform any special processing for the server.
//this function will wrap all list items in XML.
//This is required for cases where the unselected items need
//to be submitted too.
function CMultipleTimePicker_preProcess()
{
	var i=0;
	if (this.m_sSubmitType == K_PRMT_sXML)
	{
		var sURLValues = K_PRMT_sEMPTY;
		if (this.m_oLstChoices.options.length > 0)
		{
			for(i = 0; i < this.m_oLstChoices.options.length; i ++)
			{

				sURLValues += '<selectOption';
				sURLValues += ' displayValue="' + sXmlEncode(this.m_oLstChoices.options[i].text) +'"';
				sURLValues += ' useValue="' + sXmlEncode(this.m_oLstChoices.options[i].value) + '"';
				if (this.m_oLstChoices.options[i].selected == true)
				{
					sURLValues += ' selected="true" />';
				}
				else
				{
					sURLValues += ' selected="false" />';
				}

			}
		}
		addSelectChoices(this.m_oSubmit, sURLValues);
	}
	else
	{
		//select all the choices so they can be submitted with the form
		for(i = 0; i < this.m_oLstChoices.options.length; i ++)
		{
			this.m_oLstChoices.options[i].selected = true;
		}
	}
}


//return true unless this is a required prompt
//and there are no values
function CMultipleTimePicker_checkData()
{
	if ((this.m_bRequired == true) && (this.m_oLstChoices.options.length === 0))
	{
		this.m_bValid = false;
		this.checkFail();
		return false;
	}
	else
	{
		this.m_bValid = true;
		this.checkPass();
		return true;
	}
}

//make sure that choices are always visible and set a minimum size
//resize the list to fit the data if required
//if there are no items, prevent the list from
//shrinking too small
//allow the list to expand to fit the biggest item
function CMultipleTimePicker_resizeList()
{
	if (this.m_oSizer)
	{
		this.m_oLstChoices.style.width='auto';
		if (this.m_oSizer.width < 200)
		{
			this.m_oLstChoices.style.width='200px';
		}
	}
}

//enable and disable the insert and remove buttons
//based on what the user has selected
function CMultipleTimePicker_checkInsertRemove()
{
	if (this.m_oInsertButton)
	{
		if ((this.m_oTimePicker.getValid() == true) && (this.m_oTimePicker.hasValue()))
		{
			this.m_oInsertButton.disabled = false;
		}
		else
		{
			this.m_oInsertButton.disabled = true;
			this.m_oInsertButton.className = "clsInsertRemoveButton";
		}
	}

	if (this.m_oRemoveButton)
	{
		if (this.m_oLstChoices.selectedIndex == -1)
		{
			this.m_oRemoveButton.disabled = true;
			this.m_oRemoveButton.className = "clsInsertRemoveButton";
		}
		else
		{
			this.m_oRemoveButton.disabled = false;
		}
	}
}

//Prototypes to assign methods to new instances of the object
CMultipleTimePicker.prototype.addNoUpdate = CMultipleTimePicker_addNoUpdate;
CMultipleTimePicker.prototype.update = CMultipleTimePicker_update;
CMultipleTimePicker.prototype.selectAll = CMultipleTimePicker_selectAll;
CMultipleTimePicker.prototype.deSelectAll = CMultipleTimePicker_deSelectAll;
CMultipleTimePicker.prototype.insert = CMultipleTimePicker_insert;
CMultipleTimePicker.prototype.remove = CMultipleTimePicker_remove;
CMultipleTimePicker.prototype.preProcess = CMultipleTimePicker_preProcess;
CMultipleTimePicker.prototype.checkData = CMultipleTimePicker_checkData;
CMultipleTimePicker.prototype.resizeList = CMultipleTimePicker_resizeList;
CMultipleTimePicker.prototype.checkInsertRemove = CMultipleTimePicker_checkInsertRemove;