CDE/cde/doc/C/guides/man/m3_Dt/CrePrntD.sgm

<!-- $XConsortium: xprncpsb.sgm 1996  $ -->
<!-- (c) Copyright 1996 Digital Equipment Corporation. -->
<!-- (c) Copyright 1996 Hewlett-Packard Company. -->
<!-- (c) Copyright 1996 International Business Machines Corp. -->
<!-- (c) Copyright 1996 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1996 Novell, Inc. -->
<!-- (c) Copyright 1996 FUJITSU LIMITED. -->
<!-- (c) Copyright 1996 Hitachi. -->
<![ %CDE.C.CDE; [<refentry id="CDE.XPRINT.DtCreatePrintSetupDialog">]]>
<refmeta>
<refentrytitle>
DtCreatePrintSetupDialog
</refentrytitle>
<manvolnum>library call</manvolnum>
</refmeta>
<refnamediv>
<refname><function>DtCreatePrintSetupDialog</function></refname>
<refpurpose>
creates an instance of a dialog containing a <function>DtPrintSetupBox</function> widget
</refpurpose>
</refnamediv>
<refsynopsisdiv>

<funcsynopsis>
<funcsynopsisinfo>
#include &lt;Print.h>
</funcsynopsisinfo>

<funcdef>Widget <function>DtCreatePrintSetupDialog</function></funcdef>
<paramdef>Widget <parameter>parent</parameter></paramdef>
<paramdef>const String <parameter>name</parameter></paramdef>
<paramdef>ArgList <parameter>arglist</parameter></paramdef>
<paramdef>Cardinal <parameter>argcount</parameter></paramdef>
</funcsynopsis>

</refsynopsisdiv>

<refsect1>
<title>DESCRIPTION</title>
<para><function>DtCreatePrintSetupDialog</function> is a convenience function
that creates a <classname>DialogShell</classname> and an
unmanaged <classname>DtPrintSetupBox</classname> child of the
<classname>DialogShell</classname>.
Use <function>XtManageChild</function> to pop up the
print set up dialog (passing the <classname>DtPrintSetupBox</classname>
as the widget parameter); use <function>XtUnmanageChild</function> to pop it down.
</para>
</refsect1>

<refsect1>
<title>ARGUMENTS</title>
<variablelist>
<varlistentry><term><symbol role="Variable">parent</symbol></term>
<listitem>
<para>Specifies the parent widget ID.
</para>
</listitem>
</varlistentry>
<varlistentry><term><symbol role="Variable">name</symbol></term>
<listitem>
<para>Specifies the name of the created widget.
</para>
</listitem>
</varlistentry>
<varlistentry><term><symbol role="Variable">arglist</symbol></term>
<listitem>
<para>Specifies the argument list.
</para>
</listitem>
</varlistentry>
<varlistentry><term><symbol role="Variable">argcount</symbol></term>
<listitem>
<para>Specifies the number of attribute/value pairs in
<symbol role="Variable">arglist</symbol>.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>

<title>RETURN VALUE</title>
<para>If <function>DtCreatePrintSetupDialog</function> completes
successfully, it returns the <classname>DtPrintSetupBox</classname> widget ID.
If it fails, it returns <symbol role="define">NULL</symbol>.
</para>
</refsect1>

<refsect1>
<title>ENVIRONMENT VARIABLES</title>
<para>None.
</para>
</refsect1>

<refsect1>
<title>RESOURCES</title>
<para>None.</para>
</refsect1>

<refsect1>
<title>ACTIONS/MESSAGES</title>
<para>None.
</para>
</refsect1>

<refsect1>
<title>ERRORS/WARNINGS</title>
<para>None.</para>
</refsect1>

<refsect1>
<title>EXAMPLES</title>
<para>None.
</para>
</refsect1>

<refsect1>
<title>FILES</title>
<para>None.
</para>
</refsect1>

<refsect1>
<title>SEE ALSO</title>
<para><function>DtPrintSetupBox</function>(3),
<function>DtCreatePrintSetupDialog</function>(3)</para>
</refsect1>

</refentry>