ON UEVENT - QB64 Wiki

ON UEVENT

From QB64 Wiki

Jump to: navigation, search

The ON UEVENT statement allows a program to use a user defined event procedure.


Syntax:

ON UEVENT GOSUB {linenumber | linelabel}


  • Currently NOT supported in QB64! NOTE: UEVENT procedures are only available in QuickBasic or PDS.
  • Any language(including assembly) compiler that can create interrupt service routines and uses code that can be linked with QuickBasic may be used.
  • Linenumber or linelabel argument is the line number or label of a GOSUB routine.
  • Allows your program to go to an event-handling routine when a user-defined event(often a hardware interrupt) occurs.
  • Once events have been defined with an ON event statement, they act like interrupts.
  • When UEVENT ON has been executed, the user-defined event can send the program to a GOSUB routine.
  • At least two or three code procedures are needed to set up the user-defined event.
  1. The first is the interrupt service routine using SetUEvent.
  2. The second is a routine to insert the address of the service routine into the interrupt vector table.(optional)
  3. The third is the GOSUB routine your program calls to retrieve the data or do another procedure.
  • If the initialization routine "steals" an interrupt used by another service routine, the original address MUST be restored before the program terminates.
  • Steps in creating a user-defined event:
  1. Write an event-handling routine using CALL SetUEvent and add it to your program.
  2. Use the ON UEVENT GOSUB statement to specify the user-defined event procedure.
  3. Use the UEVENT ON statement to enable event trapping.
  4. Call the interrupt-initialization routine to insert the address of the service routine into the interrupt vector table.
  • When the specified interrupt occurs, the execution is transferred to the interrupt service routine. The service routine collects and stores the data the user wants. It then calls SetUEvent. SetUEvent sets a flag checked by QuickBasic before going to the next code statement(or label if using BC.EXE compiler option /W instead of /V ). When the flag is set, control transfers to the event-handling routine in ON EVENT GOSUB.
  • The SetUEvent procedure is a part of QuickBasic, and is included in compiled programs or when the QuickBasic IDE is run with the /L command-line option. Your interrupt service routine must CALL SetUEvent.
  • If you want to return a value, you must write a procedure for your program to call. (It would usually be called by your event-handling routine.) The function MUST be DECLAREd!
  • Although ON UEVENT GOSUB ties an event-handling routine to a user-defined event, it does not enable the event trap. The UEVENT statement is used to enable, disable, and suspend user-defined event trapping.
(C) Microsoft Corporation 1988


Example: A simple user defined event.

ON UEVENT GOSUB Twenty ' set the procedure to enable UEVENT ON ' turn on event handling INPUT "Enter a number: ", entry IF entry = 20 THEN CALL SetUEvent ' trigger the event END Twenty: PRINT "The user entered twenty!" RETURN ' once an event is handled, return to last program procedure


See also:



Navigation:
Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page
Views
  • Page
  • Discussion
  • View source
  • History
Personal tools
  • Log in
Toolbox
  • What links here
  • Related changes
  • Special pages
  • Printable version