EvtAdviseDDE

Daten einer DDE-Verbindung stehen bereit

Details

Name: Typ Beschreibung
aEvt: event Ereignisinformationen
aDdeHdl: handle Deskriptor der DDE-Verbindung
aDdeItemName: alpha Name des Elementes
Resultat: logic Wird nicht ausgewertet
Siehe: Liste , Objekte , Ereignisbefehle

Dieses Ereignis wird ausgelöst, wenn von einem DDE-Server Daten an die Applikation gesendet werden. Das Ereignis wird nur ausgelöst, wenn das empfangende Fenster-Objekt ( AppFrame -, Frame - oder MdiFrame -Objekt) sichtbar ist und das sendende Kommunikationselement des DDE-Servers für das Senden von Daten zugelassen wurde (DdeCommand (..., _DdeAdviseOn , ...)).

Definition des Funktionskopfes:

sub EvtAdviseDDE
(
  aEvt                 : event;    // Ereignis
  aDdeHdl              : handle;   // Deskriptor des DDE-Kanals
  aDdeItemName         : alpha;    // Name des Kommunikationselementes
)
: logic;                           // Wird nicht ausgewertet
{
  return(true);
}

aEvt

In diesem Übergabeparameter vom Typ event wird unter anderem der Deskriptor des auslösenden Objektes, d. h. das Objekt, in dem die Ereignisfunktion eingetragen wurde, übergeben.

aDdeHdl und aDdeItemName

In aDdeHdl und aDdeItemName werden der Deskriptor des DDE-Kanals und der Name des sendenden Elements des DDE-Servers übergeben. Diese Informationen werden benötigt, um die gesendeten Daten mit dem Befehl DdeCommand () an die Applikation zu übermitteln und mit DdeGetData () auszulesen.

Resultat

Der Rückgabewert der Funktion wird nicht ausgewertet.

Beispiel:

sub EvtAdviseDDE
(
  aEvt                 : event;    // Ereignis
  aDdeHdl              : handle;   // Deskriptor des DDE-Kanals
  aDdeItemName         : alpha;    // Name des Kommunikationselementes
)
: logic;                           // Wird nicht ausgewertet

{
  if (DdeCommand(aDdeHdl, _DdeReceive, 500, aDdeItemName) = 0)
    $lblInfo->wpCaption # DdeGetData(aDdeHdl, 1, 1, 64);

  return(true);
}

EvtAdviseDDE​

EvtAdviseDDE