Views
Foundation Package API Reference Guide
Product Documentation:
Views Documentation Home
Classes | Macros | Typedefs | Enumerations | Functions
ilv.h File Reference
#include <ilviews/base/list.h>
#include <ilviews/base/array.h>
#include <ilviews/base/geometry.h>
#include <ilviews/base/stylist.h>
#include <ilviews/base/resource.h>
#include <ilviews/base/event.h>
#include <ilviews/base/iostream.h>
#include <ilviews/base/port.h>

Classes

class  IlvDisplay
 Display class. More...
 
class  IlvTransformer
 Geometric transformation class. More...
 

Macros

#define IlvDefaultMarkerSize
 
#define IlvMarkerCircle
 
#define IlvMarkerCross
 
#define IlvMarkerDiamond
 
#define IlvMarkerFilledCircle
 
#define IlvMarkerFilledDiamond
 
#define IlvMarkerFilledSquare
 
#define IlvMarkerFilledTriangle
 
#define IlvMarkerPlus
 
#define IlvMarkerSquare
 
#define IlvMarkerTriangle
 

Typedefs

typedef void(* IlvDisplayCallback) (IlAny userArg)
 
typedef void(* IlvDisplayConfigCallback) (IlvDisplayConfig *config)
 
typedef IlUShort IlvMarkerType
 
typedef SystemWindowType IlvSystemView
 A system-dependent type that holds a window. More...
 
typedef IlDouble IlvTransfoParam
 The type of the internal values of all IlvTransformers. More...
 

Enumerations

enum  IlvLookStyle {
  IlvOtherLook, IlvMotifLook, IlvWindowsLook, IlvWindows95Look,
  IlvWindowsXPLook, IlvVXLook, IlvCSSLook
}
 Predefined positioning and direction values. More...
 

Functions

void IlvFatalError (const char *format,...)
 Outputs an error message. More...
 
const char * IlvGetDefaultHome ()
 Retrieves the default Rogue Wave Views Home directory. More...
 
const char * IlvGetMessage (IlvDisplay *display, const char *label)
 Alias for IlvDisplay::getMessage() More...
 
void IlvPrint (const char *format,...)
 Outputs a message. More...
 
void IlvSetDefaultHome (const char *defaultHome)
 Sets the default Rogue Wave Views Home directory. More...
 
IlvLocaleExtension * IlvSetLocale (const char *locale=0)
 Sets the language of the application according to the locale environment. More...
 
void IlvWarning (const char *format,...)
 Outputs a warning message. More...
 

Detailed Description

Library: xviews or winviews or mviews (mutually exclusive)

Macro Definition Documentation

◆ IlvDefaultMarkerSize

#define IlvDefaultMarkerSize

The default size of an IlvMarker.

◆ IlvMarkerCircle

#define IlvMarkerCircle

A cross sign.

See also
IlvMarkerType.

◆ IlvMarkerCross

#define IlvMarkerCross

A plus sign.

See also
IlvMarkerType.

◆ IlvMarkerDiamond

#define IlvMarkerDiamond

A stroked diamond.

See also
IlvMarkerType.

◆ IlvMarkerFilledCircle

#define IlvMarkerFilledCircle

A filled circle.

See also
IlvMarkerType.

◆ IlvMarkerFilledDiamond

#define IlvMarkerFilledDiamond

A filled diamond.

See also
IlvMarkerType.

◆ IlvMarkerFilledSquare

#define IlvMarkerFilledSquare

A filled square.

See also
IlvMarkerType.

◆ IlvMarkerFilledTriangle

#define IlvMarkerFilledTriangle

A filled triangle.

See also
IlvMarkerType.

◆ IlvMarkerPlus

#define IlvMarkerPlus

A plus sign.

See also
IlvMarkerType.

◆ IlvMarkerSquare

#define IlvMarkerSquare

A stroked square.

See also
IlvMarkerType.

◆ IlvMarkerTriangle

#define IlvMarkerTriangle

A stroked triangle.

See also
IlvMarkerType.

Typedef Documentation

◆ IlvDisplayCallback

IlvDisplayCallback

This type defines the prototype of the functions used as callbacks when the look or the language are dynamically changed.

Parameters
userArgThe user argument that was provided when the callback was set.
See also
IlvDisplay::addChangeLookCallback(), IlvDisplay::addChangeLanguageCallback().

◆ IlvDisplayConfigCallback

IlvDisplayConfigCallback

This type defines the prototype of the function that can be used as a display configuration callback, which is used in the IlvDisplay constructors.

Parameters
configThe display configuration created by the constructor of IlvDisplay.

◆ IlvMarkerType

◆ IlvSystemView

A system-dependent type that holds a window.

  • On Windows, you can safely cast an IlvSystemView to a HWND to get the real Windows handle of that view.
  • On Unix, you can safely cast an IlvSystemView to a Window to get the real X11 Window identifier.

