rwlogo
Rogue Wave Views 5.5.1

Rogue Wave Views
Foundation Package API Reference Guide

Product Documentation:

Rogue Wave Views
Documentation Home

evloop.h File Reference

#include <ilviews/macros.h>
#include <ilog/list.h>

Classes

class  IlvEventLoop
 Event loop class. More...

Typedefs

typedef IlBoolean(* IlvIdleProc )(IlAny userArg)
typedef IlAny IlvIdleProcId

Enumerations

enum  IlvInputMask {
  IlvInputNone, IlvInputEvent, IlvInputTimer, IlvInputExternal,
  IlvInputAll
}
 

Sources of input in the event loop.

More...

Functions

void IlvExit (int exitCode)
 Exits the application.
void IlvMainLoop ()
 Starts the event loop.

Detailed Description

[library display ilviews/base/evloop.h] Event loop related declarations


Typedef Documentation

Function type for user idle procedures.

Defines a function type for a user idle procedure that takes a user argument as its parameter. This type is used in IlvEventLoop::addIdleProc.

Identifier for idle procedure entries.

This type is an opaque type used by the event loop to identify an idle procedure entry.

See also:
IlvEventLoop::removeIdleProc.

Enumeration Type Documentation

Sources of input in the event loop.

Type used to indicate the different sources of input in the event loop. It is possible to use OR combinations of IlvInputEvent, IlvInputTimer, and IlvInputExternal to specify several types of input. For this reason, IlvInputMask is defined in such a way that: IlvInputNone == 0 and IlvInputAll == (IlvInputEvent | IlvInputTimer | IlvInputExternal).

Enumerator:
IlvInputNone 

No input.

Indicates no source of input.

IlvInputEvent 

Events.

Indicates windowing system events, that is, IlvEvent as source of input.

IlvInputTimer 

Timers.

Indicates IlvTimer objects as source of input.

IlvInputExternal 

External input.

Indicates external sources of input, that is, input channel used by IlvEventLoop::registerInput

IlvInputAll 

All sources of input.

Indicates a combination of all the sources of input.


Function Documentation

void IlvExit ( int  exitCode  ) 

Exits the application.

This function is a Rogue Wave Views version of the regular C runtime function exit, but performs more cleanups.

Parameters:
exitCode A value that is returned to the system for possible error handling.
See also:
IlvMainLoop.
void IlvMainLoop (  ) 

Starts the event loop.

This global function starts the main Rogue Wave Views event loop. It gives control of your application to the event loop.
It then waits for incoming events from all the created instances of IlvDisplay and dispatches the event to the appropriate handlers. This function does not return. The only way to stop a Rogue Wave Views application is to exit the program, using IlvExit, in one of the application callbacks.
You can replace this function with system-specific function calls that better fit your application requirements:

See also:
IlvExit

© Copyright 2012, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.