
	//===============================================================================
	//	FUNCTION:	FSS_SetFocus
	// 
	//	INPUT: 		<nothing>
	//
	//	RETURN:		Did we set the focus to an item or not ?
	//				( True; False; )
	//
	//	DESC:		This function is used with client-side JavaScript to set the
	//				focus to the first 'Item' on the first form.
	//
	//	PLATFORMS:	Netscape Navigator 3.01 and higher,
	//			  	Microsoft Internet Explorer 3.02 and higher,
	//
	//	Used In:
	//
	// <BODY onLoad="return setFocus()"> 
	// <input type=reset value="Reset" onClick="return setFocus()"> 
	//
	//===============================================================================
	function FSS_SetFocus()
	{
		var bRtrn = false;

		// - Loop through all the forms.
		for (var frm = 0; frm < document.forms.length; frm++)
		{
			for (var fld = 0; fld < document.forms[frm].elements.length; fld++)
			{
				if (FSS_Control_SetFocus(frm, document.forms[frm].elements[fld].name)) break;
			}  //  for (var fld = 0; fld < document.forms[frm].elements.length; fld++)
		}  //  for (var frm = 0; frm < document.forms.length; frm++)

		return (bRtrn);
	}  //  FSS_SetFocus

	function FSS_Control_SetFocus(nFormNumber, strControlID)
	{
		var bRtrn = false;
	
		// - Does this control even exist ?
		if (!IsNull(strControlID))
		{
			if (!IsNull(document.forms[nFormNumber]))
			{
				if (!IsNull(document.forms[nFormNumber].item(strControlID)))
				{
					// <FSSI: TRC 083004> Focus issues when controls are disabled
					if (!document.forms[nFormNumber].item(strControlID).disabled)
					{
						var elt = document.forms[nFormNumber].elements[strControlID];

						// skip buttons, radio, or check-boxes
						// to skip "select" types, remove from if statement
						if ((elt.type == "text") ||
					 		(elt.type == "textarea") ||
							(elt.type == "select-one") ||
							(elt.type == "select-multiple")) 
						{
							elt.focus();
							// select text in text field or textarea
							if (elt.type.indexOf("text") != -1) elt.select();
							
							bRtrn = true;
						}
					}  //  if (!document.forms[nFormNumber].item(strControlID).disabled)
				}  //  if (!IsNull(document.forms[nFormNumber].item(strControlID)))
			}  //  if (!IsNull(document.forms[nFormNumber]))
		}  //  if (!IsNull(strControlID))
				
		return (bRtrn);
	}  //  FSS_Control_SetFocus
