/**
 * Retrieves all form elements in the document that match the given element name.
 * This method will search through *all* forms in the document !
 *
 * @param elementName The name of the form field to look for
 * @return An Array containing the form-element-objects
 */
function findElements(elementName)
{
	var res = new Array();
	for ( var i=0; i<document.forms.length; i++ )
	{
		var curForm = document.forms[i];
		for (var j=0; j<curForm.elements.length; j++)
		{
			var curElement = curForm.elements[j];
			if ((curElement.name) && (curElement.name.indexOf(elementName) == 0))
			{
				res[res.length] = curElement;
			}
		}
	}
	return res;
}

/**
 * Retrieves the first form element found in the document that matches the given element name.
 *
 * @param elementName The name of the form field to look for
 * @return The first form-element found
 */
function findElement(elementName)
{
	for (var i=0; i<document.forms.length; i++)
	{
		var curForm = document.forms[i];
		for (var j=0; j<curForm.elements.length; j++)
		{
			var curElement = curForm.elements[j];
			if ((curElement.name) && (curElement.name == elementName))
			{
				return curElement;
			}
		}
	}
	return null;
}

/**
 * Retrieves the first form element found in the document that matches the given element name.
 *
 * @param elementName The name of the form field to look for
 * @return The first form-element found
 */
function findFormByElement(elementName, owner)
{
	if (owner == null)
	{
		owner = self;
	}
	
	for (var i=0; i<owner.document.forms.length; i++)
	{
		var curForm = owner.document.forms[i];
		for (var j=0; j<curForm.elements.length; j++)
		{
			var curElement = curForm.elements[j];
			if ((curElement.name) && (curElement.name == elementName))
			{
				return curForm;
			}
		}
	}
	return null;
}

function getSelectorValue(selector)
{
	if (selector != null)
	{
		return selector.options[selector.selectedIndex].value;
	}
	return null;
}

function clearSelector(selector)
{
	if (selector != null)
	{
		while (selector.options.length)
		{
			selector.options[0] = null;
		}
	}	
}

function addOption(selector, value, text)
{
	if (selector != null)
	{
		selector.options[selector.options.length] = new Option(text, value, false, false);
	}
}