ItemFocusChanged event
Description
Occurs when the current item in the control changes.
PowerBuilder event information
Event ID: pbm_dwnitemchangefocus
|
Argument |
Description |
|---|---|
|
row |
Long by value. The number of the row |
|
dwo |
DWObject by value. A reference to the |
Web DataWindow client control event information
Event name: ItemFocusChanged
|
Argument |
Description |
|---|---|
|
row |
Number. The number of the row containing |
|
columnName |
String. The name of the column containing |
Web ActiveX event information
Event name: onItemFocusChange
|
Argument |
Description |
|---|---|
|
Row |
Number. The number of the row containing |
|
Name |
String. The name of the column containing |
Return Values
There are no special outcomes for this event. The only code
is:
-
0 Continue processing
Usage
ItemFocusChanged occurs when focus is set to another column
in the DataWindow, including when the DataWindow is first displayed.
The row and column together uniquely identify an item in the
DataWindow.
PowerBuilder programming note
In the ItemFocusChanged event, dwo is always
a column control. Therefore, you can get more information about
it by examining any properties that are appropriate for columns
such as dwo.id and dwo.Name.
Examples
This example reports the row and column that just
gained focus and that just lost focus. (The first time the event
occurs, there is no item that just lost focus; the script saves
the row number and column name in two instance variables called
ii_row and is_colname so that the old item is
known the next time the event occurs.)
|
1 |
IF ii_row > 0 THEN |
|
1 |
sle_olditem.Text = "Old row: " + String(ii_row) & |
|
1 |
+ " Old column: " + is_colname |
|
1 |
END IF |
|
1 |
|
1 |
sle_newitem.Text = "New row: " + String(row) & |
|
1 |
+ " New column: " + dwo.Name |
|
1 |
|
1 |
// Replace values of instance variables |
|
1 |
// with info for next change in focus |
|
1 |
ii_row = row |
|
1 |
|
1 |
is_colname = dwo.Name |