group__rect__fns.htm

MINIGUI1.6开发API

        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>x</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>y</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"><code> [inline, static]</code></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Moves a rectangle by offsets. 
<p>
This function moves the specified rectangle by the specified offsets. <em>x</em> and <em>y</em> specify the amount to move the rectangle left/right or up/down respectively. <em>x</em> must be a negative value to move the rectangle to the left, and <em>y</em> must be a negative value to move the rectangle up.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>prc</em>&nbsp;</td><td>The pointer to the rectangle. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>x</em>&nbsp;</td><td>The x offset. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>y</em>&nbsp;</td><td>The y offset.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Note:</b></dt><dd>Defined as an inline function for _USE_NEWGAL.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__rect__fns.htm#ga4">InflateRect</a> </dd></dl>

<p>
Definition at line <a class="el" href="gdi_8h-source.htm#l04928">4928</a> of file <a class="el" href="gdi_8h-source.htm">gdi.h</a>.    </td>
  </tr>
</table>
<a class="anchor" name="ga6" doxytag="gdi.h::PtInRect"></a><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"><a class="el" href="group__simple__types.htm#ga0">BOOL</a> PtInRect           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">const <a class="el" href="struct__RECT.htm">RECT</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>prc</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>x</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>y</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"><code> [inline, static]</code></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Determines whether a point lies within an rectangle. 
<p>
This function determines whether the specified point <em></em>(x,y) lies within the specified rectangle <em>prc</em>.<p>
A point is within a rectangle if it lies on the left or top side or is within all four sides. A point on the right or bottom side is considered outside the rectangle.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>prc</em>&nbsp;</td><td>The pointer to the rectangle. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>x</em>&nbsp;</td><td>x,y: The point. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>y</em>&nbsp;</td><td>x,y: The point.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Note:</b></dt><dd>Defined as an inline function for _USE_NEWGAL. </dd></dl>

<p>
Definition at line <a class="el" href="gdi_8h-source.htm#l04997">4997</a> of file <a class="el" href="gdi_8h-source.htm">gdi.h</a>.
<p>
References <a class="el" href="common_8h-source.htm#l00255">FALSE</a>, and <a class="el" href="common_8h-source.htm#l00262">TRUE</a>.    </td>
  </tr>
</table>
<a class="anchor" name="ga0" doxytag="gdi.h::SetRect"></a><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">void SetRect           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="struct__RECT.htm">RECT</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>prc</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>left</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>top</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>right</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>bottom</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"><code> [inline, static]</code></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Sets a rectangle. 
<p>
This function sets the rectangle with specified values.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>prc</em>&nbsp;</td><td>The pointer to the rectangle. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>left</em>&nbsp;</td><td>The x coordinate of the upper-left corner of the rectangle. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>top</em>&nbsp;</td><td>The y coordinate of the upper-left corner of the rectangle. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>right</em>&nbsp;</td><td>The x coordinate of the lower-right corner of the rectangle. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>bottom</em>&nbsp;</td><td>The y coordinate of the lower-right corner of the rectangle.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Note:</b></dt><dd>Defined as an inline function for _USE_NEWGAL.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__rect__fns.htm#ga1">SetRectEmpty</a> </dd></dl>

<p>
Definition at line <a class="el" href="gdi_8h-source.htm#l04865">4865</a> of file <a class="el" href="gdi_8h-source.htm">gdi.h</a>.    </td>
  </tr>
</table>
<a class="anchor" name="ga1" doxytag="gdi.h::SetRectEmpty"></a><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">void SetRectEmpty           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="struct__RECT.htm">RECT</a> *&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>prc</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap><code> [inline, static]</code></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Empties a rectangle. 
<p>
This function empties the rectangle pointed to by <em>prc</em>. An empty rectangle in MiniGUI is a rectangle whose width and height both are zero. This function will sets all coordinates of the rectangle to be zero.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>prc</em>&nbsp;</td><td>The pointer to the rectangle.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Note:</b></dt><dd>Defined as an inline function for _USE_NEWGAL.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__rect__fns.htm#ga0">SetRect</a> </dd></dl>

<p>
Definition at line <a class="el" href="gdi_8h-source.htm#l04886">4886</a> of file <a class="el" href="gdi_8h-source.htm">gdi.h</a>.    </td>
  </tr>
</table>
<a class="anchor" name="ga15" doxytag="gdi.h::SubtractRect"></a><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">int GUIAPI SubtractRect           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="struct__RECT.htm">RECT</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>rc</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const <a class="el" href="struct__RECT.htm">RECT</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>psrc1</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const <a class="el" href="struct__RECT.htm">RECT</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>psrc2</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Obtains the rectangles when substracting one rectangle from another. 
<p>
This function obtains the rectangles substracting the rectangle <em>psrc1</em> from the other <em>psrc2</em>. <em>rc</em> should be an array of RECT struct, and may contain at most four rectangles. This function returns the number of result rectangles.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>rc</em>&nbsp;</td><td>The pointer to the resule rectangle array. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>psrc1</em>&nbsp;</td><td>The pointer to the minuend rectangle. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>psrc2</em>&nbsp;</td><td>The pointer to the subtrahend rectangle. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of result rectangles.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__rect__fns.htm#ga13">UnionRect</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga13" doxytag="gdi.h::UnionRect"></a><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"><a class="el" href="group__simple__types.htm#ga0">BOOL</a> GUIAPI UnionRect           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="struct__RECT.htm">RECT</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>pdrc</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const <a class="el" href="struct__RECT.htm">RECT</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>psrc1</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const <a class="el" href="struct__RECT.htm">RECT</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>psrc2</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Unions two source rectangles. 
<p>
This function creates the union (<em>pdrc</em>) of two rectangles (<em>psrc1</em> and <em>psrc2</em>), if the source rectangles are border upon and not stagger.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>pdrc</em>&nbsp;</td><td>The unioned rectangle. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>psrc1</em>&nbsp;</td><td>The first source rectangles. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>psrc2</em>&nbsp;</td><td>The second source rectangles.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>TRUE if the source rectangles are border upon and not stagger, otherwise FALSE.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__rect__fns.htm#ga14">GetBoundRect</a> </dd></dl>
    </td>
  </tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Thu Nov 22 15:35:54 2007 for MiniGUI V1.6.10 API Reference by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="http://www.minigui.com/api_ref/1.6.10/doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.2 </small></address>
</body>
</html>