pictureClick

pictureClick([control:    control-type input];
             picIndex:    Integer;
             whatClicked: Integer);

The pictureClick event is generated in a ListBox control or a ComboBox control when the picture area before the text of an item is clicked with the mouse. (See also the itemPicture, hasPictures, hasTreeLines, and hasPlusMinus properties.)

If the area clicked is before the pictures or the start of the treeline for the item, no events other than the mouseDown and mouseUp events are generated.

This event is also generated by pressing the Enter key when an entry in the list is selected.

Clicking the picture area does not expand or collapse an item.

The pictureClick event passes the index of the item being clicked and the picture that was clicked, as listed in the following table.

ComboBox or ListBox Class Constant Index Picture
PictureClick_PlusMinus 1 Plus or minus picture, controlled by the hasPlusMinus property
PictureClick_TreeLine 2 Tree line of item, controlled by the hasTreeLines property
PictureClick_Picture 3 Picture, controlled by the hasPictures property
PictureClick_ItemPicture 4 ItemPicture, set by the itemPicture property
PictureClick_KeyBoard 5 Keyboard action

If both the hasPlusMinus and hasTreeLines properties are set, a value of 1 is returned when the plus or minus picture is clicked, as this overlays the treeline area.

The picture image that is displayed depends on whether the item has subitems and whether the item is expanded or collapsed. See also the pictureClosed, pictureOpen, and pictureLeaf properties.

Clicking the picture does not select that entry.