Using Zen Components - InterSystems Documentation

Zen TablesPropertyselectedRowsDescriptionRead-only.When the has multiSelect set to true and a valueColumn defined, itsselectedRows string indicates which rows are currently selected in the table. The stringdoes this by providing a comma-separated list of the valueColumn values in each selectedrow. Consecutive commas in the string indicate that the row in that position is notselected.The selectedRows string looks like the following example, in which 3 of the 14 rows areselected:",,,value,,,value,,,,,value,,"If the has no valueColumn defined, but has multiSelect set to true, theselectedRows string provides no information about selected rows, and looks like this:",,,,,,,,,,,,,"showRowSelectorvaluevalueColumnIf true, the table displays an extra column at far left. This column appears empty whenthe table first displays.The purpose of this column is to indicate which rows are selectedwhen the user selects them. showRowSelector is true by default. If you want to suppressthis extra column in your table, set showRowSelector to false.This is the logical value used to determine which is the currently selected row. valueworks with valueColumn. The value may be empty ("").Do not access this value directly; use getProperty('value') instead.A can have a logical value defined. Each time the table is refreshed, ineach row Zen tests this logical value against the actual value that appears in thevalueColumn in that row. Zen selects any row(s) that contain value in valueColumn.Thisimplies the following:• You can preset the value of a and the row(s) that match will be selectedwhen the table is first displayed.• The current selection is preserved when you sort the rows in a table.1.11 Table RefreshWhen you refresh a table, only the table refreshes. It is not necessary for the entire Zen page to refresh itself in order torefresh a table.Typically, Zen refreshes the visible contents of the table automatically as needed. When you work with tables programmatically,you can also explicitly refresh table contents. The techniques are as follows:• Set the refreshRequired property of the %ZEN.Component.tablePane to true (1) from a server-side method. This forcesthe tablePane to re-execute its query.• Call the executeQuery method of the %ZEN.Component.tablePane. This causes the data query to be re-executed andupdates the visible contents of the table to reflect the current values of tablePane properties.Note that refreshRequired has no effect when you are using snapshot mode.28 Using Zen Components