12.07.2015 Views

Using Zen Components - InterSystems Documentation

Using Zen Components - InterSystems Documentation

Using Zen Components - InterSystems Documentation

SHOW MORE
SHOW LESS
  • No tags were found...

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

<strong>Zen</strong> Controls• Solutions to problems with Internet Explorer interoperating with CSS5.7.4.1 Logical and Display ValuesTo define a , provide a valueList for the user to choose from and a corresponding displayList for the user tosee. The following table describes these attributes.AttributedisplayListvalueListDescriptionA comma-separated list of values to display for the list in this combo box. displayList appliesonly if a valueList is defined. Display values may differ from the actual logical values.The displayList attribute has its ZENLOCALIZE datatype parameter set to 1 (true). This makesit easy to localize its text into other languages, and permits use of the $$$Text macros whenyou assign values to this property from client-side or server-side code.Any localized displayList string must remain a comma-separated list.valueList overrides any elements provided within the (see the discussionfollowing this table).The valueList is a comma-separated list of logical values for the drop-downlist in this . If you provide a valueList, you must also provide a displayList.5.7.4.2 OptionsRather than provide a valueList and a displayList, you can define a by providing a set of elementsinside a component. is more flexible than a valueList and displayList because it allows you to applya CSS style to each of the list entries individually. For example:The element is the XML projection of the %ZEN.Auxiliary.option class and supports the attributes described in thefollowing table.AttributestyletextvalueDescriptionCSS style to apply to this option.Display value. This is the text that the user sees in the combo box.Although you can enter ordinary text for this attribute, it has the underlying data type%ZEN.Datatype.caption. This makes it easy to localize its text into other languages, as long as alanguage DOMAIN parameter is defined in the <strong>Zen</strong> page class. The %ZEN.Datatype.caption datatype also enables you to use $$$Text macros when you assign values to the text property fromclient-side or server-side code.Logical value. This is the value that <strong>Zen</strong> submits for this control when it submits the form. Youmust always provide both text and value for each option in the combo box.When you work with %ZEN.Component.combobox programmatically, you work with elements as members ofthe options property, a list collection. Each in the becomes a member of the options collection,associated with an ordinal position: 1, 2, 3, etc.124 <strong>Using</strong> <strong>Zen</strong> <strong>Components</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!