EventChange (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Summary table about the operating mode of signals

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

EventChange (Function)

In french: SignalModifie

Modifies the status of an event.

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 17 and later

This function is now available for the Windows Phone applications.

New in version 17

This function is now available for the Windows Phone applications.

Versions 18 and later

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

New in version 18

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

Versions 19 and later

This function is now available for iPhone/iPad applications.

This function is now available for the WINDEV applications in Linux.

This function is now available for the WEBDEV sites in Linux.

New in version 19

This function is now available for iPhone/iPad applications.

This function is now available for the WINDEV applications in Linux.

This function is now available for the WEBDEV sites in Linux.

This function is now available for iPhone/iPad applications.

This function is now available for the WINDEV applications in Linux.

This function is now available for the WEBDEV sites in Linux.

Versions 21 and later

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

Example

// Create an event
EventCreate("Let's go", eventManual, eventClose)
// Run a first thread
ThreadExecute("Thread1", threadNormal, "Thread_First")
// Locks the current thread until the signal is obtained
ThreadWaitSignal()

// Run a second thread
ThreadExecute("Thread2", threadNormal, "Thread_Second")
// Locks the current thread until the signal is obtained
ThreadWaitSignal()

// Modifies the event to run the threads
EventChange("Let's go", eventOpen)

//----------------------------------------------
PROCÉDURE Thread_First()
Trace(dbgInfo(dbgProcess) + " - ThreadSendSignal(threadMain)")
ThreadSendSignal(threadMain)
EventWait("Let's go")
Trace(dbgInfo(dbgProcess) + " - Signal received")

//--------------------------------------------
PROCÉDURE Thread_Second()
Trace(dbgInfo(dbgProcess) + " - ThreadSendSignal(threadMain)")
ThreadSendSignal(threadMain)
EventWait("Let's go")
Trace(dbgInfo(dbgProcess) + " - Signal received")

Syntax

EventChange(<Event name> [, <New status>])

<Event name>: Character string (with quotes)

Name of the event to modify. If this event does not exist, it is automatically created with the default options (automatic mode) and in the specified status.

<New status>: Optional constant

Status of the signal:
eventOpen
(Default value) Opens the signal. If threads are waiting for the signal, they are automatically unlocked.
Versions 20 and later
This constant is equivalent to EventOpen.
New in version 20
This constant is equivalent to EventOpen.
This constant is equivalent to EventOpen.
eventClose Closes the signal.
Versions 20 and later
This constant is equivalent to EventClose.
New in version 20
This constant is equivalent to EventClose.
This constant is equivalent to EventClose.
eventOpenAndClose Opens the signal, unlocks all the pending threads and closes the signal.
This constant is not recommended. It is kept for backward compatibility.

Remarks

Summary table about the operating mode of signals

Value of EventChange	Automatic signal (by default)	Manual signal

eventOpen	A single thread is processed by the signal. The signal is automatically closed once the thread is processed. Pending threads: If there is no pending thread, the signal remains opened until the next thread, then it is closed. New threads: The new threads are added to the pending queue.	The event is opened. Pending threads: All the pending threads are processed. New threads: If other threads arrive while the signal is still opened, they are processed.
eventOpenAndClose This constant is not recommended. It is kept for backward compatibility.	A single thread is processed by the signal. The signal is automatically closed once the thread is processed. Pending threads: If there is no pending thread, the signal remains closed. New threads: The new threads are added to the pending queue.	All the threads are processed by the signal. The signal is automatically closed once all the threads are processed. New threads: The new threads are added to the pending queue.
eventClose	The event remains closed. New threads: The new threads are added to the pending queue.	The event is closed. New threads: The new threads are added to the pending queue.

Component : wd240vm.dll