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.