bArrayServer:Notify()

Purpose

Callback method that is called by the server whenever a change occurs.

Class

bArrayServer

Type

Method

Syntax

<oArrayServer>:Notify(

<iNotify>,

[<uDescription>]

) Æ uValueuResult

Arguments

The notification which arose within the server. The following notification are sent by the server:

Notification	Description
NOTIFYAPPEND	A new record was appended. The server is positioned on this record.
NOTIFYCLOSE	The server is closed.
NOTIFYDELETE	The current record was deleted. The server is still positioned on this record.
NOTIFYFIELDCHANGE	The value of a field was changed. <uDescription> specified the name of the Field as symbol.
NOTIFYFILECHANGE	The server executed an operation causing large changes in records.
NOTIFYGOBOTTOM	The server was positioned on the last record.
NOTIFYGOTOP	The server was positioned on the first record.
NOTIFYINTENTTOMOVE	The server is to make a record movement. All registered clients receive the possibility to react to it. The record movement is not implemented, if one of the clients returns FALSE. If a Client agrees with the record movement, this must return TRUE.
NOTIFYRECORDCHANGE	The server was positioned on another record. <uDescription> contains the number of records that the record pointer was moved. If this number does not known, <uDescription> contains the value NIL.

Data Type:

Integer

Dependent on the notification <iNotify> contains <uDescription> further information to the notification.

Data Type:

Usual

Return Value

uResult

NIL, for all <iNotify> messages another than NOTIFYINTENTTOMOVE. For the message NOTIFYINTENTTOMOVE the return value is TRUE for successful execution, otherwise FALSE.

Data Type:

NIL | Logic

Description

With each change in the server (record movement, field change, etc.) the server calls this method. Within the method for each registered client the method Notify() is called with the arguments <iNotify> and <uDescription>. Each client must guarantee that this method is implemented.

A client can be registered with the method DataServer:RegisterClient() at the server. Only after this the method Notify() is invoked in the client.