ItemActivate
PowerScript 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 |
Arguments
|
Argument |
Description |
|---|---|
|
Index |
An integer that represents the index of the item |
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 |
|
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 2 3 4 5 6 |
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