DDEPeek
DDEPeek
retrieves data from the specified program
and document using the DDE channel.
Syntax
Important: This feature is deprecated, its use is
discouraged although not prohibited.
CALL ui.Interface.frontCall("WINDDE","DDEPeek",
[ program, container, cells, encoding ], [ result, value ] )
- program is the name of the DDE application.
- container is the document or sub-document that is to be used. A sub-document can, for example, be a sheet in Microsoft™ Excel.
- cells represents the working items; see the program documentation to know the format of cells.
- encoding is an optional parameter. It allows to force the encoding to use between ASCII and wide char/unicode. When not specified, WinDDE will try to retrieve the correct encoding itself. Possible values are: "UNICODE", "ASCII"
- value represents the data to be retrieved; see the program documentation for details of the format of values.
- result is an integer variable receiving the status.
- result is TRUE if the function succeeded, FALSE otherwise.
- If the function fails, use
DDEError
to get the description of the error. - value is a variable receiving the cells values.
Warnings
- The DDE connection must be opened; see
DDEConnect
. DDEError
can only be called once to check if an error occurred.