WindowsXP/windows/advcore/duser/docs/api/getgadgetrect.htm
2025-04-27 07:49:33 -04:00

102 lines
5.7 KiB
HTML
Raw Blame History

<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">GetGadgetRect<!--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>GetGadgetRect</b> is a flexible mechanism of retreiving the Gadget's logical rectangle or actual bounding box.</p>
</dl>
<!--mstheme--></font><pre>BOOL <b>GetGadgetRect</b>(
<b>HGADGET</b> hgad, // Handle of Gadget
<b>RECT</b> * prcPxl, // Rectangle in specified pixels
<b>UINT</b> nFlags // Rectangle to retrieve
);</pre><!--mstheme--><font face="arial, arial, helvetica">
<h4><!--mstheme--><font face="verdana, arial, helvetica" color="#006666">Parameters<!--mstheme--></font></h4>
<dl>
<dt><i>hgad</i></dt>
<dd>[in] Handle of Gadget
</dd>
<dt><i>prcPxl</i></dt>
<dd>[out] Rectangle in specified pixels
</dd>
<dt><i>nFlags</i></dt>
<dd>[in] Rectangle to retrieve<br>
<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>Meaning</b><!--mstheme--></font></td>
</tr>
<tr>
<td width="33%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">SGR_CLIENT<!--mstheme--></font></td>
<td width="66%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">Coordinates are relative to the Gadget itself.<!--mstheme--></font></td>
</tr>
<tr>
<td width="33%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">SGR_PARENT<!--mstheme--></font></td>
<td width="66%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">Coordinates are relative to the Gadget's parent.<!--mstheme--></font></td>
</tr>
<tr>
<td width="33%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">SGR_CONTAINER<!--mstheme--></font></td>
<td width="66%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">Coordinates are relative to the Gadget's root container.<!--mstheme--></font></td>
</tr>
<tr>
<td width="33%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">SGR_DESKTOP<!--mstheme--></font></td>
<td width="66%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">Coordinates are relative to the Windows desktop.<!--mstheme--></font></td>
</tr>
<tr>
<td width="33%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">SGR_ACTUAL<!--mstheme--></font></td>
<td width="66%" valign="top"><!--mstheme--><font face="arial, arial, helvetica">Return the bounding rectangle of the Gadget. If this flag is specified, a bounding box is computed from all transformations applied from the root to the Gadget itself. If this flag is not specified, the rectangle returned will be in logical coordinates.<!--mstheme--></font></td>
</tr>
</table><!--mstheme--><font face="arial, arial, helvetica">
</dd>
</dl>
<h4><!--mstheme--><font face="verdana, arial, helvetica" color="#006666"><br>
Return Values<!--mstheme--></font></h4>
<p>Rectangle was successfully retreived.</p>
<h4><!--mstheme--><font face="verdana, arial, helvetica" color="#006666">See Also<!--mstheme--></font></h4>
<p><b><a href="GetGadgetRotation.htm">GetGadgetRotation</a></b>, <a href="GetGadgetScale.htm"><b>GetGadgetScale</b></a>,
<b><a href="SetGadgetRect.htm">SetGadgetRect</a></b>, <b><a href="SetGadgetRotation.htm">SetGadgetRotation</a></b>,
<b><a href="SetGadgetScale.htm">SetGadgetScale</a></b><!--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">&nbsp;
<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 Friday, March 17, 2000
<br>
Copyright <20> 2000 by Microsoft Corporation.&nbsp; All rights reserved<br>
<a href="mailto:jstall">Send feedback </a>to Jeff Stall
<!--mstheme--></font></td></tr><!--msnavigation--></table></body>
</html>