VkMsgApp(3x)							  VkMsgApp(3x)

NAME    [Toc]    [Back]

     VkMsgApp -	Class used by messaging	applications to	handle initialization

INHERITS FROM    [Toc]    [Back]

     VkApp : VkComponent : VkCallbackObject

HEADER FILE    [Toc]    [Back]

     #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    [Toc]    [Back]
	   VkMsgClient*	messageClient(void);


   Access Methods    [Toc]    [Back]
	   Boolean noProtocol()

X RESOURCES ASSOCIATED WITH THIS CLASS    [Toc]    [Back]

	   projectWindow
	   projectSelect
	   project
	   privateProject

CLASS DESCRIPTION    [Toc]    [Back]

	  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.



									Page 1






VkMsgApp(3x)							  VkMsgApp(3x)



	  The default is "-project default".

DERIVING SUBCLASSES    [Toc]    [Back]

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

FUNCTION DESCRIPTIONS    [Toc]    [Back]

   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    [Toc]    [Back]

   Inherited from VkApp





									Page 2






VkMsgApp(3x)							  VkMsgApp(3x)



	  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    [Toc]    [Back]
	  installDestroyHandler(), removeDestroyHandler(), widgetDestroyed(),
	  setDefaultResources(), getResources(), manage(), unmanage(),
	  baseWidget(),	okToQuit(), _name, _baseWidget,	_w, deleteCallback


   Inherited from VkCallbackObject    [Toc]    [Back]
	  callCallbacks(), addCallback(), removeCallback(),
	  removeAllCallbacks()


CLASSES	USED BY	THIS CLASS
     VkComponentList, VkMsgClient, VkMsgService

KNOWN CLASSES THAT USE THIS CLASS    [Toc]    [Back]

     VkMsgApp

SEE ALSO    [Toc]    [Back]

     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


									PPPPaaaaggggeeee 3333