notify( )

Topic group Related topics Example

Notifies all interested client applications that a dBASE item was changed.

Syntax

<oRef>.notify(<item expC>)

<oRef>

A reference to the DDETopic object in which the item changed.

<item expC>

Name of the item that has changed.

Property of

DDETopic

Description

Use notify( ) in a DDE server program to tell all interested client applications that an item in the dBASE server was changed.

Client applications ask to be notified of changes by calling their equivalent of the DDELink object’s advise( ) method. dBASE automatically maintains an internal list of these clients so that when the notify( ) method is called, the appropriate DDE message is sent to each client, if any. For a dBASE client, that message fires the onNewValue event.

onPoke event handlers often call notify( ) when an external application sends dBASE a poke request. For example, a Quattro Pro data-exchange application might use its {POKE} command to send dBASE a value, causing the onPoke event handler to execute. The onPoke routine could insert the value into a field, then execute notify( ) to inform Quattro Pro that the field changed.

When notify( ) is called, the onPeek method is called implicitly to get the value of the item to pass to the client applications.