Arbortext Command Language > Functions by Alphabetical Listing > dlgitem_set_multiple
  
dlgitem_set_multiple
dlgitem_set_multiple (window, attribute, values)
Sets the value of the attribute named attribute to multiple dlgitems within window, per the array in values. The values parameter is an associative array, indexed by the tag names of the dialog items within window, containing new values for the attribute. There need not be an entry in values for every dialog item in the window. It is an error for values to contain a tag name which does not correspond to a dlgitem, however. If an error occurs, $ERROR is set and 0 is returned. If successful, the function returns a one (1).
The window parameter is a window identifier. The attribute parameter specifies the attribute to set. The values parameter is an associative array of new values for dialog items.
Notes:
Assignment of values does not cease when an erroneous entry is detected.
Example
$Values["NameField"] = "Jeff"
$Values["AgeField"] = "35"
$Values["StateField"] = "MD"
$ret = dlgitem_set_multiple($win, "VALUE", Values)
Sets the following values: NameField dialog item to "Jeff", AgeField dialog item to "35", and StateField dialog item to "MD".