Pictures for items – PB Docs 2021

PictureIndex

The primary picture associated with the item is
displayed just to the left of the item’s label.

StatePictureIndex

A state picture is displayed to the left of the
regular picture. The item moves to the right to make room for
the state picture. If the Checkboxes property is TRUE, the state
picture is replaced by a pair of check
boxes.

Because a state picture takes up room, items
without state pictures will not align with items that have
pictures. So that all items have a state picture and stay
aligned, you could use a blank state picture for items that do
not have a state to be displayed.

A use for state
pictures might be to display a check mark beside items the user
has chosen.

OverlayPictureIndex

An overlay picture is displayed on top of an item’s
regular picture.

You set up the overlay picture list
in a script by designating a picture in the regular picture list
for the overlay picture list.

An overlay picture is
the same size as a regular picture, but it often uses a small
portion of the image space so that it only partially covers the
regular picture. A typical use of overlay pictures is the arrow
marking shortcut items in the Windows Explorer.

SelectedPictureIndex

A picture from the regular picture list that is
displayed instead of the regular picture when the item is the
current item. When the user selects another item, the first item
gets its regular picture and the new item displays its selected
picture.

If you do not want a different picture when
an item is current, set SelectedPictureIndex to the same value
as PictureIndex.