.. highlightlang:: us

.. index:: DdeCallback_Poke

.. _ddecallback_poke:

DdeCallback_Poke
================

.. us.tag  DdeCallback_Poke GERMAN

Die :ref:`DdeCallback_Poke` Funktion wird vom Client aufgerufen um Daten an
UniScript zu senden.

.. function::  bool = DdeCallback_Poke(hConv, ssItem, ssTopic, ssData)

.. us.return

**Returnwert**

*bool* ist TRUE (1) wenn die Funktion erfolgreich war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: hConv

   *hConv* ist die Kanalnummer.

.. uparam:: ssItem

   *ssItem* ist der Item-Name.

.. uparam:: ssTopic

   *ssTopic* ist der Topic-Name.

.. uparam:: ssData

   *ssData* sind die an UniPlot gesendeten Daten.

.. us.example

**Beispiel**

Das folgende Word-Basic-Programm bewirkt, das Daten zur UniScript
:ref:`DdeCallback_Poke`-Funktion gesendet werden:

::

   Sub Main
       chan = DDEInitiate("UniPlotSL", "xydata")
       DDEPoke(chan, "xydata", "1,5,3,4,8,12")
       DDETerminate(chan)
   End Sub

Für die Basic-Anweisung ``DDEPoke(chan, "xydata", "1,5,3,4,8,12")``,
die in UniPlot ein Diagramm mit den angegebenen Daten erzeugen soll,
muss die :ref:`DdeCallback_Poke`-Funktion in der Datei
:file:`UniPlot/script/obj_dde.ic` folgendermaßen geändert werden:

::

   def DdeCallback_Poke(hConv, ssItem, ssTopic, ssData)
   {
       printf("---Poke---\n";
       printf("Conversation-No.: %x, Item: %s, Topic: %s, Data: %s\n\n", ..
           hConv, ssItem, ssTopic, ssData);
       ss = strtok(ssData, ",")
       rvData = strtod(ss)
       plot(1:len(rvData), rvData);
       return TRUE;
   }

.. seealso::
   :ref:`uberblick-dde`,
   :ref:`DdeCallback_Connect`,
   :ref:`DdeCallback_ConnectConfirm`,
   :ref:`DdeCallback_Disconnect`,
   :ref:`DdeCallback_Request`,
   :ref:`DdeCallback_Execute`

:sub:`id-105871`