ABAP Keyword Documentation → ABAP - Reference → Data Interfaces and Communication Interfaces → ABAP and OLE
CALL METHOD - OLE
Other versions: 7.31 | 7.40 | 7.54
Syntax
CALL METHOD OF ole meth [= rc]
[EXPORTING p1 = f1 p2 = f2 ...]
[NO FLUSH] [QUEUE-ONLY].
Extras
1.... EXPORTING p1 = f1 p2 = f2 ...
2.... NO FLUSH
3.... QUEUE-ONLY
Effect
With this statement you call method meth
of automation object ole
.
The automation-object must be created with the special statement
CREATE OBJECT
for automation-objects. The name of the method has to be specified in a character-like data object meth
.
The return value of the external method meth
can be stored in a data object
rc
. This data object expects, according to the called method, a character-like data type of length 8 or a data type of type ole2_object
from the
type group OLE2 to be able to accept the addressed object.
Addition 1
... EXPORTING p1 = f1 p2 = f2 ...
Effect
With the addition EXPORTING
, you can assign actual parameters f1
f2 ... to the input parameters p1 p2 ...
of the automation method.
The data type of the data objects f1 f2 ...
depends on the requirements of the automation method.
Addition 2
... NO FLUSH
Addition 3
... QUEUE-ONLY
Effect
The additions NO FLUSH
and QUEUE-ONLY
are described
in the statement CREATE OBJECT
.
System Fields
sy-subrc | Relevance |
---|---|
0 | Successful processing of the method meth . |
1 | Communication Error to SAP GUI. |
2 | Error when calling method meth . |
3 | Error when setting a property. |
4 | Error when reading a property. |
Example
Depending on the selection on the selection screen, you can open the Excel file Table.xls in directory C:\temp, start the application Word and then close both applications again by using this source text. The used automation methods are listed in the following table.
Application | Method | Parameter | Function |
---|---|---|---|
Excel | Open | File Name and Path | Open |
Excel | Quit | - | Exit |
Word | AppShow | - | Start |
Word | AppClose | - | Exit |
TABLES sscrfields.
DATA: excel TYPE ole2_object,
word TYPE ole2_object,
book TYPE ole2_object,
rc TYPE c LENGTH 8.
SELECTION-SCREEN:
BEGIN OF SCREEN 100 AS WINDOW TITLE title,
BEGIN OF LINE,
PUSHBUTTON 2(12) button_1
USER-COMMAND word_start,
PUSHBUTTON 20(12) button_2
USER-COMMAND excel_start,
END OF LINE,
BEGIN OF LINE,
PUSHBUTTON 2(12) button_3
USER-COMMAND word_stop,
PUSHBUTTON 20(12) button_4
USER-COMMAND excel_stop,
END OF LINE,
END OF SCREEN 100.
START-OF-SELECTION.
button_1 = 'Start Word'.
button_2 = 'Start Excel'.
button_3 = 'Stop Word'.
button_4 = 'Stop Excel'.
CALL SELECTION-SCREEN 100 STARTING AT 10 10.
AT SELECTION-SCREEN.
CASE sscrfields-ucomm.
WHEN 'WORD_START'.
CHECK word-handle <> -1.
CHECK word-header = space.
CREATE OBJECT word 'Word.Basic'.
CALL METHOD OF word 'AppShow'.
WHEN 'EXCEL_START'.
CHECK excel-handle = 0.
CHECK excel-header = space.
CREATE OBJECT excel 'Excel.Application'.
SET PROPERTY OF excel 'Visible' = 1.
GET PROPERTY OF excel 'Workbooks' = book.
CALL METHOD OF book 'Open' = rc
EXPORTING #1 = 'C:\temp\Table.xls'.
WHEN 'WORD_STOP'.
CALL METHOD OF word 'AppClose'.
FREE OBJECT word.
CLEAR: word-handle, word-header.
WHEN 'EXCEL_STOP'.
CALL METHOD OF excel 'Quit'.
FREE OBJECT excel.
CLEAR: excel-handle, excel-header.
WHEN OTHERS.
LEAVE PROGRAM.
ENDCASE.