Events for the DataWindow control

Table 261. 

Events for the DataWindow control

Supported

ButtonClicked

ButtonClicking

Clicked

Constructor

Collapsed

Collapsing

DBError

Destructor

DoubleClicked

DragDrop

DragEnter

DragLeave

DragWithin

EditChanged

Expanded

Expanding

GetFocus

ItemChanged

ItemError

ItemFocusChanged

LoseFocus

PrintPage

RButtonDown

Resize

RetrieveEnd

RetrieveStart

RowFocusChanged

RowFocusChanging

SQLPreview ScrollHorizontal

ScrollVertical

WSError

DBError

The sqlsyntax and buffer arguments do not work in the DBError event.

The GetSQLPreview function will be ignored if used in the DBError event.

SQLPreview

Only the value previewselect! can be used as the SQLPreview sqltype argument.

Unsupported

Error

Help

Other

PrintEnd

PrintStart

RetrieveRow

Using instance variables or global variables to store the dwo argument (argument type is dwobject) for a DataWindow event is unsupported.

Triggering of DataWindow events

Supported

Nearly full support is available for Triggering supported DataWindow events, except for the following limitations and differences.

(For ItemChanged event) In a Web application, if the ItemChanged event is triggered for a field whose new value does not pass validation, the focus will not go back to the column being edited.

(For Resize event) When the Width or Height of a DataWindow control is reset, the Resize event will be triggered, regardless of whether the value is changed or remains the same.

(For RowFocusChanged event) In PowerBuilder, RowFocusChanged will be triggered twice upon execution of the RowsCopy or RowsMove function. However, in the same scenario on the Web, the RowsFocusChanged event will only be triggered once.

(For SQLPreview event) The SQLPreview event can only be triggered by the Retrieve function, not by Update or ReselectRow.

If a DataWindow event requires interaction with the server, its subsequent event may not be triggered due to the time delay caused by the interaction with the server.

For label DataWindows, clicking different lines cannot trigger the RowFocusChanging and RowFocusChanged events.