group__dc__fns.htm

MINIGUI1.6开发API

          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="struct__RGB.htm">RGB</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>pal</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>
Creates a memory DC from a device independent MYBITMAP object. 
<p>
This function creates a memory DC which have the same pixel format as the MYBITMAP object <em>my_bmp</em>, and use the bits of the MYBITMAP object as the surface of the memory DC. The created memory DC will have the same geometry as the MYBITMAP object. If the depth of <em>my_bmp</em> is 8-bit, the function will use <em>pal</em> to initialize the palette of the memory DC.<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>my_bmp</em>&nbsp;</td><td>The device independent MYBITMAP object. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>pal</em>&nbsp;</td><td>The palette of the MYBITMAP object. If the depth of <em>my_bmp</em> is larger than 8-bit, this argument can be NULL. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The handle to the memory DC, HDC_INVALID indicates an error.</dd></dl>
<dl compact><dt><b>Note:</b></dt><dd>Only defined for _USE_NEWGAL.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__dc__fns.htm#ga14">CreateMemDCFromBitmap</a>, <a class="el" href="group__dc__fns.htm#ga19">DeleteMemDC</a>, <a class="el" href="group__gdi__fns.htm#ga2">MYBITMAP</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga5" doxytag="gdi.h::CreatePrivateClientDC"></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__handles.htm#ga2">HDC</a> GUIAPI CreatePrivateClientDC           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="group__handles.htm#ga1">HWND</a>&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>hwnd</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Creates a private client DC of a window. 
<p>
This function creates a private client DC of the window <em>hwnd</em> and returns the handle to the DC.<p>
When you calling <em>CreatePrivateClientDC</em> function to create a private client DC, MiniGUI will create the DC in the system heap, rather than allocate one from the DC pool. Thus, you can keep up the DC in the life cycle of the window, and are not needed to release it for using by other windows.<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>hwnd</em>&nbsp;</td><td>The handle to the window.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The handle to the DC, HDC_INVALID indicates an error.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__dc__fns.htm#ga7">DeletePrivateDC</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga4" doxytag="gdi.h::CreatePrivateDC"></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__handles.htm#ga2">HDC</a> GUIAPI CreatePrivateDC           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="group__handles.htm#ga1">HWND</a>&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>hwnd</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Creates a private window DC of a window. 
<p>
This function creates a private window DC of the window <em>hwnd</em> and returns the handle to the DC.<p>
When you calling <em>CreatePrivateDC</em> function to create a private DC, MiniGUI will create the DC in the system heap, rather than allocate one from the DC pool. Thus, you can keep up the private DC in the life cycle of the window, and are not needed to release it for using by other windows.<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>hwnd</em>&nbsp;</td><td>The handle to the window.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The handle to the DC, HDC_INVALID indicates an error.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__dc__fns.htm#ga7">DeletePrivateDC</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga13" doxytag="gdi.h::CreateSubMemDC"></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__handles.htm#ga2">HDC</a> GUIAPI CreateSubMemDC           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="group__handles.htm#ga2">HDC</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>parent</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>off_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>off_y</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>width</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>height</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="group__simple__types.htm#ga0">BOOL</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>comp_to_parent</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>
Creates a sub memory DC in the given memory DC. 
<p>
This function creates a sub memory DC in the given memory DC (the parent memory DC). Note that the new sub memdc will have the same DC attributes as the parent memdc.<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>parent</em>&nbsp;</td><td>The handle to the parent memory DC. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>off_x</em>&nbsp;</td><td>The x-coordinate of the sub memory DC in the parent DC (in device coordinate system). </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>off_y</em>&nbsp;</td><td>The y-coordinate of the sub memory DC in the parent DC (in device coordinate system). </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>width</em>&nbsp;</td><td>The expected width of the sub memory DC. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>height</em>&nbsp;</td><td>The expected height of the sub memory DC. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>comp_to_parent</em>&nbsp;</td><td>The flag indicates whether the sub memdc is compliant to the parent dc. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The handle to the memory DC; HDC_INVALID indicates an error.</dd></dl>
<dl compact><dt><b>Note:</b></dt><dd>Only defined for _USE_NEWGAL.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__dc__fns.htm#ga12">CreateMemDC</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga19" doxytag="gdi.h::DeleteMemDC"></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 GUIAPI DeleteMemDC           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="group__handles.htm#ga2">HDC</a>&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>mem_dc</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Deletes a memory DC. 
<p>
This function deletes the memory DC <em>mem_dc</em>, and frees the surface of the DC. For the memory DC created from BITMAP object or MYBITMAP object, the bits used by the surface of the DC will be reserved.<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>mem_dc</em>&nbsp;</td><td>The device context to be deleted.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Note:</b></dt><dd>Only defined for _USE_NEWGAL.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__dc__fns.htm#ga12">CreateMemDC</a>, <a class="el" href="group__dc__fns.htm#ga14">CreateMemDCFromBitmap</a>, <a class="el" href="group__dc__fns.htm#ga15">CreateMemDCFromMyBitmap</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga7" doxytag="gdi.h::DeletePrivateDC"></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 GUIAPI DeletePrivateDC           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="group__handles.htm#ga2">HDC</a>&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>hdc</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>