Using the Default Look and Feel

By default, only one style is used in a given Rogue Wave® Views program, which is the standard style of the computer system:

ViewsX style on UNIX®

Microsoft® Windows 3®.11 style on Windows 3.x and Microsoft Windows NT 3.x

Microsoft Windows 95 style on Windows 95 Windows NT 4, and Windows 2000

Microsoft Windows XP style on Windows XP and later versions

Note: You can override this default setting by using the ILVLOOK environment variable, or the LOOK resource. In this case, be sure to provide access to the specified look to your application, or it will not be used. See the section Using Several Look and Feel and Dynamic Loading of Look and Feel.

Note: The Microsoft Windows XP style is only available on computers running Microsoft Windows XP and later versions. A Rogue Wave Views application built on a Microsoft Windows XP (or later) platform may not run on a previous version of Microsoft Windows (Windows 2000, NT, and so on). For more details, see the section Using the Windows XP Look and Feel.

Depending on the platform on which you are building your application, it must be linked with the corresponding look-and-feel libraries. The following tables sum up the different libraries available:

Look Libraries for Windows Platforms
Look	Standard Gadgets Library	Advanced Gadgets Library
Motif	ilvmlook.lib	ilvamlook.lib
Windows 3.11	ilvwlook.lib	ilvawlook.lib
Windows 95	ilvw95look.lib, ilvwlook.lib	ilvaw95look.lib, ilvawlook.lib
Windows XP	ilvwxplook.lib, ilvw95look.lib, ilvwlook.lib, uxtheme.lib	ilvawxplook.lib, ilvaw95look.lib, ilvawlook.lib
ViewsX	ilvvxlook.lib, ilvwlook.lib	ilvavxlook.lib,ilvawlook.lib

Note that the uxtheme.lib is a Microsoft library. If this library is not present on your computer, it is available in the Microsoft Platform SDK. To get the SDK, go to http://www.microsoft.com/downloads/details.aspx?FamilyId=A55B6B43-E24F-4EA3-A93E-40C0EC4F68E5&displaylang=en.

Look Libraries for UNIX Platforms
Look	Standard Gadgets Library	Advanced Gadgets Library
Motif	libilvmlook	libilvamlook
Windows 3.11	libilvwlook	libilvawlook
Windows 95	libilvw95look, libilvwlook	libilvaw95look, libilvawlook
ViewsX	libilvvxlook, libilvwlook	libilvavxlook,libilvawlook

Note: Windows XP look is not mentioned in the above table, because this look is only available for platforms running the Microsoft Windows XP (or later) operating system. For more details, see the section Using the Windows XP Look and Feel.

For example, if you are building a program using the Rogue Wave Views standard gadget library (See the section Gadgets Libraries for details) on Microsoft Windows 95, you will need to link with ilvw95look.lib, ilvwlook.lib.

Similarly, if you are building a program using the Rogue Wave Views advanced gadget library on UNIX, you will need to link with libilvmlook and libilvamlook.

However, if you are using shared libraries, you can avoid linking with look-and-feel libraries. See the section Dynamic Loading of Look and Feel.

Note: On Windows platforms, linking with the look-and-feel libraries is not required, even when using static libraries. The libraries needed by the application will be automatically linked with it thanks to specific directives put in header files.

If you want to use several styles in your program, you must add a compiler option or an include file to indicate which of the additional styles you want to use:

In the compiler flags, define the symbol names for the styles you want to use:

In your implementation file, and before any other #include directive, include the style header file. Note that if a header file declaring a gadget class precedes one of these header files, the corresponding virtual styles will not be loaded in your program. This may result in a crash when you change the style of your application.

You must also link your application with the look-and-feel gadget libraries corresponding to the looks used by your application. See Table 9.1 and Table 9.2.

However, if you are using shared libraries, you can avoid linking with look-and-feel libraries. See the section Dynamic Loading of Look and Feel.

Note: If you do not want the default look and feel to be used, you must compile with the ILVNODEFAULTLOOK flag. Compiling with this flag will prevent you from linking with the default look-and-feel libraries.

When using the dynamic loading of look and feel, you do not have to care about which look and feel your application will use. Depending on what is needed by the application, the looks will be loaded at runtime. This means that you do not have to link your application with any look-and-feel specific library.

