// Description:	This file contains all the functions neccessary to interact with a listbox (known as a combo box in
//			Visual Basic).
// Written by:	Dave Henderson
// Email:		dhenderson@cliquesoftware.com
// File created:	07/25/04 by Dave Henderson (dhenderson@cliquesoftware.com)
// File updated:	10/30/07 by Dave Henderson (dhenderson@cliquesoftware.com)


function ListSort(objListBox) {							// sorts listbox in order (alphabatizes)
// Sorts the entries in a passed ListBox
  var i;
  var sArray = new Array();

  for (i=0; i<objListBox.options.length; i++) { 				// this for loop copies all the names from the listbox to the array
    sArray[i] = new Array(2);
    sArray[i][0] = objListBox.options[i].text;
    sArray[i][1] = objListBox.options[i].value;
  }
  sArray.sort();
  for (i=0; i<sArray.length; i++) {
    objListBox.options[i].text = sArray[i][0];
    objListBox.options[i].value = sArray[i][1];
  }
}


function Add2List(strText, objListBox, OptionValue, intSortList, intNoDoubles) {
// This function adds the passed text to a ListBox object.  If any text boxes are appended to the arguments of a function
// call, there contents will be cleared.
// strText:		The text of the entry you want displayed in the listbox.
// objListBox:	The actual listbox object you want to add the entry to.
// OptionValue:	This will give a "index" value to the entry being added.  A '-1' will autoincrement.  This can also be a string.
// intSortList:	Allows the listbox to resort its entries in alphabetical order (a value of 1 will sort).
// intNoDoubles:	Prevents the addition of duplicate entries (a value of 1 will prevent).
// object list:	Any form objects appended to the end of the parameters will be cleared (textboxes only).
  var newEntry = new Option();
  var i;

  if (intNoDoubles == 1) {								// code block used to prevent the addition of duplicate "records"
    for (i=0; i<objListBox.options.length; i++)
	{ if (objListBox.options[i].text == strText) { alert('You already have the entry "' + objListBox.options[i].text + '" added to the list.'); return 0; } }
  }

  if (strText != "") {									// IF strText contains an actual value, then...
    if (OptionValue == -1)								// IF the user wants an autoincrement, then..
      { newEntry.value = objListBox.options.length; }				// add the next highest number
    else											// ELSE IF the user specified a value...
      { newEntry.value = OptionValue; }						// assign it to the entry
    newEntry.text  = strText;								// this is the listbox entry's display text
    objListBox[objListBox.options.length] = newEntry;
    if (intSortList == 1) { ListSort(objListBox); }				// sorts list after user adds a new entry (if specified)
    for (i=2; i<arguments.length; i++)						// cycles through all remaining passed objects (after the ones specified above) to the function and clears their value property.
      { arguments[i].value = ""; }
    return 1;										// returns true if all works
  }
  return 0;											// returns fail if not
}


function ListReplace(strValue2Check,strEntry2Replace, strText, objListBox, OptionValue, intSortList, intPrompt) {
// This function replaces the entry thats matched the information passed into the function.  If any textboxes or listboxes are appended to the arguments of this
// function call, there contents will be cleared or set to default values.
// strValue2Check:   This is option identifies which listbox value you wish to compare against.  Valid values are: "text" -or- "value".
// strEntry2Replace: This is the VALUE of the entry you wish to replace with the other passed parameters.
// strText:		The text you want to replace the original entry in the listbox with.
// objListBox:	The actual listbox object you want to add the entry to.
// OptionValue:	This gives the entry a value.  If it is left blank, the prior value will remain.
// intSortList:	Allows the listbox to resort its entries in alphabetical order (a value of 1 will sort).
// intPrompt:	This allows an overwrite prompt to appear for user confirmation before actually processing.
// object list:	The values of the textboxes or listboxes appended to the end of the parameters list will have their value changed (to the next value - i+1) after the
//			entry has be updated/saved.  See the examples below to get an idea of appended parameters:
//			ListReplace('entryname','newEntryName',document.form.listbox,'newValue',1,1,document.form.greeting,'')	this will reset the username textbox to blank
//			ListReplace('entryname','newEntryName',document.form.listbox,'newValue',1,1,document.form.greeting,'Hello')	this will reset the username textbox to 'Hello'
  var i, found = false, newEntry = new Option();

   if (intPrompt == 1) {
	if (objListBox.options.selectedIndex == -1) { alert('You must select an entry from the listbox before you\ncan save any changes.'); return 0; }
	if (window.confirm('Are you sure you want to overwrite?') == false) { return 0; }
   }
   for (i=0; i<objListBox.options.length; i++) {
	if (strValue2Check == "value" && objListBox.options[i].value == strEntry2Replace) { found = true; }			// we have found the listbox entry to replace!
	else if (strValue2Check == "text" && objListBox.options[i].text == strEntry2Replace) { found = true; }		// we have found the listbox entry to replace!
	if (found == true) {
	   objListBox.options[i].text = strText;
	   if (OptionValue != '') { objListBox.options[i].value = OptionValue; }
	   if (intSortList == 1) { ListSort(objListBox); }			// sorts list after user adds a new entry (if specified)
	   for (i=6; i<arguments.length; i=i+2) {					// sets the textbox values after the entry is added to the listbox
		if (arguments[i].type == "text") {
		   arguments[i].value = arguments[i+1];
		} else if (arguments[i].type == "select" || arguments[i].type == "select-one" || arguments[i].type == "select-multiple") {
		   for (j=0; j<arguments[i].options.length; j++)
			{ if (arguments[i].options[j].value == arguments[i+1]) { arguments[i].selectedIndex = j; break; } }
		}
	   }
	   if (arguments.length > 6) { objListBox.selectedIndex = -1; }	// if the user decided to reset values of textboxes, unselect the entry in the listbox
	   return 1;									// returns true if all works
	}
   }
   return 0;										// returns fail if not
}


