Application Data Access Functions

VkApp provides the following data access functions for retrieving data useful for your application:

 

 

Function

Description

char *name() const

Returns command name you used to invoke the application (argv[0]).

char *applicationClassName() const

Returns application class name set in the VkApp constructor. This application class name is used when loading application resources.

virtual const char *className() const

Returns class name of VkApp (or subclass) instance being used. By default, this is "VkApp". Unlike all other ViewKit ObjectPak components, the VkApp class does not use the value returned by className() when loading resources; instead, it uses the application class name that you provide as an argument to the VkApp constructor. This allows you to set the application class name without creating a subclass of VkApp.

XtAppContext appContext() const

Returns application's XtAppContext structure, is required by many OSF/Motif and Xt functions.

Display *display() const

Returns a pointer to X Display structure associated with application's X server connection.

char *shellGeometry() const

Returns a string containing the geometry of the application's base shell. You may want to use this information to size other windows in your application.

int argc() const

Returns number of items remaining in the argv array after all arguments recognized by Xt have been removed.

char **argv() const

Called without arguments, returns pointer to the argv array after all arguments recognized by Xt have been removed.

char *argv(int index) const

Called with an integer argument, returns a single argv array item (after all arguments recognized by Xt have been removed) specified by the index argument.

Boolean startupIconified() const

Called with no arguments, returns value TRUE if the application starts with all windows iconified and FALSE if it starts with all windows displayed normally.

Widget baseWidget()

For the VkApp class, baseWidget() returns the hidden shell widget.