group__window__create__fns.htm

MINIGUI1.6开发API

        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="group__win32__types.htm#ga9">LPARAM</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>lParam</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>
The default window callback procedure. 
<p>
This window procedure can be used for main windows, dialog boxes, and child windows.<p>
This function is the default window callback procedure. You should call this function for all messages you do not want to handle in your window procedure.<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>
    <tr><td valign="top"></td><td valign="top"><em>message</em>&nbsp;</td><td>The message identifier. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>wParam</em>&nbsp;</td><td>The first parameter of the message. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>lParam</em>&nbsp;</td><td>The second parameter of the message. </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga10" doxytag="window.h::DestroyMainWindow"></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 DestroyMainWindow           </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>
Destroys a main window. 
<p>
This function destroys the main window specified by <em>hWnd</em>. It does not release all system resource used by the main window. You should call <em>MainWindowThreadCleanup</em> to destroy the main window actually.<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 main window. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>TRUE on success, FALSE on error.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__window__create__fns.htm#ga8">MainWindowThreadCleanup</a></dd></dl>
Example:<p>
<div class="fragment"><pre class="fragment"><span class="comment">/*</span>
<span class="comment"> * The following code destroies all resource used by the main window</span>
<span class="comment"> * and then destroies the main window itself.</span>
<span class="comment"> */</span>
                <span class="keywordflow">case</span> <a class="code" href="group__creation__msgs.htm#ga7">MSG_CLOSE</a>:
                    <span class="comment">/* Destroy the resource used by the main window. */</span>
                    <a class="code" href="group__font__fns.htm#ga16">DestroyLogFont</a> (logfont1);
                    <a class="code" href="group__font__fns.htm#ga16">DestroyLogFont</a> (logfont2);
                    <a class="code" href="group__font__fns.htm#ga16">DestroyLogFont</a> (logfont3);
                    
                    <span class="comment">/* Destroy the child windows. */</span>
                    <a class="code" href="group__control__fns.htm#ga2">DestroyWindow</a>(hWndButton);
                    <a class="code" href="group__control__fns.htm#ga2">DestroyWindow</a>(hWndEdit);

                    <span class="comment">/* Destroy the main window. */</span>
                    <a class="code" href="group__window__create__fns.htm#ga10">DestroyMainWindow</a> (hWnd);

                    <span class="comment">/* Send a MSG_QUIT message to quit the message loop. */</span>
                    <a class="code" href="group__msg__pass__fns.htm#ga15">PostQuitMessage</a>(hWnd);
                    <span class="keywordflow">return</span> 0;
</pre></div>     </td>
  </tr>
</table>
<a class="anchor" name="ga6" doxytag="window.h::GetMainWinThread"></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">pthread_t GUIAPI GetMainWinThread           </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>hMainWnd</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>
Get the thread id which main window belongs to. 
<p>
<dl compact><dt><b>Returns:</b></dt><dd>Thread id. </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga8" doxytag="window.h::MainWindowThreadCleanup"></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 MainWindowThreadCleanup           </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>hMainWnd</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>
Cleans up system resource associated with a main window. 
<p>
This function cleans up the system resource such as message queue associated with the main window <em>hMainWnd</em>. <em>DestroyMainWindow</em> does not destroy all resource used by a main window, therefore, you should call this function after calling <em>DestroyMainWindow</em> and skipping out from the message loop. After calling this function, the main window object will destroyed actually.<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>hMainWnd</em>&nbsp;</td><td>The handle to the main window.</td></tr>
  </table>
</dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__window__create__fns.htm#ga10">DestroyMainWindow</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga7" doxytag="window.h::WaitMainWindowClose"></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 WaitMainWindowClose           </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="mdname" nowrap> <em>hWnd</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>void **&nbsp;</td>
          <td class="mdname" nowrap> <em>returnval</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>
Suspends execution of the calling thread which main window belongs to until the target thread terminates, unless the target thread has already terminated. 
<p>
<dl compact><dt><b>Returns:</b></dt><dd>non-NULL value on success. </dd></dl>
    </td>
  </tr>
</table>
<hr><h2>Variable Documentation</h2>
<a class="anchor" name="ga4" doxytag="window.h::__mg_def_proc"></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__window__create__fns.htm#ga0">WNDPROC</a> <a class="el" href="group__window__create__fns.htm#ga4">__mg_def_proc</a>          </td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
The default window callback procedure array. 
<p>
    </td>
  </tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Thu Nov 22 15:35:55 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>