Globals: Info Messages

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 );
   }