group__mywins__helpers.htm

MINIGUI1.6开发API

          <td class="md" nowrap>int *&nbsp;</td>
          <td class="mdname" nowrap> <em>listItem</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="struct__myWinButton.htm">myWINBUTTON</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>buttons</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 menu main window for the user to select an item. 
<p>
This function creates a menu main window including a few buttons, and a list box with checkable item.<p>
When the user click one of the buttons, this function will return the identifier of the button which leads to close the menu window, and the selections of the items via <em>listItem</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>hParentWnd</em>&nbsp;</td><td>The hosting main window. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>title</em>&nbsp;</td><td>The title of the menu main window. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>label</em>&nbsp;</td><td>The label of the list box. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>width</em>&nbsp;</td><td>The width of the menu main window. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>listboxheight</em>&nbsp;</td><td>The height of the list box. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>items</em>&nbsp;</td><td>The pointer to the array of the item strings. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>listItem</em>&nbsp;</td><td>The pointer to the array of the check status of the items, initial and returned. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>buttons</em>&nbsp;</td><td>The buttons will be created.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>Returns the identifier of the button leading to close the menu window on success, else on errors.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__mywins__helpers.htm#ga0">myWINBUTTON</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga5" doxytag="mywindows.h::myWinMessage"></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 myWinMessage           </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>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>title</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>button1</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>text</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>&nbsp;</td>
          <td class="mdname" nowrap> <em>...</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 message box within only one button. 
<p>
This function creates a message box hosted to the main window <em>hwnd</em>, displays a message and an application icon in the message box, and creates a button which can be used to close the box. This function also receives <em>printf-like</em> arguments to format a string.<p>
This function can be used to display a information for the user.<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 hosting main window. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>title</em>&nbsp;</td><td>The title of the message box. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>button1</em>&nbsp;</td><td>The text in the button. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>text</em>&nbsp;</td><td>The format string.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>0 indicates the message box was closed by clicking the only button.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__mywins__helpers.htm#ga6">myWinChoice</a>, printf(3) </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga7" doxytag="mywindows.h::myWinTernary"></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 myWinTernary           </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>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>title</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>button1</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>button2</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>button3</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>text</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>&nbsp;</td>
          <td class="mdname" nowrap> <em>...</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 message box within three buttons. 
<p>
This function creates a message box hosted to the main window <em>hwnd</em>, displays a message and an application icon in the message box, and creates three buttons in it. This function also receives <em>printf-like</em> arguments to format a string.<p>
This function can be used to prompt the user to choose one item among three choices.<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 hosting main window. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>title</em>&nbsp;</td><td>The title of the message box. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>button1</em>&nbsp;</td><td>The title of the first button. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>button2</em>&nbsp;</td><td>The title of the second button. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>button3</em>&nbsp;</td><td>The title of the third button. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>text</em>&nbsp;</td><td>The format string.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>0, 1, or 2, indicates the message box was closed by the first, the second, or the third button.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__mywins__helpers.htm#ga6">myWinChoice</a>, printf(3) </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga12" doxytag="mywindows.h::resetToolTipWin"></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 resetToolTipWin           </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>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" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>text</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>&nbsp;</td>
          <td class="mdname" nowrap> <em>...</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>
Resets a tool tip window. 
<p>
This function resets the tool tip window specified by <em>hwnd</em>, including its position, text displayed in it, and the visible status. If the tool tip is invisible, it will become visible.<p>
This function also receives <em>printf-like</em> arguments to format a string.<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 tool tip window handle returned by <em>createToolTipWin</em>. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>x</em>&nbsp;</td><td>The new position of the tool tip window. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>y</em>&nbsp;</td><td>The new position of the tool tip window. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>text</em>&nbsp;</td><td>The new format string.</td></tr>
  </table>
</dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__mywins__helpers.htm#ga11">createToolTipWin</a>, <a class="el" href="group__mywins__helpers.htm#ga13">destroyToolTipWin</a> </dd></dl>
    </td>
  </tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Thu Nov 22 15:35:56 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>