Arbortext Command Language > Functions by Alphabetical Listing > dlgitem_set_listtag_branch_image_at
  
dlgitem_set_listtag_branch_image_at
dlgitem_set_listtag_branch_image_at(window, listtag, row, image)
Associates image with the outline list entry row in the outline list listtag in window. The image appears at the front of the list item. Use this function when you want a specific branch listtag to appear with an image different from the default branch image. If you were to create a file browser using an outline list, you may use a closed folder icon as a default branch image, and a special icon for a locked folder. If listtag does not refer to an outline list listtag, $ERROR is set and zero (0) is returned. Otherwise, one (1) is returned.
The window parameter is a window identifier. The listtag parameter is an outline list list tag (case sensitive). The row parameter is an offset into listtag (starting from one).
Example
ret = dlgitem_set_listtag_branch_image_at(win, "Hierarchy", 3, "Lockedfolder")
This sets the image for the third item in the outline list item Hierarchy to the Lockedfolder image.
Related topic
dlgitem_set_default_branch_image