<< ibec_ibe_SetDatabaseProp | IBEBlock | ibec_ibe_SetLngShortcut >>

ibec_ibe_PerformAction

All ibec_ibe_xxx functions work only within IBExpert and will be ignored when IBEBlock is executed with IBEScript.exe or IBEScript.dll.

Syntax

 function ibec_ibe_PerformAction(DatabaseID : variant; Action : string; Options : variant) : variant;

ibec_ibe_PerformAction performs an Action using the registered database specified as DatabaseID.

Currently the following actions are supported:

OpenScriptFileOpens a script file specified in the Options parameter for editing (using IBExpert's Script Editor). DatabaseID is ignored for this action and should usually be NULL.
usuallyOpenScriptusuallyOpens a script text specified in the usuallyOptionsusually parameter for editing (using IBExpert's Script Editor). DatabaseID is ignored for this action and should usually be NULL.
CloseAllWindowsIf DatabaseID is NULL all IBExpert child windows will be closed. If DatabaseID is NOT NULL only windows associated with the specified database will be closed. The options parameter is ignored for this action.

Example

     execute ibeblock
     as
     begin
       ibec_ibe_PerformAction(null, 'OpenScriptFile', 'D:\MyScripts\data.sql');

       s = 'DELETE FROM MYTABLE WHERE ID = 0; COMMIT';
       ibec_ibe_PerformAction(null, 'OpenScript', s);

       DBID = ibec_ibe_GetActiveDatabaseID();
       if (DBID is not null) then
         ibec_ibe_PerformAction(DBID, 'CloseAllWindows', '');
     end

back to top of page
<< ibec_ibe_SetDatabaseProp | IBEBlock | ibec_ibe_SetLngShortcut >>