'KCMLDdePoke(hConv, sItem$, sPoke$)
Insert a value sPoke$, at address sItem$ on the DDE conversation channel hConv
Deprecated
This function is deprecated and may be removed in a future release.
Arguments
| INT() | hConv | [in] | Conversation handle. |
| STR() | sItem$ | [in] | Address. |
| STR() | sPoke$ | [in] | Value to be inserted. |
Returns
This function returns 0 on success, -1 on failure.
Syntax
The following definition is built into KCML. You do not have to include it in your own code.
$DECLARE 'KCMLDdePoke(INT(), STR(), STR())
Remarks
This command allows you to insert a value poke$, at address item$ on the DDE conversation channel conv. The value for conv is obtained by calling the KCMLDdeOpen command, to start a DDE conversation with a pre-loaded server application. For example, using this command you can insert values at any row and column location in an Excel worksheet. Note that not all applications will support this feature.
Example
The following code extract will insert the text Test at row 1, column 1 of a pre-loaded Excel worksheet called Sheet1.
'KCMLDdeLoad("excel", "excel.exe")
chan = 'KCMLDdeOpen("excel", "sheet1")
ret = 'KCMLDdePoke(chan, "r1c1", "test")
'KCMLDdeClose(chan)
Further Information
| Introduced | KCML 5.00 |
| Compatibility | KClient |
See Also
KCMLDDEServerInit, KCMLDdeAddTopic, KCMLDdeClose, KCMLDdeDestroy, KCMLDdeExec, KCMLDdeInit, KCMLDdeLoad, KCMLDdeOpen, KCMLDdeRequest