<!-- $XConsortium: MainWinE.sgm /main/8 1996/09/08 20:53:34 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->

<RefEntry Id="CDEMMA.MAN323.rsml.1">
<RefMeta>
<RefEntryTitle>XmMainWindowSetAreas</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmMainWindowSetAreas</Function></RefName>
<RefPurpose>A MainWindow function that identifies manageable children for each area
<IndexTerm>
<Primary>XmMainWindowSetAreas</Primary>
</IndexTerm><IndexTerm>
<Primary>MainWindow functions</Primary>
<Secondary>XmMainWindowSetAreas</Secondary>
</IndexTerm></RefPurpose>
</RefNameDiv>
<!-- -->
<!-- @OSF_COPYRIGHT@-->
<!-- COPYRIGHT NOTICE-->
<!-- Copyright (c) 1990, 1991, 1992, 1993 Open Software Foundation, Inc.-->
<!-- ALL RIGHTS RESERVED (MOTIF). See the file named COPY.MOTIF.DOC for-->
<!-- the full copyright text.-->
<!-- -->
<!-- HISTORY-->
<!-- -->
<!-- **-->
<!-- **-->
<!-- **  (c) Copyright 1989, 1990, 1992 by Open Software Foundation, Inc.-->
<!-- **      All Rights Reserved.-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988 by Digital Equipment Corporation,-->
<!-- **      Maynard, MA.  All Rights Reserved.-->
<!-- **-->
<!-- **-->
<RefSynopsisDiv>
<FuncSynopsis>
<FuncSynopsisInfo>#include &lt;Xm/MainW.h>
</FuncSynopsisInfo>
<FuncDef>void <Function>XmMainWindowSetAreas</Function></FuncDef>
<!--<ParamDef><Replaceable>widget, menu_bar, command_window,
horizontal_scrollbar, vertical_scrollbar, work_region</Replaceable></ParamDef>-->
<ParamDef>Widget <Parameter>widget</Parameter></ParamDef>
<ParamDef>Widget <Parameter>menu_bar</Parameter></ParamDef>
<ParamDef>Widget <Parameter>command_window</Parameter></ParamDef>
<ParamDef>Widget <Parameter>horizontal_scrollbar</Parameter></ParamDef>
<ParamDef>Widget <Parameter>vertical_scrollbar</Parameter></ParamDef>
<ParamDef>Widget <Parameter>work_region</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmMainWindowSetAreas</Function> identifies which of the valid children for each
area (such as the MenuBar and work region) are to be actively managed by MainWindow.
This function also sets up or adds the MenuBar, work window, command
window, and ScrollBar widgets to the application's main window widget.
</Para>
<Para>Each area is optional; therefore, the user can pass NULL to one or more
of the following arguments. The window manager provides the title bar.
</Para>
<Para><Literal>NOTE:</Literal> <Function>XmMainWindowSetAreas</Function> is obsolete and exists for
compatibility with previous releases.
The information previously returned by this function can now be
obtained through a call to <Function>XtGetValues</Function> on the
<SystemItem Class="Resource">XmNscrolledWindowChildType</SystemItem> resource.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">widget</Symbol></Term>
<ListItem>
<Para>Specifies the MainWindow widget ID.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">menu_bar</Symbol></Term>
<ListItem>
<Para>Specifies the widget ID for the MenuBar to be associated
with the MainWindow widget. Set this ID only after creating an instance
of the MainWindow widget. The attribute name associated with this
argument is <SystemItem Class="Resource">XmNmenuBar</SystemItem>.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">command_window</Symbol></Term>
<ListItem>
<Para>Specifies the widget ID for the command window
to be associated
with the MainWindow widget. Set this ID only after creating an instance
of the MainWindow widget. The attribute name associated with this
argument is <SystemItem Class="Resource">XmNcommandWindow</SystemItem>.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">horizontal_scrollbar</Symbol></Term>
<ListItem>
<Para>Specifies the ScrollBar widget ID for the
horizontal ScrollBar to be associated
with the MainWindow widget. Set this ID only after creating an instance
of the MainWindow widget. The attribute name associated with this
argument is <SystemItem Class="Resource">XmNhorizontalScrollBar</SystemItem>.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">vertical_scrollbar</Symbol></Term>
<ListItem>
<Para>Specifies the ScrollBar widget ID for the
vertical ScrollBar to be associated
with the MainWindow widget. Set this ID only after creating an instance
of the MainWindow widget. The attribute name associated with this
argument is <SystemItem Class="Resource">XmNverticalScrollBar</SystemItem>.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">work_region</Symbol></Term>
<ListItem>
<Para>Specifies the widget ID for the work window to be associated
with the MainWindow widget. Set this ID only after creating an instance
of the MainWindow widget. The attribute name associated with this
argument is <SystemItem Class="Resource">XmNworkWindow</SystemItem>.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>For a complete definition of MainWindow and its associated resources, see
&cdeman.XmMainWindow;.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmMainWindow;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
