VkMsgApp(3x)

NAME
     VkMsgApp - Class used by messaging applications to handle initialization

INHERITS FROM
     VkApp : VkComponent : VkCallbackObject

HEADER FILE
     #include <Vk/VkMsgApp.h>

PUBLIC PROTOCOL SUMMARY
   Constructor/Destructor
           VkMsgApp(char*             appClassName,
                    int*              argc_c,
                    char**            arg_v,
                    XrmOptionDescRec* optionList = NULL,
                    int                sizeOfOptionList = 0,
                    const char*        ptid = NULL,
                    const char*        sessid = NULL,
                    Boolean            noProtocol = False);

           virtual void ~VkMsgApp(void);


   Message Facility Access
           VkMsgClient* messageClient(void);


   Access Methods
           Boolean noProtocol()


X RESOURCES ASSOCIATED WITH THIS CLASS
           projectWindow
           projectSelect
           project
           privateProject


CLASS DESCRIPTION
          VkMsgApp is used instead of VkApp by applications which use the
          ViewKit message facility.  It creates a VkMsgService object and
          provides basic project support.

          Three new command-line options provide control over the ToolTalk
          session.

            -project will specify a session ID.

            -projectWindow will specify a window containing a session ID.

            -projectSelect will allow the user to click on a window containing
          a session ID.
          The default is "-project default".


DERIVING SUBCLASSES
          The same guidelines for deriving from VkApp apply to VkMsgApp
          subclasses.



FUNCTION DESCRIPTIONS
   VkMsgApp()
           VkMsgApp(char*             appClassName,
                    int*              argc_c,
                    char**            arg_v,
                    XrmOptionDescRec* optionList = NULL,
                    int               sizeOfOptionList = 0,
                    const char*       ptid = NULL,
                    const char*       sessid = NULL,
                    Boolean           noProtocol = False);

           virtual void ~VkMsgApp(void);


          Two new arguments are added to the normal VkApp constructor
          arguments.  The sixth argument is the process type (ptype).  It
          defaults to NULL, which indicates no ptype.  The seventh is the
          session to join.  It defaults to NULL, which indicates the default
          session.  The last argument defaults to False, and controls whether
          VkMsgApp automatically implements handling for "Lower", "Raise", and
          "Quit" messages.  These messages are standard, and cause the calling
          of the iconify, open/raise, and quitYourself methods of VkApp.

   messageClient()
           VkMsgClient* messageClient(void);


          Returns a pointer to the VkMsgClient object for access to message
          facility functionality.  See the VkMsgClient man page for more
          details.

   noProtocol()
           Boolean noProtocol(void);


          Returns the value of the noProtocol constructor argument.  If TRUE,
          then VkMsgApp does not automatically handle the standard "Lower",
          "Raise", and "Quit" messages.

INHERITED MEMBER FUNCTIONS
   Inherited from VkApp

          afterRealizeHook(), show(), hide(), name(), className(),
          parseCommandLine(), VkApp(), setVersionString(), versionString(),
          terminate(), handlePendingEvents(), quitYourself(),
          handleRawEvent(), setMainWindow(), raise(), lower(), iconify(),
          open(), startupIconified(), busyCursor(), normalCursor(),
          setNormalCursor(), setBusyCursor(), showCursor(), busy(),
          veryBusy(), notBusy(), setBusyDialog(), appContext(), display(),
          argv(), argv(), argc(), applicationClassName(), mainWindow(),
          shellGeometry(), startupIconified(), _winList, _quitSemaphore,
          ViewKitMajorRelease, ViewKitMinorRelease, ViewKitReleaseString


   Inherited from VkComponent
          installDestroyHandler(), removeDestroyHandler(), widgetDestroyed(),
          setDefaultResources(), getResources(), manage(), unmanage(),
          baseWidget(), okToQuit(), _name, _baseWidget, _w, deleteCallback


   Inherited from VkCallbackObject
          callCallbacks(), addCallback(), removeCallback(),
          removeAllCallbacks()


CLASSES USED BY THIS CLASS
     VkComponentList, VkMsgClient, VkMsgService

KNOWN CLASSES THAT USE THIS CLASS
     VkMsgApp

SEE ALSO
     VkApp, VkComponent, VkMsgApp, VkMsgClient, VkMsgService, VkMsgWindow
     ViewKit Programmer's Guide
     The X Window System, DEC Press, Bob Sheifler and Jim Gettys
     The X Window System Toolkit, DEC Press, Paul Asente and Ralph Swick
     The OSF/Motif Programmers Reference, Prentice Hall, OSF