◆ IlvTransfoParam

The type of the internal values of all IlvTransformers.

The IlvTransformer API is based on the IlvTransfoParam type, which stores floating point data. The manner in which data is stored depends on the machine.

Enumeration Type Documentation

◆ IlvLookStyle

Predefined positioning and direction values.

This enum type defines the look and feel used by graphic objects in an IlvDisplay instance. By default, only one style is available in a Rogue Wave Views program, and that is the standard style of the current computer system.

To use more than one style in your program, use the corresponding compiler flag, or add the corresponding style header file directive to your implementation file (before any other #include directive).
The header files are ilviews/motif.h, ilviews/windows.h, ilviews/win95.h, ilviews/winxp.h, ilviews/vx.h and ilviews/css.h.

See also
IlvDisplay::setCurrentLook(), IlvDisplay::setLookFeelHandler(), IlvDisplay::getLookFeelHandler(), IlvDisplay::getCurrentLook().
Enumerator
IlvOtherLook 

This value is used to describe a user defined look and feel.

IlvMotifLook 

The Motif look and feel.

IlvWindowsLook 

The Windows 3.1 look and feel.

IlvWindows95Look 

The Windows 95 look and feel. This also covers Windows 98, Windows NT 4.0, and Windows 2000.

IlvWindowsXPLook 

The Windows XP look and feel. This look is available only on machines running Windows XP.

IlvVXLook 

The ViewsX look and feel.

IlvCSSLook 

The CSS look and feel.

Function Documentation

◆ IlvFatalError()

void IlvFatalError ( const char *  format,
  ... 
)

Outputs an error message.

This function calls the fatal() member function of the error handler that is installed, if there is one.

The default behavior outputs the message on the standard output stream (or the output TTY on Windows).

Parameters
formatA formatting string that is interpreted as the regular C function printf. This function expects its parameters in the same way as printf does (function with a variable number of arguments).
See also
IlvError, IlvWarning, IlvPrint, IlvGetErrorHandler, IlvSetErrorHandler.
Note
This is an extern "C" function.

◆ IlvGetDefaultHome()

const char* IlvGetDefaultHome ( )

Retrieves the default Rogue Wave Views Home directory.

This function allows you to check the setting of ILVHOME, which is used as the base directory of many default resource files.

Returns
The current setting of the default ILVHOME value. For Rogue Wave Views <X.Y>, the default value is "C:\Program Files\Rogue Wave\Views X.Y" on Windows systems, and "/usr/local/roguewave/viewsXY" on Unix systems.
Note
This is an extern "C" function.
See also
IlvSetDefaultHome().

◆ IlvGetMessage()

const char* IlvGetMessage ( IlvDisplay display,
const char *  label 
)

Alias for IlvDisplay::getMessage()

Parameters
displayThe display.
labelThe message identifier.
See also
IlvDisplay::getMessage().

◆ IlvPrint()

void IlvPrint ( const char *  format,
  ... 
)

Outputs a message.

This function outputs the message on the standard output stream (or the output TTY on Windows).

Parameters
formatA formatting string that is interpreted as the regular C function printf. This function expects its parameters in the same way as printf does (function with a variable number of arguments).
See also
IlvFatalError, IlvWarning.
Note
This is an extern "C" function.

◆ IlvSetDefaultHome()

void IlvSetDefaultHome ( const char *  defaultHome)

Sets the default Rogue Wave Views Home directory.

This global function sets the setting of the default ILVHOME value to a copy of the string defaultHome.

You may want to force this setting if you want to provide a reasonable default value for a specific application without requesting the user to set the environment variable ILVHOME or the display resource Home.

Parameters
defaultHomeThe new default Home setting.
Note
This is an extern "C" function.
See also
IlvGetDefaultHome().

◆ IlvSetLocale()

IlvLocaleExtension* IlvSetLocale ( const char *  locale = 0)

Sets the language of the application according to the locale environment.

IlvSetLocale() must be called before creating an instance of IlvDisplay. The implementation of this function is platform dependent but is usually carried out by calling setlocale(LC_ALL, "");.

Please check the User's Manual for a list of supported locales.

Parameters
localeA platform dependent string specifying the locale. If 0, the default user locale is used.
Returns
A pointer to an internal class. If success, the returned value is not 0.
Note
This is an extern "C" function.

◆ IlvWarning()

void IlvWarning ( const char *  format,
  ... 
)

Outputs a warning message.

This function calls the warning() member function of the error handler that is installed, if there is one.

The default behavior outputs the message on the standard output stream (or the output TTY on Windows).

Parameters
formatA formatting string that is interpreted as the regular C function printf. This function expects its parameters in the same way as printf does (function with a variable number of arguments).
See also
IlvError, IlvFatalError, IlvPrint, IlvGetErrorHandler, IlvSetErrorHandler.
Note
This is an extern "C" function.