Class %ZEN.Component.select

deprecatedclass %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	3	5

Summary

Properties
%condition	%import	%includeFiles	%page
%resource	align	aux	choiceColumn
clientType	composite	containerStyle	controlClass
controlStyle	dataBinding	disabled	displayList
dragEnabled	dropEnabled	emptyText	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	ontouchend	ontouchmove	ontouchstart
onupdate	onvalidate	originalValue	parameters
parent	queryClass	queryName	readOnly
required	requiredMessage	showEmpty	showLabel
size	slice	sql	tabIndex
title	tuple	valign	value
valueColumn	valueList	visible	width
window

Methods
%AddToSaveSet	%Attr	%BindExport	%BuildValueLists
%ClassIsLatestVersion	%ClassName	%ConstructClone	%DispatchClassMethod
%DispatchGetModified	%DispatchGetProperty	%DispatchMethod	%DispatchSetModified
%DispatchSetMultidimProperty	%DispatchSetProperty	%DrawComponentHTML	%DrawHTML
%DrawJSStrings	%EnclosingDivId	%Eval	%EvalC
%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 emptyText as %ZEN.Datatype.caption;

The text to be displayed in the "empty" item displayed if showEmpty is true. The default is "".

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

If true (the default), insert an extra row with the value of emptyText at the top of the dropdown, unless required is true.

• 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.


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