BrowseWriteFiles - Browse new file for processing (Shift+Ctrl+B,F)
The action opens a file dialog for selecting a file for further processing. One may select an existing file or define a new file. When canceling the dialog, no file will be selected. The result will be stored to the control, which is associated with the action. Typically, the action is associated with a single line edit control.
In order to evaluate data in a more sophisticated way, one may handle the doBeforeDataStore() event and return true in order to suppress further processing of the selected file name. The selected file name can be obtained from the control by calling text().
Since the action returns the file paths to the control's data area, the action should be called for text controls, only. When importing files into database collections or instances, a doBeforeDataStore() event handler has to be provided for processing the path. In this case, the event handler must terminate with error (true).
// OSI implementation
FUNCTION virtual int32 myClass :: doBeforeStoreData ( ) {
if ( !text().isEmpty() )
; // do something with text()
return(true); // do not process event further on
}