A script-enabled browser is required for this page to function properly.

DDE.APP_BEGIN

Description

Begins a conversation with a DDE server application program.

Syntax

DDE.APP_BEGIN (Command, Mode)

Parameters

Parameter

Type

Description

Command

VARCHAR2

command line for executing a program

Mode

PLS_INTEGER

application window starting mode

Returns PLS_INTEGER

Notes

In the Command string, the DDE server application program name can include a path. If the DDE server application name does not include a path, then the following directories are searched:

The DDE server application program name may be followed by arguments, which should be separated from the application program name with a space.

Start the DDE server application in either normal, minimized, or maximized size with the mode parameter. (The DDE server application is started on the application server machine, not the Client browser machine.)

The application mode constants for DDE.APP_BEGIN are the following:

Mode

Description

DDE.APP_MODE_NORMAL

Start application window in normal size.

DDE.APP_MODE_MINIMIZED

Start application window in minimized size.

DDE.APP_MODE_MAXIMIZED

Start application window in maximized size.

This function returns an application identifier that is a PLS_INTEGER. The application identifier is used in all subsequent calls to DDE.APP_END and DDE.APP_FOCUS for that application window.

DDE.APP_BEGIN Example

DECLARE
 AppID PLS_INTEGER;
BEGIN
 /* Start Microsoft Excel with spreadsheet emp.xls loaded. */
 AppID := DDE.App_Begin('C:/excel/excel.exe C:/emp.xls',
      DDE.APP_MODE_MINIMIZED);
END;