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


Return Values

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

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

See also

ItemChanged

ItemChanging