.. highlightlang:: us

.. index:: DdeCallback_Execute

.. _ddecallback_execute:

DdeCallback_Execute
===================

.. us.tag  DdeCallback_Execute ENGLISH

:ref:`DdeCallback_Execute` is called by the client, when a command in UniScript
should be performed.

.. function::  bool = DdeCallback_Execute(hConv, ssItem, ssTopic)

.. us.return

**Return Value**

*bool* is TRUE (1) if the function was successful, otherwise FALSE(0).

.. us.params

**Parameters**

.. uparam:: hConv

   *hConv* is the channel name.

.. uparam:: ssItem

   *ssItem* is the item name.

.. uparam:: ssTopic

   *ssCommand* is the command which is performed by UniPlot.

.. us.example

**Example**

The following Word-Basic program causes UniPlot to quit:

::

   Sub Main
       chan = DDEInitiate("UniPlotSL", "xyz")
       DDEExecute(chan, "[quit]")
       DDETerminate(chan)
   End Sub

The Word-Basic command ``DDEExecute(chan, "[quit]")`` will call the callback
function :ref:`DdeCallback_Execute` in the :file:`UniPlot\\Script\\obj_dde.ic` 
file which should be altered to:

::

   def DdeCallback_Execute(hConv, ssItem, ssCommand)
   {
       printf("---Execute---\n");
       printf("Conversation-No.: %x, Item: %s, Data: %s\n\n", ..
           hConv, ssItem, ssData);
       if (ssCommand == "[quit]") {
          AppQuit();
       }
       return TRUE;
   }

.. seealso::
   :ref:`overview-dde`,
   :ref:`DdeCallback_Connect`,
   :ref:`DdeCallback_ConnectConfirm`,
   :ref:`DdeCallback_Disconnect`,
   :ref:`DdeCallback_Request`,
   :ref:`DdeCallback_Poke`

:sub:`id-1426950`