Home > Class Reference > ENSLIB namespace > %ZEN.Component.select
Private  Storage   


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.


Parameters Properties Methods Queries Indices ForeignKeys Triggers
1 3 5


%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

%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


• parameter DEFAULTCONTROLCLASS = "select";
The default css class used for the main element within this control. This is overridden by subclasses.


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


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