group__msg__pass__fns.htm

MINIGUI1.6开发API

        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="group__win32__types.htm#ga6">UINT</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>uRemoveMsg</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>
Peeks a message from the message queue of a main window. 
<p>
This functions peek a message from the message queue of the window <em>hWnd</em>; if <em>bWait</em> is TRUE, it will wait for the message, else return immediatly.<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>pMsg</em>&nbsp;</td><td>Pointer to the result message. </td></tr>
    <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>iMsgFilterMin</em>&nbsp;</td><td>The min identifier of the message that should be peeked. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>iMsgFilterMax</em>&nbsp;</td><td>The max identifier of the message that should be peeked. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>bWait</em>&nbsp;</td><td>Whether to wait for a message. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>uRemoveMsg</em>&nbsp;</td><td>Whether remove the message from the message queue. Should be the following values:<ul>
<li>PM_NOREMOVE<br>
 Leave it in the message queue.</li><li>PM_REMOVE Remove it from the message queue.</li><li>PM_NOYIELD Nouse now.</li></ul>
</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>TRUE if there is a message peeked, or FALSE.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__msg__pass__fns.htm#ga3">GetMessage</a>, <a class="el" href="group__msg__pass__fns.htm#ga7">PeekPostMessage</a>, <a class="el" href="group__msg__pass__fns.htm#ga5">HavePendingMessage</a>, <a class="el" href="group__msg__pass__fns.htm#ga8">PostMessage</a> </dd></dl>

<p>
Referenced by <a class="el" href="window_8h-source.htm#l01933">GetMessage()</a>, and <a class="el" href="window_8h-source.htm#l01998">PeekMessage()</a>.    </td>
  </tr>
</table>
<a class="anchor" name="ga7" doxytag="window.h::PeekPostMessage"></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> PeekPostMessage           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="struct__MSG.htm">PMSG</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>pMsg</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><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>int&nbsp;</td>
          <td class="mdname" nowrap> <em>iMsgFilterMin</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>iMsgFilterMax</em>, </td>
        </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#ga6">UINT</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>uRemoveMsg</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>
Peeks a post message from the message queue of a main window. 
<p>
This functions peek a message from the message queue of the window <em>hWnd</em> and returns immediatly. Unlike <em>PeekMessage</em>, this function only peek a post message.<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>pMsg</em>&nbsp;</td><td>Pointer to the result message. </td></tr>
    <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>iMsgFilterMin</em>&nbsp;</td><td>The min identifier of the message that should be peeked. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>iMsgFilterMax</em>&nbsp;</td><td>The max identifier of the message that should be peeked. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>uRemoveMsg</em>&nbsp;</td><td>Whether remove the message from the message queue. Should be the following values:<ul>
<li>PM_NOREMOVE<br>
 Leave it in the message queue.</li><li>PM_REMOVE Remove it from the message queue.</li><li>PM_NOYIELD Nouse now.</li></ul>
</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>TRUE if there is a message peeked, or FALSE.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__msg__pass__fns.htm#ga3">GetMessage</a>, <a class="el" href="group__msg__pass__fns.htm#ga6">PeekMessage</a>, <a class="el" href="group__msg__pass__fns.htm#ga5">HavePendingMessage</a>, <a class="el" href="group__msg__pass__fns.htm#ga8">PostMessage</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga8" doxytag="window.h::PostMessage"></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 PostMessage           </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>int&nbsp;</td>
          <td class="mdname" nowrap> <em>iMsg</em>, </td>
        </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#ga8">WPARAM</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>wParam</em>, </td>
        </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>
Posts a message into the message queue of a window and returns immediatly. 
<p>
This functions posts a message into the message queue of the window <em>hWnd</em> and returns immediately.<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>iMsg</em>&nbsp;</td><td>The identifier of the message. </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>
<dl compact><dt><b>Returns:</b></dt><dd>ERR_OK on success, &lt; 0 on errors.</dd></dl>
<dl compact><dt><b>Return values:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>ERR_OK</em>&nbsp;</td><td>Post message successfully. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ERR_QUEUE_FULL</em>&nbsp;</td><td>The message queue is full. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ERR_INV_HWND</em>&nbsp;</td><td>Invalid window handle.</td></tr>
  </table>
</dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__msg__pass__fns.htm#ga9">SendMessage</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga15" doxytag="window.h::PostQuitMessage"></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 PostQuitMessage           </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>
Puts a MSG_QUIT message into the message queue of a main window. 
<p>
This function puts a MSG_QUIT message into the message queue of the main window <em>hWnd</em>. The next call to <em>GetMessage</em> will return 0.<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>0 if all OK, &lt; 0 on error.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__msg__pass__fns.htm#ga3">GetMessage</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga11" doxytag="window.h::PostSyncMessage"></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 PostSyncMessage           </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>int&nbsp;</td>
          <td class="mdname" nowrap> <em>iMsg</em>, </td>
        </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#ga8">WPARAM</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>wParam</em>, </td>
        </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>