ButtonClicked
event (DataWindows)
Description
Occurs when the user clicks a button inside a DataWindow
object.
PowerBuilder event
information
Event ID: pbm_dwnbuttonclicked
|
Argument |
Description |
|---|---|
|
row |
Long by value. The number of the row the user |
|
actionreturncode |
Long by value. The value returned by the action For information about return |
|
dwo |
DWObject by value. A reference to the control within |
Return Values
There are no special outcomes for this event. The only code
is:
0 — Continue processing
Usage
The ButtonClicked event executes code after the action assigned to
the button has occurred.
This event is fired only if you have not selected Suppress Event
Processing for the button.
If Suppress Event Processing is on, only the Clicked event and the
action assigned to the button are executed when the button is
clicked.
If Suppress Event Processing is off, the Clicked event and the
ButtonClicked event are fired. If the return code of the ButtonClicking
event is 0, the action assigned to the button is executed and the
ButtonClicked event is fired. If the return code of the ButtonClicking
event is 1, neither the action nor the ButtonClicked event are
executed.
Do not use a message box in the Clicked event
If you call the MessageBox function in the Clicked event, the
action assigned to the button is executed, but the ButtonClicking and
ButtonClicked events are not executed.
Returning the row number
When you place a button in the DataWindow and use the window’s
ButtonClicked event to return the row number, you will get different
results depending on where you place the button. If the button is in the
Detail band, it returns the number of the row. If the button is in the
Header band, it returns the number of the first row displayed in the
DataWindow control. If the button is in the Summary band, it returns the
number of the final row in the list. If the button is in the Footer
band, it returns the number of the last row displayed in the DataWindow
control.
Examples
This statement in the ButtonClicked event displays the value
returned by the button’s action:
|
1 |
MessageBox(" ", actionreturncode) |
This statement in the ButtonClicked event displays the value
returned by the button’s action:
|
1 2 3 4 5 6 7 8 9 10 11 |
String ls_Object String ls_Win ls_Object = String(dwo.name) If ls_Object = "cb_close" Then Close(Parent) ElseIf ls_Object = "cb_help" Then ls_win = parent.ClassName() f_open_help(ls_win) End If |
See also