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


class %ZEN.Component.checkbox extends control

Boolean checkbox control
This uses an HTML input=check control plus it displays a caption (caption) next to the checkbox and detects user mouse click on caption.
Unlike an HTML checkbox, this checkbox always submits a value. It submits a value of 1 or 0 to the server; The client side value is either true or false.


Parameters Properties Methods Queries Indices ForeignKeys Triggers
3 3 7


%condition %import %includeFiles %page
%resource align aux caption
captionClass clientType composite containerStyle
controlClass controlStyle dataBinding disabled
dragEnabled dropEnabled enclosingClass enclosingStyle
error height hidden hint
hintClass hintStyle id index
invalid invalidMessage label labelClass
labelDisabledClass labelStyle 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 parent readOnly readonlyNobox
required requiredMessage showLabel slice
tabIndex title tuple valign
value visible width window

%AddToSaveSet %Attr %BindExport %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
clickCaption clickCheckbox dragFinishHandler dragHandler
dragNotifyHandler dragStartHandler dropHandler dropStartHandler
exposeComponent findElement fireOnUpdateEvent focus
formatValue getDisabled getDragData getEnclosingDiv
getForm getHidden getHintElement getInvalidReason
getLabelElement getProperty getReadOnly 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 DEFAULTCLIENTTYPE = "boolean";
The default value for the clientType property.
• parameter DEFAULTCONTROLCLASS = "checkbox";
The default css class used for the main element within this control. This is overridden by subclasses.
• parameter DOMAIN = "%ZEN";


• property caption as %ZEN.Datatype.caption(ZENEXPRESSION=1);
Additional caption displayed next to actual checkbox.
This is a localized value.
• property captionClass as %ZEN.Datatype.cssClass [ InitialExpression = "checkboxCaption" ];
CSS class to apply to the control's caption.
• property readonlyNobox as %ZEN.Datatype.boolean [ InitialExpression = 0 ];
If this is true then no checkbox will be built. Instead, it will write "Yes" or "No" based on the checkbox's value.


• 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 %SetDefaultValues()
This method fills in reasonable default values for this control. Used by tools (such as Control Tester) to dynamically create controls.
• method clickCaption() [ Language = javascript ]
User click on caption for checkbox; toggle value;
• method clickCheckbox() [ Language = javascript ]
User click on checkbox; update hidden value;
• method getProperty(property, key) as %String [ Language = javascript ]
Override to get value of control
• method onSerialize() [ Language = javascript ]
Get current value for serial state.
• method setProperty(property, value, value2) [ Language = javascript ]
Set the value of a named property.