Class %ZEN.Component.select

class %ZEN.Component.select extends listControl

A select list control.
This control is based on the HTML select element.
Setting readOnly to true has the same effect as disabling this component; this is the standard HTML behavior for select controls.

Inventory

Parameters	Properties	Methods	Queries	Indices	ForeignKeys	Triggers
1	2	5

Summary

Properties
%condition	%import	%includeFiles	%page
%resource	align	aux	clientType
composite	containerStyle	controlClass	controlStyle
dataBinding	disabled	displayList	dragEnabled
dropEnabled	enclosingClass	enclosingStyle	error
height	hidden	hint	hintClass
hintStyle	id	index	invalid
invalidMessage	label	labelClass	labelDisabledClass
labelStyle	maxRows	name	onafterdrag
onbeforedrag	onblur	onchange	onclick
ondblclick	ondrag	ondrop	onfocus
onhide	onkeydown	onkeypress	onkeyup
onmousedown	onmouseout	onmouseover	onmouseup
onrefresh	onshow	onsubmit	onupdate
onvalidate	originalValue	parameters	parent
queryClass	queryName	readOnly	required
requiredMessage	showEmpty	showLabel	size
slice	sql	tabIndex	title
tuple	valign	value	valueList
visible	width	window

Methods
%%OIDGet	%AddToSaveSet	%Attr	%BindExport
%BuildValueLists	%ClassIsLatestVersion	%ClassName	%ConstructClone
%DispatchClassMethod	%DispatchGetModified	%DispatchGetProperty	%DispatchMethod
%DispatchSetModified	%DispatchSetMultidimProperty	%DispatchSetProperty	%DrawComponentHTML
%DrawHTML	%DrawJSStrings	%EnclosingDivId	%Eval
%Extends	%ForceClientRender	%GetEventHandlers	%GetForm
%GetParameter	%GetXMLName	%IsA	%IsModified
%MakeId	%Name	%New	%NormalizeObject
%ObjectModified	%OnAddToPageAfter	%OnAddToPageBefore	%OnDrawEnclosingDiv
%OnDrawObjectProperties	%OnObjectSynch	%OnZENDeserialize	%OriginalNamespace
%PackageName	%QuoteValue	%QuoteValueL10N	%RemoveFromSaveSet
%Self	%SerializeObject	%SetDefaultValues	%SetModified
%ValidateObject	XMLDTD	XMLExport	XMLExportToStream
XMLExportToString	XMLNew	XMLSchema	XMLSchemaNamespace
XMLSchemaType	dragFinishHandler	dragHandler	dragNotifyHandler
dragStartHandler	dropHandler	dropStartHandler	exposeComponent
findElement	fireOnUpdateEvent	focus	formatValue
getDisabled	getDragData	getEnclosingDiv	getForm
getHidden	getHintElement	getInvalidReason	getLabelElement
getOptionText	getOptionValue	getProperty	getReadOnly
getSelectedIndex	getSettings	getType	getValue
invokeSuper	isModified	isOfType	isValid
makeId	normalizeValue	onCreate	onDelete
onDisplayHandler	onEndModalHandler	onPopupAction	onRefreshContents
onSerialize	onStartModalHandler	onchangeHandler	onloadHandler
onunloadHandler	onupdateHandler	refreshContents	render
renderContents	renderSVG	select	setDisabled
setHidden	setOverlayMode	setProperty	setReadOnly
setValue	startProgressBar	stopProgressBar	sysName
unformatValue	validationHandler

Parameters

• parameter DEFAULTCONTROLCLASS = "select";

The default css class used for the main element within this control. This is overridden by subclasses.

Properties

• property showEmpty as %ZEN.Datatype.boolean [ InitialExpression = 1 ];

If true (the default), insert an extra blank row (with value = "") at the top of the dropdown.

• property size as %ZEN.Datatype.integer(MINVAL=0);

Number of rows in the select control.

Methods

• method %DrawHTML()

Static HTML display method: draw the BODY of this component as HTML.
Subclasses implement this in order to render the static HTML contents of a component.

• method getOptionText(idx) [ Language = javascript ]

Return the display text for the given item (0-based) in the dropdown list.

• method getOptionValue(idx) [ Language = javascript ]

Return the logical value of the given item (0-based) in the dropdown list.

• method getSelectedIndex(idx) [ Language = javascript ]

Return the index of the current selected item (0-based) in the select component. Returns -1 is no item is selected.

• method setProperty(property, value, value2) [ Language = javascript ]

Set the value of a named property.


[BASEXML] > [%ZEN] > [Component] > [select]		Private Storage