ItemActivate

Description

Occurs when a ListView item is clicked or double-clicked. The actual firing mechanism depends on the OneClickActivate and TwoClickActivate property settings.

Event ID

Event ID	Objects
pbm_lvnitemactivate	ListView

Arguments

Argument	Description
Index	An integer that represents the index of the item being inserted into the ListView

Returns

Long. Return code choices (specify in a RETURN statement):

0 Continue processing

Usage

Use the ItemActivate event instead of the Clicked or DoubleClicked event in new applications.

The following ListView property settings determine which user action fires the event:

OneClickActivate	TwoClickActivate	Firing mechanism
True	True	Single click
True	False	Single click
False	True	Single click on selected item or double-click on nonselected item
False	False	Double-click

Examples

Example 1

This code changes a ListView item text label to uppercase lettering. The change is made in the second column of the item the user clicks or double-clicks, depending on the ListView property settings:

listviewitem llvi_current

This.GetItem(index, 2, llvi_current)

llvi_current.Label = Upper(llvi_current.Label)

This.SetItem(index, 2, llvi_current)

RETURN 0