You must use shared libraries (or DLL for Microsoft® Windows®). This is the sine qua none condition without which dynamic loading of modules is not possible.

You must not include look specific header files, or you will have to link with the corresponding libraries.

You must compile with the ILVNODEFAULTLOOK symbol defined, or you will have to link with the default look libraries.

Note: Using the dynamic loading of look and feel is strongly encouraged, as it allows the application to be completely independent of the style used at runtime.

The method IlvGraphic::getLookFeelHandler() is used to query an object about its look-and-feel handler. The default implementation is to use the look-and-feel handler defined by the object holder.

The method IlvGraphicHolder::getLookFeelHandler() is used to query a holder about its look-and-feel handler. The default implementation is to use the look-and-feel handler defined by the holder display instance.

The method IlvDisplay::getLookFeelHandler() is used to query a display instance about its look-and-feel handler. The default value is defined by the platform on which the application has been built. See the section Using the Default Look and Feel for details.

It is possible to change the look of a single gadget, of a whole container, or of the whole application by using respectively the methods IlvGadget::setLookFeelHandler, IlvGadgetContainer::setLookFeelHandler, and IlvDisplay::setLookFeelHandler.

A look-and-feel handler is a subclass of the IlvLookFeelHandler class. Each handler has a unique name that identifies it. Here are the names for the five predefined look-and-feel styles:

A look-and-feel handler is associated to a display instance. To obtain an instance of a look-and-feel handler, use the method getLookFeelHandler that takes a name as parameter:

If the required look and feel has already been created for this display, it is returned, otherwise a new one is created. If the look and feel cannot be created, the method returns 0.

As seen above, the method setLookFeelHandler should be used to change the look and feel of the whole display. However, the Rogue Wave Views 4.0 API used to define an enum (IlvLookStyle) to describe predefined looks. This enum can still be used as follow:

The following member functions of the IlvDisplay class let you manipulate the setting of the look display resource using this enum:

getCurrentLook returns the current style identifier used by this display instance. If the current look and feel of the display is not one of the predefined look-and-feel styles, IlvOtherLook is returned.

setCurrentLook sets the style identifier used by this display instance to style.

addChangeLookCallback and lets you add user-defined functions that are called when the style is dynamically changed.

removeChangeLookCallback lets you remove user-defined functions that are called when the style is dynamically changed.

Although the Microsoft® Windows® 3.11, Microsoft Windows 95, ViewsX and Motif styles are independent of the platform, the Microsoft Windows XP style uses the Microsoft Windows operating system to draw the components. This means that you can only use this style on a platform running Microsoft Windows XP or later versions. This also means that if a new theme is available in later versions of Microsoft Windows, it will also be available to Rogue Wave Views applications.

Note: You can build an application using the Microsoft Windows XP style on any other Microsoft Windows platform. In this case, you may need to install the Microsoft Platform SDK. To get the SDK, go to http://www.microsoft.com/downloads/details.aspx?FamilyId=A55B6B43-E24F-4EA3-A93E-40C0EC4F68E5&displaylang=en.

When using the Rogue Wave Views DLLs (dll_md, or dll_mda), the Microsoft Windows XP style can be dynamically loaded when needed. This means that you can build a Rogue Wave Views application that can be run on any Microsoft Windows platform. The application will load the Microsoft Windows XP style if it is needed. See Dynamic Loading of Look and Feel for more details.

When building a Rogue Wave Views application using the default style on a Microsoft Windows XP (or later) platform, the flag WINVER must be set to 0x501 when compiling your application, otherwise only the Microsoft Windows 95 style will be registered. See Using the Default Look and Feel.

A Rogue Wave Views application using the Microsoft Windows XP style and the Rogue Wave Views static libraries can only be run on platforms running Microsoft Windows XP or later versions. If you want to compile a Rogue Wave Views application on a Microsoft Windows XP (or later) platform and you want this application to run on any Windows platform, you can either not define the WINVER flag, or define the ILVNODEFAULTLOOK flag. In this last case, you will need to link your application with look-and-feel libraries other than XP libraries. See Using Several Look and Feel for more details.

As the dynamic loading of modules is disabled when using static libraries, your application needs to be linked with the right libraries. See Look Libraries for Windows Platforms.