Arbortext Command Language > Functions by Alphabetical Listing > dlgitem_set_listtag_openbranch_image_at
  
dlgitem_set_listtag_openbranch_image_at
dlgitem_set_listtag_openbranch_image_at(window, listtag, row, image)
Associates an ACL Designer image resource image with the outline list entry row in the outline list listtag in window. The image appears at the front of the list item when it is expanded. Use this function when you want a specific expanded branch listtag to appear with an image different from the default image. If you were to create a file browser using an outline list, you may use a open folder icon as a default open branch image and a special icon for open branches with locked contents. 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 listtag (case sensitive). The row parameter is an offset into listtag (starting from one). The image parameter specifies the ACL Designer image resource to place at the front of the list item.
Example
ret = dlgitem_set_listtag_openbranch_image_at(win, \
"Hierarchy", 3, "OpenFolderLocked")
sets the image for the third item in the outline list item Hierarchy to the OpenFolderLocked image.
Related topic
dlgitem_set_default_openbranch_image