Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmtInitializeApplicationSheLibrary Functions MXmtInitializeApplicationShell(3)

NAME
       XmtInitializeApplicationShell() - set initial application resource val-
       ues.

SYNOPSIS
       #include	<Xmt/AppRes.h>

       void XmtInitializeApplicationShell(Widget w, ArgList args, Cardinal
		      num_args)

ARGUMENTS
       INPUTS

       w      The  root	shell widget to	be registered and have its application
	      resources	read, or any descendant	of that	widget.

       args   An array of resource name/value pairs  to	 override  application
	      resource	values	specified  in  the resource database or	on the
	      command line.

       num_args
	      The number of elements in	the args array.

DESCRIPTION
       XmtInitializeApplicationShell()	obtains	 values	 for  the  application
       resources  used by the Xmt library from the resource database and over-
       rides them with any values specified in the args	 array.	 These	values
       are  stored in a	private	structure associated with the shell widget for
       later use by the	library. This function also initializes	 some  private
       values  that the	Xmt library maintains for each root shell in an	appli-
       cation. See Chapter 7, Application  Resources  and  Command-Line	 Argu-
       ments, for a complete list of the Xmt application resources.

       XmtInitializeApplicationShell()	does  not  make	 copies	 of any	string
       resources passed	to it. This means that any strings passed in the  args
       array  must be constants	or must	be in memory that will not be modified
       or freed.

       You need	only  call  XmtInitializeApplicationShell()  if	 you  want  to
       explicitly  hardcode  some  application	resource  values with the args
       array. If you do	not call this function your self, the Xmt library will
       call it the first time it needs to look up an application resource.

       XmtInitializeApplicationShell()	has  another  purpose-it registers the
       name of the specified application shell for  use	 by  XmtNameToWidget()
       and  the	 Xmt  String-to-Widget	converter.   This is important only in
       applications that have more than	one root shell widget, and want	to  be
       able  to	 refer	to widgets by name between the separate	widget hierar-
       chies.

SEE ALSO
       Chapter 7, Application Resources	and Command-Line Arguments,
       XmtGetApplicationValues(), XmtInitialize(), XmtNameToWidget(),
       XmtParseCommandLine(), XmtSetApplicationValues().

Xmt				  Motif	Tools XmtInitializeApplicationShell(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XmtInitializeApplicationShell&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help