ItemActivate event
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 |
Parameters
|
Argument |
Description |
|---|---|
|
Index |
An integer that |
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 |
|
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:
|
1 |
listviewitem llvi_current |
|
1 |
|
1 |
This.GetItem(index, 2, llvi_current) |
|
1 |
llvi_current.Label = Upper(llvi_current.Label) |
|
1 |
This.SetItem(index, 2, llvi_current) |
|
1 |
RETURN 0 |