126 lines
7.7 KiB
HTML
126 lines
7.7 KiB
HTML
<html>
|
||
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
||
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
|
||
<meta name="ProgId" content="FrontPage.Editor.Document">
|
||
|
||
<link rel="stylesheet" type="text/css" href="api.css">
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<title></title>
|
||
|
||
|
||
|
||
|
||
|
||
<meta name="Microsoft Theme" content="glacier 111, default"><meta name="Microsoft Border" content="tb, default"></head>
|
||
|
||
<body leftmargin="44" background="../_themes/glacier/glabkgnd.jpg" bgcolor="#CCFFFF" text="#000000" link="#339999" vlink="#999999" alink="#406666"><!--msnavigation--><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td><!--mstheme--><font face="arial, arial, helvetica">
|
||
|
||
|
||
|
||
<!--mstheme--></font></td></tr><!--msnavigation--></table><!--msnavigation--><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr><!--msnavigation--><td valign="top"><!--mstheme--><font face="arial, arial, helvetica"><!--mstheme--></font><table border="0" width="700" cellspacing="0" cellpadding="0">
|
||
<tr>
|
||
<td width="5%" valign="middle"><!--mstheme--><font face="arial, arial, helvetica"><img border="0" src="../images/Core.gif" width="32" height="32"><!--mstheme--></font></td>
|
||
<td width="95%" valign="middle"><!--mstheme--><font face="arial, arial, helvetica">
|
||
<h1><!--mstheme--><font face="verdana, arial, helvetica" color="#006666">CreateGadget<!--mstheme--></font></h1>
|
||
<h2><!--mstheme--><font face="verdana, arial, helvetica" color="#006666">Core<!--mstheme--></font></h2>
|
||
<!--mstheme--></font></td>
|
||
</tr>
|
||
</table><!--mstheme--><font face="arial, arial, helvetica">
|
||
<dl>
|
||
<p><b>CreateGadget</b> creates a new Gadget of a given type. Depending on the specific flags, different Gadgets will actually be instantiated.
|
||
Once a Gadget of a specific type has been created, it can not be changed into a different type without being deleted and recreated.</p>
|
||
</dl>
|
||
<!--mstheme--></font><pre>HGADGET
|
||
<b>CreateGadget</b>(
|
||
<b>HANDLE</b> hParent, // Handle to parent
|
||
<b>UINT</b> nFlags, // Creation flags
|
||
<b>GADGETPROCEX</b> pfnProc, // Pointer to the Gadget procedure
|
||
<b>void </b>* pvGadgetData) // User data associated with this Gadget
|
||
);</pre><!--mstheme--><font face="arial, arial, helvetica">
|
||
<h4><!--mstheme--><font face="verdana, arial, helvetica" color="#006666">Parameters<!--mstheme--></font></h4>
|
||
<dl>
|
||
<dt><i>hParent</i></dt>
|
||
<dd>[in] Handle to parent</dd>
|
||
</dl>
|
||
<dl>
|
||
<dt><i>nFlags</i>
|
||
<dd>[in] Specifies both what type of Gadget to created and any creation-time properties of that Gadget<br>
|
||
<!--mstheme--></font><table border="2" width="700" cellspacing="0" cellpadding="5" bordercolordark="#006666" bordercolorlight="#99CCCC">
|
||
<tr>
|
||
<td width="33%" bgcolor="#C0C0C0" valign="top"><!--mstheme--><font face="arial, arial, helvetica"><b>Value</b><!--mstheme--></font></td>
|
||
<td width="66%" bgcolor="#C0C0C0" valign="top"><!--mstheme--><font face="arial, arial, helvetica"><b>Action</b><!--mstheme--></font></td>
|
||
</tr>
|
||
<tr>
|
||
<td width="33%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">GC_HWNDHOST<!--mstheme--></font></td>
|
||
<td width="66%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">Creates a top-level Gadget that can host a GadgetTree inside the client area of a given HWND. hParent must be a valid HWND.<!--mstheme--></font></td>
|
||
</tr>
|
||
<tr>
|
||
<td width="33%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">GC_NCHOST<!--mstheme--></font></td>
|
||
<td width="66%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">Creates a top-level Gadget that can host a GadgetTree inside the non-client area of a given HWND. hParent must be a valid HWND.<!--mstheme--></font></td>
|
||
</tr>
|
||
<tr>
|
||
<td width="33%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">GC_DXHOST<!--mstheme--></font></td>
|
||
<td width="66%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">Creates a top-level Gadget that can host a GadgetTree inside a DXSurface. hParent must be an LPCRECT specifying the area of the surface the tree will be displayed on.<!--mstheme--></font></td>
|
||
</tr>
|
||
<tr>
|
||
<td width="33%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">GC_COMPLEX<!--mstheme--></font></td>
|
||
<td width="66%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">Creates a sub-level Gadget that is optimized for a complex subtree below it containing many other Gadgets. More expensive than a Simple Gadget, Complex Gadgets provide optimized region management and are more equivalent to HWND's in both functionality and design. hParent must specify a valid HGADGET.<!--mstheme--></font></td>
|
||
</tr>
|
||
<tr>
|
||
<td width="33%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">GC_SIMPLE<!--mstheme--></font></td>
|
||
<td width="66%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">Creates a sub-level Gadget that is optimized for a simple subtree below it containing a few Gadgets. Simple Gadgets are cheaper to create and often use than Complex Gadgets if optimized region management is not needed. hParent must specify a valid HGADGET.<!--mstheme--></font></td>
|
||
</tr>
|
||
<tr>
|
||
<td width="33%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">GC_DETACHED<!--mstheme--></font></td>
|
||
<td width="66%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">Creates a Gadget not integrated into a given Gadget tree. Since they are separated from a tree, operations must be explicitely forwarded to Detached Gadgets during processing. hParent is ignored.<!--mstheme--></font></td>
|
||
</tr>
|
||
<tr>
|
||
<td width="33%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">GC_MESSAGE<!--mstheme--></font></td>
|
||
<td width="66%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">Creates a message-only Gadget that can receive and send messages, but does not articipate in any visual or interactive manner. hParent is ignored.<!--mstheme--></font></td>
|
||
</tr>
|
||
<tr>
|
||
<td width="33%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">GC_MANUALDRAW<!--mstheme--></font></td>
|
||
<td width="66%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">Specifies that this top-level Gadget will be explicitely told when to draw. This flag can only be used with the GC_HWNDHOST, GC_NCHOST, and GC_DXHOST styles.<!--mstheme--></font></td>
|
||
</tr>
|
||
</table><!--mstheme--><font face="arial, arial, helvetica">
|
||
</dd>
|
||
</dl>
|
||
<dl>
|
||
<dt><i>pfnProc</i></dt>
|
||
<dd>[in] Pointer to the Gadget procedure</dd>
|
||
</dl>
|
||
<dl>
|
||
<dt><i>pvGadgetData</i></dt>
|
||
<dd>[in] User data associated with this Gadget</dd>
|
||
</dl>
|
||
<h4><!--mstheme--><font face="verdana, arial, helvetica" color="#006666">
|
||
Return Values<!--mstheme--></font></h4>
|
||
<dl>
|
||
<p>Components were successfully uninitialized.</p>
|
||
</dl>
|
||
<h4><!--mstheme--><font face="verdana, arial, helvetica" color="#006666">See Also<!--mstheme--></font></h4>
|
||
<dl>
|
||
<p> <b>CreateTransition</b>, <b><a href="InitGadgetComponent.htm">InitGadgetComponent</a></b>
|
||
</dl>
|
||
<!--mstheme--></font><!--msnavigation--></td></tr><!--msnavigation--></table><!--msnavigation--><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td><!--mstheme--><font face="arial, arial, helvetica">
|
||
|
||
<p align="center">
|
||
|
||
<p align="center" style="border-top-style: solid; border-top-width: 2"><b><font color="#FF0000" size="3"><br>
|
||
Internal Only</font></b><p align="center">Build on Thursday, March 16, 2000
|
||
<br>
|
||
Copyright <20> 2000 by Microsoft Corporation. All rights reserved<br>
|
||
<a href="mailto:jstall">Send feedback </a>to Jeff Stall
|
||
|
||
<!--mstheme--></font></td></tr><!--msnavigation--></table></body>
|
||
</html>
|