Files
cdesktop/cde/doc/C/guides/man/m3_Dt/Initiali.sgm

75 lines
3.1 KiB
Plaintext

<!-- $XConsortium: Initiali.sgm /main/8 1996/09/04 15:34:02 cdedoc $ -->
<!-- (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. -->
<![ %CDE.C.CDE; [<RefEntry Id="CDEMX.XCDI.MAN47.rsml.1">]]>
<![ %CDE.C.XO; [<RefEntry Id="XCDI.MAN47.rsml.1">]]>
<RefMeta>
<RefEntryTitle>DtInitialize</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>DtInitialize</Function>,
<Function>DtAppInitialize</Function>
</RefName>
<RefPurpose>initialize the Desktop Services library
</RefPurpose>
</RefNameDiv>
<RefSynopsisDiv>
<FuncSynopsis Remap="ANSI">
<FuncSynopsisInfo>#include &lt;Dt/Dt.h>
</FuncSynopsisInfo>
<FuncDef>Boolean <Function>DtInitialize</Function></FuncDef>
<ParamDef>Display *<Parameter>display</Parameter></ParamDef>
<ParamDef>Widget <Parameter>widget</Parameter></ParamDef>
<ParamDef>char *<Parameter>name</Parameter></ParamDef>
<ParamDef>char *<Parameter>tool_class</Parameter></ParamDef>
<FuncDef>Boolean <Function>DtAppInitialize</Function></FuncDef>
<ParamDef>XtAppContext <Parameter>app_context</Parameter></ParamDef>
<ParamDef>Display *<Parameter>display</Parameter></ParamDef>
<ParamDef>Widget <Parameter>widget</Parameter></ParamDef>
<ParamDef>char *<Parameter>name</Parameter></ParamDef>
<ParamDef>char *<Parameter>tool_class</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para>These functions perform the one-time initialization in the
Desktop Services library.
Applications must call either
<Function>DtInitialize</Function> or
<Function>DtAppInitialize</Function> before calling any other Desktop Services library routines.
</Para>
<Para>The difference between these two functions is whether
<Emphasis>app_context</Emphasis> is specified.
<Function>DtInitialize</Function> uses the default Intrinsic
<StructName Role="typedef">XtAppContext</StructName>.</Para>
<Para>The
<Emphasis>app_context</Emphasis> argument is the application context,
<Symbol Role="Variable">display</Symbol> is the X display connection,
<Symbol Role="Variable">widget</Symbol> is the application's top-level Widget,
<Symbol Role="Variable">name</Symbol> is the application name and
<Emphasis>tool_class</Emphasis> is the application class.
</Para>
</RefSect1>
<RefSect1>
<Title>RETURN VALUES</Title>
<Para>Upon successful completion,
<Function>DtAppInitialize</Function> and
<Function>DtInitialize</Function> return True if the library has been
correctly initialized;
otherwise, they return False.
</Para>
</RefSect1>
<RefSect1>
<Title>SEE ALSO</Title>
<Para><Function>XtAppInitialize</Function>(3), <Function>XtToolkitInitialize</Function>(3), <![ %CDE.C.CDE; [<Function>XtCreateApplicationContext</Function>(3). ]]><![ %CDE.C.XO; [<Function>XtCreateApplicationContext</Function> in the &str-Zt;.
]]></Para>
</RefSect1>
</RefEntry>
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 23:18:47-->