group__msg__pass__fns.htm

MINIGUI1.6开发API

<p>
Sends a notification message to a window. 
<p>
This function sends the notification message specified by (<em>iMsg</em>, <em>wParam</em>, <em>lParam</em>) to the window <em>hWnd</em>. This function puts the notication message in the message queue and then 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 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>
<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#ga9">SendMessage</a>, <a class="el" href="group__msg__pass__fns.htm#ga8">PostMessage</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga10" doxytag="window.h::SetAutoRepeatMessage"></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 SetAutoRepeatMessage           </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>msg</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>
Sets the auto-repeat message. 
<p>
This function sets the auto-repeat message. When the default message procedure receives an MSG_IDLE message, the default handler will send the auto-repeat message to the target window as a notification 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>hwnd</em>&nbsp;</td><td>The handle to the target window. Set it to zero to disable the auto-repeat message. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>msg</em>&nbsp;</td><td>The identifier of the auto-repeat message. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>wParam</em>&nbsp;</td><td>The first parameter of the auto-repeat message. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>lParam</em>&nbsp;</td><td>The second parameter of the auto-repeat message. </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga16" doxytag="window.h::SetKeyboardLayout"></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> SetKeyboardLayout           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">const char *&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>kbd_layout</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>
Sets a new keyboard layout. 
<p>
This function sets the keymaps to translate key scancodes to MSG_CHAR or MSG_KEYSYM messages. The default keymaps is for US PC keyboard layout, you can call this function to set a different keyboard layout. The argument of <em>kbd_layout</em> specifies the name of the keyboard layout.<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>kbd_layout</em>&nbsp;</td><td>The keyboard layout name. It can be one of the following values:</td></tr>
  </table>
</dl>
<ul>
<li>KBD_LAYOUT_DEFAULT<br>
 The default keyboard layout, i.e., US PC.</li><li>KBD_LAYOUT_FRPC<br>
 The France PC keyboard layout.</li><li>KBD_LAYOUT_FR<br>
 The France keyboard layout.</li><li>KBD_LAYOUT_DE<br>
 The German keyboard layout.</li><li>KBD_LAYOUT_DELATIN1<br>
 The German Latin1 keyboard layout.</li><li>KBD_LAYOUT_IT<br>
 The Italian keyboard layout.</li><li>KBD_LAYOUT_ES<br>
 The Spanish keyboard layout.</li><li>KBD_LAYOUT_ESCP850<br>
 The Spanish CP850 keyboard layout.</li></ul>
<p>
<dl compact><dt><b>Returns:</b></dt><dd>TRUE for success, otherwise FALSE.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__msg__pass__fns.htm#ga17">TranslateMessage</a>, <a class="el" href="group__key__msgs.htm#ga5">MSG_CHAR</a>, <a class="el" href="group__key__msgs.htm#ga10">MSG_KEYSYM</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga20" doxytag="window.h::ThrowAwayMessages"></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 ThrowAwayMessages           </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>pMainWnd</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>
Removes all messages in the message queue associated with a window. 
<p>
This function removes all messages which are associated with the specified window <em>pMainWnd</em>.<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>pMainWnd</em>&nbsp;</td><td>The handle to the window. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of thrown messages.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd>EmptyMessageQueue </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga18" doxytag="window.h::TranslateKeyMsgToChar"></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 TranslateKeyMsgToChar           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">int&nbsp;</td>
          <td class="mdname" nowrap> <em>message</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" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="group__win32__types.htm#ga2">WORD</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>ch</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>
Translates a key down and key up message to a corresponding character. 
<p>
This function translates a key down and key up message to a character. If the message is not a key message, this function does nothing.<p>
The behavior of this function is inflected by the current keyboard layout. The default keyboard layout is US PC keyboard, but you can call <em>SetKeyboardLayout</em> function to set a different keyboard layout.<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>message</em>&nbsp;</td><td>The type of message. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>wParam</em>&nbsp;</td><td>Message parameter. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>lParam</em>&nbsp;</td><td>Message parameter. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ch</em>&nbsp;</td><td>A string buffer for storing translated characters.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>A boolean indicates whether the message is a key message.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__msg__pass__fns.htm#ga17">TranslateMessage</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga17" doxytag="window.h::TranslateMessage"></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> TranslateMessage           </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="mdname1" valign="top" nowrap> <em>pMsg</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>
Translates key down and key up messages to MSG_CHAR message and post it into the message queue. 
<p>
This function translates key down and key up message to an MSG_CHAR message or some MSG_KEYSYM messages, and send the message(s) to the window procedure as a notification message. If the message is not a key message, this function does nothing.<p>
The behavior of this function is inflected by the current keyboard layout. The default keyboard layout is US PC keyboard, but you can call <em>SetKeyboardLayout</em> function to set a different keyboard layout.<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>The pointer of m