Image Utility Instance Update Globals Table of Contents

Info Messages

Availability  LightWave® 6.0
Component  Layout, Modeler
Header  lwhost.h

This global provides a set of functions for displaying messages to the user.

Global Call

   LWMessageFuncs *msgf;
   msgf = global( LWMESSAGEFUNCS_GLOBAL, GFUSE_TRANSIENT );

The global function returns a pointer to an LWMessageFuncs.

   typedef struct st_LWMessageFuncs {
      void (*info)     (const char *, const char *);
      void (*error)    (const char *, const char *);
      void (*warning)  (const char *, const char *);
      int  (*okCancel) (const char *title, const char *, const char *);
      int  (*yesNo)    (const char *title, const char *, const char *);
      int  (*yesNoCan) (const char *title, const char *, const char *);
      int  (*yesNoAll) (const char *title, const char *, const char *);
   } LWMessageFuncs;

All of these functions allow you to display one or two lines of text. The second line is optional and may be NULL.

The first three functions are informational only. Depending on the user-defined alert level, the arguments are displayed either in a separate dialog with an OK button, or in a status area on the main window. The remaining functions allow you to ask the user questions, and they differ in the choice of responses available to the user. The possible return values are

  3 2 1 0

okCancel - - OK Cancel
yesNo - - Yes No
yesNoCan - Yes No Cancel
yesNoAll Yes to All Yes No Cancel

Example

This code fragment displays everyone's favorite first message.

   #include <lwserver.h>
   #include <lwhost.h>

   LWMessageFuncs *msgf;

   msgf = global( LWMESSAGEFUNCS_GLOBAL, GFUSE_TRANSIENT );

   if ( msgf ) {
      msgf->info( "Hello, world!", NULL );
   }