function ListRemove(objListBox, boolPrompt) {
// this function removes the selected entry from the listbox being passed into the function.
  var i;
  var moveUp = 0;

  if (objListBox.selectedIndex == -1) { return 0; }				// error checking (if the user hasn't selected an item in the passed listbox)
  if (boolPrompt == true) { if(window.confirm('Are you sure you want to delete the entry?') == false) { return 0; } }
  for (i=0; i<objListBox.options.length; i++) {					// cycles through all the entries in the list box
    if ((objListBox.options[i].selected) && (objListBox.options[i] != ""))	// finds the one the user selected
	{ moveUp = 1; }									// indicates we need to move all the entries aftwards, up in the list
    if ((moveUp == 1) && (i <= (objListBox.options.length - 2))) {
	objListBox.options[i].value = objListBox.options[i + 1].value;	// copies over the value from the above entry, down
	objListBox.options[i].text  = objListBox.options[i + 1].text;	// copies over the text from the above entry, down
    }
  }
  if (moveUp == 1) {									// if we successfully deleted an entry
    objListBox.options.length--;							// shorten the listbox by one
    return 1;										// return success
  }
  return 0;											// returns fail if not
}


function ListRemove2(objListBox, intIndex, boolPrompt) {
// this function removes the passed "index" entry from the listbox.  For example, if you know you want entry number 4
// removed from the listbox, then call this function as:  ListRemove2(document.form.listboxname, 4);
// intIndex: specifies which line to remove
  var i;

  if (boolPrompt == true) { if(window.confirm('Are you sure you want to delete the entry?') == false) { return 0; } }
  for (i=intIndex; i<objListBox.options.length-1; i++) {			// cycles through all the entries in the list box
    objListBox.options[i].value = objListBox.options[i + 1].value;	// copies over the value from the above entry, down
    objListBox.options[i].text  = objListBox.options[i + 1].text;		// copies over the text from the above entry, down
  }
  objListBox.options.length--;							// shorten the listbox by one
}


function ListRemove3(objListBox, boolKeepSelectedItem, boolKeepItemValues, boolPrompt) {
// This function removes multiple items from a listbox.
// objListBox:		The actual listbox object you want to remove the entry(s) from.
// boolKeepSelectedItem:	This value specifies what type of item to keep.  True = selected items in the list, Fasle = unselected items in the list.
// boolKeepItemValues:	setting true retains the <option value=""> values from the items left in the list.
// boolPrompt:		Prompts the user if they are sure they want to remove the selected item(s) before continuing.
  var i;
  var aryNew = new Array();

  if (boolPrompt == true) { if(window.confirm('Are you sure you want to delete the entry?') == false) { return 0; } }
  aryNew.length = 0;
  for (i=0; i<objListBox.options.length; i++) {
    // if the item has a selected value that equals what the user specified  AND  the user specified not to keep the option values, then...
    if ((objListBox.options[i].selected == boolKeepSelectedItem) && (boolKeepItemValues == false)) {
      aryNew.length++;
      aryNew[aryNew.length-1] = objListBox.options[i].text;			// copies over the text from the current entry

    } else if ((objListBox.options[i].selected == boolKeepSelectedItem) && (boolKeepItemValues == true)) {
      aryNew.length += 2;
      aryNew[aryNew.length-2] = objListBox.options[i].value;		// copies over the value from the current entry
      aryNew[aryNew.length-1] = objListBox.options[i].text;			// copies over the text from the current entry
    }
  }
  objListBox.options.length = 0;							// resets the passed listbox entry count to 0
  for (i=0; i<aryNew.length; i++) {							// copies the "saved" entries back into the listbox
    if (boolKeepItemValues == false)						// only copies the text portion
      { Add2List(aryNew[i], objListBox, -1, 1); }
    else											// copies both the text and option values
      { Add2List(aryNew[i+1], objListBox, aryNew[i], 1); i++; }
  }
}


