VkMsgApp(3x)VkMsgApp(3x)NAMEVkMsgApp - 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 DESCRIPTIONVkMsgApp 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
The same guidelines for deriving from VkApp apply to VkMsgApp
subclasses.
FUNCTION DESCRIPTIONSVkMsgApp()
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
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
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 CLASSVkMsgAppSEE 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
Page 3