Using Zen Components - InterSystems Documentation

Other Zen ComponentsAttributecaptioncellHeightdatedateFormatDescriptionText to display as a caption along the top of the schedule. The text is not HTMLescaped, so it can contain markup. The caption value can be a literal string, or it cancontain a Zen #()# runtime expression.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, aslong as a language DOMAIN parameter is defined in the Zen page class. The%ZEN.Datatype.caption data type also enables you to use $$$Text macros when youassign values to the caption property from client-side or server-side code.Integer giving the height of time slots in the schedule calendar, in pixels. The defaultis 30, as shown in the illustration for dateFormat. Do not specify units with cellHeight.Date to display, in YYYY-MM-DD format. The default is the current date. The schedulecalendar displays a range of days that contain this date value. The actual rangedepends on the current value of the view attribute: "day", "week", or "month".The date value can be a literal string, or it can contain a Zen #()# runtime expression.Integer that specifies the date format to use in the headers for the schedule calendar.The automatically displays this date below the name of the day ofthe week.The default dateFormat is –1. This generates the date in the format “Feb 18, 2009”as shown in the following illustration. As the illustration shows, you can also configurethe headerHeight and cellHeight attributes for this part of the schedule calendar display.For a list of the integers you can use as values for dateFormat, see the descriptionof dformat in the “Parameters” section for the $ZDATETIME ($ZDT) function in theCaché ObjectScript Reference. dateFormat allows nearly the same range of valuesas dformat. dateFormat supports –1 and the values 1 through 13.dayListComma-separated list of the full names of days of the week.The default dayList value uses the $$$Text macro with the English values Sundaythrough Saturday. Using this macro ensures that this dayList value is automaticallyincluded in the list of strings to translate for your application when you export themfrom the message dictionary, as long as you also set the DOMAIN parameter in theZen class. For details, see the “$$$Text Macros” section in the “Zen Localization”chapter of Developing Zen Applications.You can use $$$Text with dayList because its ZENLOCALIZE datatype parameter isset to 1 (true). Any localized dayList string must remain a comma-separated list ofseven items when translated. Be sure to coordinate dayList changes with shortDayListand firstDayOfWeek.254 Using Zen Components