function ListRemove4(strValue2Check, strEntry2Remove, objListBox, boolPrompt) {
// this function cycles through all the entries in the passed listbox and finds the one to remove
// strValue2Check:	This is option identifies which listbox value you wish to compare against.  Valid values are: "text" -or- "value".
// strEntry2Replace:	This is the VALUE of the entry you wish to replace with the other passed parameters.
// objListBox:		The actual listbox object you want to remove the entry from.
// boolPrompt:		Prompts the user if they are sure they want to remove the selected item(s) before continuing.
  var i, found=false;

   if (boolPrompt == true) { if(window.confirm('Are you sure you want to delete the entry?') == false) { return 0; } }
   for (i=0; i<objListBox.options.length-1; i++) {				// cycles through all the entries in the list box
	if (strValue2Check == "value" && objListBox.options[i].value == strEntry2Remove) { found = true; }		// we have found the listbox entry to replace!
	else if (strValue2Check == "text" && objListBox.options[i].text == strEntry2Remove) { found = true; }		// we have found the listbox entry to replace!
	if (found == true) {
	   objListBox.options[i].value = objListBox.options[i + 1].value;	// copies over the value from the above entry, down
	   objListBox.options[i].text  = objListBox.options[i + 1].text;	// copies over the text from the above entry, down
	}
   }
   objListBox.options.length--;							// shorten the listbox by one
}


function ListPlacement(objListBox, strAdjustType) {
// This function allows the user to move a selected item either up or down in a list.
  var i, j, priorValue;

  if (strAdjustType == "up") {
    if ((objListBox.selectedIndex == -1) || (objListBox.selectedIndex == 0)) { return 0; }	// exit function if the user didn't select a server ip or he/she is trying to move up the first ip
    priorValue = objListBox.options[objListBox.selectedIndex-1].text;					// set the value of the listbox item thats one position up from the selected item, to the variable
    objListBox.options[objListBox.selectedIndex-1].text = objListBox.options[objListBox.selectedIndex].text;	// set the value of the listbox item up one position to the value of the selected item
    objListBox.options[objListBox.selectedIndex].text = priorValue;					// set the value of the selected listbox item to the priorValue variable
    objListBox.selectedIndex = objListBox.selectedIndex-1;							// this allows the highlight to follow the item being moved
      
  } else if (strAdjustType == "down") {
    if ((objListBox.selectedIndex == -1) || (objListBox.selectedIndex == objListBox.options.length-1)) { return 0; }	// exit function if the user didn't select a server ip or he/she is trying to move down the last ip
    priorValue = objListBox.options[objListBox.selectedIndex+1].text;					// same as above, but in reverse
    objListBox.options[objListBox.selectedIndex+1].text = objListBox.options[objListBox.selectedIndex].text;
    objListBox.options[objListBox.selectedIndex].text = priorValue;
    objListBox.selectedIndex = objListBox.selectedIndex+1;							// this allows the highlight to follow the item being moved
  }
}


function ListPlacement2(objListBox, strAdjustType) {
// This function allows the user to move a selected item either up or down in a list, but this one will retain values.
  var i, j, priorText, priorValue;

  if (strAdjustType == "up") {
    if ((objListBox.selectedIndex == -1) || (objListBox.selectedIndex == 0)) { return 0; }	// exit function if the user didn't select a server ip or he/she is trying to move up the first ip
    priorText = objListBox.options[objListBox.selectedIndex-1].text;					// set the value of the listbox item thats one position up from the selected item, to the variable
    priorValue = objListBox.options[objListBox.selectedIndex-1].value;
    objListBox.options[objListBox.selectedIndex-1].text = objListBox.options[objListBox.selectedIndex].text;	// set the value of the listbox item up one position to the value of the selected item
    objListBox.options[objListBox.selectedIndex-1].value = objListBox.options[objListBox.selectedIndex].value;
    objListBox.options[objListBox.selectedIndex].text = priorText;					// set the value of the selected listbox item to the priorText variable
    objListBox.options[objListBox.selectedIndex].value = priorValue;
    objListBox.selectedIndex = objListBox.selectedIndex-1;							// this allows the highlight to follow the item being moved
      
  } else if (strAdjustType == "down") {
    if ((objListBox.selectedIndex == -1) || (objListBox.selectedIndex == objListBox.options.length-1)) { return 0; }	// exit function if the user didn't select a server ip or he/she is trying to move down the last ip
    priorText = objListBox.options[objListBox.selectedIndex+1].text;					// same as above, but in reverse
    priorValue = objListBox.options[objListBox.selectedIndex+1].value;
    objListBox.options[objListBox.selectedIndex+1].text = objListBox.options[objListBox.selectedIndex].text;
    objListBox.options[objListBox.selectedIndex+1].value = objListBox.options[objListBox.selectedIndex].value;
    objListBox.options[objListBox.selectedIndex].text = priorText;
    objListBox.options[objListBox.selectedIndex].value = priorValue;
    objListBox.selectedIndex = objListBox.selectedIndex+1;							// this allows the highlight to follow the item being moved
  }
}