Arbortext Command Language > Functions by Alphabetical Listing > dlgitem_set_default_branch_image
  
dlgitem_set_default_branch_image
dlgitem_set_default_branch_image(window, dlgitem, image)
Sets the image resource image as the image to be used for all list entries containing sublisttags that are in a collapsed state in an outline list dialog item dlgitem (unless overridden by a specific branch image setting for a particular listtag list entry) in window window.
The image appears at the front of all the list entries that contain sublisttags that are collapsed. image cannot be defined by a XUI <imagelist> element. It must be defined as a standalone <image> element.
Use dlgitem_set_default_branch_image to set the default image for list items that have children. If you were to create a file browser using an outline list, you may use a closed folder icon as your default branch image. If dlgitem does not refer to an outline list item, $ERROR is set and zero (0) is returned. Otherwise, one (1) is returned.
window is a window identifier. dlgitem is the value of the control's id attribute. image specifies the id attribute of an image element in the XUI file. The image is used to replace the image at the front of all list entries containing sublists for outline list item dlgitem.
For example,
ret = dlgitem_set_default_branch_image(win, "OutlistItem", "Folder")
sets the image for all list entries containing sublists and are collapsed in the outline list item OutlistItem to the Folder image.
Related Topics
dlgitem_set_listtag_branch_image_at