Initialize

Event fired when the WebTextEdit was initialized. It can be used to customize its appearance and behavior.

Reference to the JavaScript object that represents WebTextEdit.

The following example shows the event being used.

function initializeInEdit(oEdit)
{
	alert("Init Edit: " + oEdit.ID);
}

ValueChange

Event fired when control loses the input focus and new value in control is defferent from old value (before focus was set).

Reference to the JavaScript object that represents WebTextEdit.

Old value

Reference to the ig_EventObject object.

The following example shows the event being used.

function valueChangeInEdit(oEdit, oldValue, oEvent) 
{
	if(oldValue == "ok" && oEdit.getValue() == "") 
	// restore old value oEvent.cancel = true; 
	// trigger postback of page 
	if(oEdit.getText() == "post me to server") 
		oEvent.needPostBack = true; 
} 

TextChanged

Event fired on every change in the text that appears in the input field. It can be keypress, spin, etc.

reference to the JavaScript object that represents WebTextEdit.

old value

reference to the ig_EventObject object.

The following example shows the event being used.

function textChangedInEdit(oEdit, newText, oEvent)
{
	status = oEdit.ID + "  text:" + newText;
	// trigger postback of page
	if(newText == "ok")
		oEvent.needPostBack = true;
}

InvalidValue

Event fired when control loses the input focus and new value in control is invalid.

reference to the JavaScript object that represents WebTextEdit.

container of extra parameters related to invalid value. They are different for every particular control: see examples below.

reference to the ig_EventObject object.

The following example shows the event being used.

// example to process invalid value in WebNumericEdit
function invalidValueInNumericEdit(oEdit, fields, oEvent)
{
	var instantText = fields.text;
	var suggestedValue = fields.value;
	var typeOfInvalidText = fields.type;
	if(typeOfInvalidText == 0)
		alert("String can not be converted +
		  to a number. +
		  Null or 0 is used.");
	if(typeOfInvalidText == 1)
		alert("New value is out of +
		  Min/Max range of numbers. +
		  Min or max value is used.");
	if(typeOfInvalidText == 2)
		alert("Empty string was entered +
		  while null is not +
		  allowed. Value of 0 is used.");
	// prevent firing InvalidValue event 
	// on server except for range error
	if(typeOfInvalidText != 1)
		oEvent.cancel = true;
}

// example to process invalid value in WebDateTimeEdit
function invalidValueInDateTimeEdit(oEdit, fields, oEvent)
{
	var instantYear = fields.year;
	var instantMonth = fields.month;
	var instantDay = fields.day;
	var instantHours = fields.hours;
	var instantMinutes = fields.minutes;
	var instantSeconds = fields.seconds;
	var instantMilliseconds = fields.milliseconds;
	var suggestedDate = fields.date;
	var typeOfInvalidText = fields.type;
	if(typeOfInvalidText == 0)
		alert("String can not be +
		  converted to a date. +
		  Last good value is used.");
	if(typeOfInvalidText == 1)
		alert("New value is out of +
		  Min/Max range of dates. +
		  Min or max value is used.");
	if(typeOfInvalidText == 2)
		alert("1 or more field +
		  have invalid values.");
}

// example to process invalid value in WebMaskEdit
function invalidValueInNumericEdit(oEdit, fields, oEvent)
{
	var instantText = fields;
	alert("Not all required mask +
	  positions are filled.");
}

CustomButtonPress

Event fired when custom button was pressed.

reference to the JavaScript object that represents WebTextEdit.

text value

reference to the ig_EventObject object.

The following example shows the event being used.

function focusInEdit(oEdit, text, oEvent)
{
	status = "Focus in " + oEdit.ID;
}

Focus

Event fired when control gets input focus, but before it adjusts internal variables and builds the focus-state text.

reference to the JavaScript object that represents WebTextEdit.

text value

reference to the ig_EventObject object.

The following example shows the event being used.

function textChangedInEdit(oEdit, newText, oEvent)
{
	status = oEdit.ID + "  text:" + newText;
	// trigger postback of page
	if(newText == "ok")
		oEvent.needPostBack = true;
}

Blur

Event fired when control loses input focus, but before it adjusts internal variables and builds the no-focus-state text.

reference to the JavaScript object that represents WebTextEdit.

text value

reference to the ig_EventObject object.

MouseDown

Event fired when control receives "mousedown" event of a browser over the input-field.

reference to the JavaScript object that represents WebTextEdit.

text value

reference to the ig_EventObject object.

The following example shows the event being used.

function mouseDownInEdit(oEdit, text, oEvent)
{
	status = "MouseDown in:" + 
	  oEdit.ID + ", mouse-button:" + 
	    oEvent.event.button;
}

KeyDown

Event fired when control receives the "keydown" event of a browser, but before it starts to process it.

reference to the JavaScript object that represents WebTextEdit.

integer that equals to the key-code of keyboard entry which is supplied by a browser

reference to the ig_EventObject object.

The following example shows the event being used.

function keyDownInEdit(oEdit, keyCode, oEvent)
{
	// ignore the Space key
	if(keyCode == 32)
		oEvent.cancel = true;
	// trigger postback of page on Escape key
	if(keyCode == 27)
		oEvent.needPostBack = true;
}

KeyPress

Event fired when control receives the "keypress" event of a browser, but before it starts to process it.

reference to the JavaScript object that represents WebTextEdit.

integer that equals to the key-code of keyboard entry which is supplied by a browser

reference to the ig_EventObject object.

The following example shows the event being used.

function keyPressInEdit(oEdit, keyCode, oEvent)
{
	// ignore the "0" character
	if(keyCode == 48)
		oEvent.cancel = true;
	// ignore the "A" and "a" characters
	if(keyCode == 65 || keyCode == 97)
		oEvent.cancel = true;
	// if the "b" was entered, 
	// then replace it by the "B"
	if(keyCode == 98)
		oEvent.keyCode = 66;
}

Spin

Event fired before value is incremented or decremented by a spin button or by up/down arrow key.

reference to the JavaScript object that represents WebTextEdit.

numeric value that is used to perform the "+=" operation with the current value in control. It can be positive or negative depending on the incerement or decrement.

reference to the ig_EventObject object.

The following example shows the event being used.

function spinInCurrency(oEdit, delta, oEvent)
{
	if(oEdit.getValue() > 1000 && delta > 0)
		oEvent.cancel = true;
	status = "Spin. OldValue:" + oEdit.getValue() + 
	  ", delta:" + delta;
}