GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMTBUILDAPPLICATION (3)

NAME

XmtBuildApplication(), XmtBuildQueryApplication() - create a root ApplicationShell widget and all of its descendants.

CONTENTS

SYNOPSIS

   #include <Xmt/Create.h>

   Widget XmtBuildApplication(String appname, String appclass, Display *display, ArgList args, Cardinal num_args)

   Widget XmtBuildQueryApplication(String appname, String appclass, Display *display, ArgList args, Cardinal num_args,
{ String child_name, Widget *child_address, }
NULL)

ARGUMENTS

INPUTS
appname The name of the root application shell to be created.
appclass The resource class name of the root application shell to be created.
display The X Display on which the application shell is to be created.
args An array of name/value pairs of resources to be set on the newly created application shell.
num_args The number of elements in args.
child_name The name of a widget to be returned. May be repeated any number of times in a NULL-terminated variable-length argument list.
OUTPUTS
child_address
  The address at which the widget specified by child_name is to be stored. May be repeated any number of times in a NULL-terminated variable length argument list. RETURNS

The newly created root ApplicationShell widget.

DESCRIPTION

XmtBuildApplication() and XmtBuildQueryApplication() create a root ApplicationShell widget by calling XtAppCreateShell(), with their appname, appclass, display, args and num_args arguments. Then they read the xmtChildren resource of the newly created shell and recursively create all the descendants of the shell, in the same way that XmtCreateChildren() and XmtCreateQueryChildren() do. Like XmtCreateQueryChildren(), XmtBuildQueryApplication() can return pointers to some of the widgets it creates.

USAGE

Most applications will only have a single root Application Shell widget, created by their call to XtAppInitialize() or XmtInitialize(). Applications that do create additional root widgets may use these functions to create those shells and their descendants.

Use XmtBuildToplevel() and XmtBuildDialog() to create Top LevelShell widgets and dialog boxes in a similar way.

SEE ALSO

Chapter 11, Automatic Widget Creation,
XmtBuildDialog(), XmtBuildToplevel(), XmtCreateChildren(), XmtCreateQueryChildren(), XmtInitialize(), XtAppCreateShell(), XtAppInitialize().
Search for    or go to Top of page |  Section 3 |  Main Index


Xmt XMTBUILDAPPLICATION (3) Motif Tools

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.