group__dialog__fns.htm

MINIGUI1.6开发API

<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 EndDialog           </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>hDlg</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>endCode</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>
Destroys a modal dialog box, causing MiniGUI to end any processing for the dialog box. 
<p>
This function destroys the modal dialog box <em>hDlg</em> created by <em>DialogBoxIndirectParam</em> and ends any processing for the dialog box. The argument <em>endCode</em> will be returned by <em>DialogBoxIndirectParam</em> as the return value.<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>hDlg</em>&nbsp;</td><td>The handle to the dialog box. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>endCode</em>&nbsp;</td><td>The value will be returned by <em>DialogBoxIndirectParam</em>.</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__dialog__fns.htm#ga6">DialogBoxIndirectParam</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga10" doxytag="window.h::GetDlgCtrlID"></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 GetDlgCtrlID           </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>hwndCtl</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>
Gets the integer identifier of a control. 
<p>
This function gets the integer identifier of the control <em>hwndCtl</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>hwndCtl</em>&nbsp;</td><td>The handle to the control.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The identifier of the control, -1 for error.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__dialog__fns.htm#ga11">GetDlgItem</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga9" doxytag="window.h::GetDlgDefPushButton"></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#ga1">HWND</a> GUIAPI GetDlgDefPushButton           </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>
Gets the default push button control in a window. 
<p>
This function gets the handle to the default push button (with BS_DEFPUSHBUTTON style) in the specified window <em>hWnd</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>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 default push button, zero for non default push button in the window. </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga11" doxytag="window.h::GetDlgItem"></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#ga1">HWND</a> GUIAPI GetDlgItem           </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>hDlg</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>nIDDlgItem</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>
Retrives the handle to a control in a dialog box. 
<p>
This function retrives the handle to a control, whose identifier is <em>nIDDlgItem</em>, in the specified dialog box <em>hDlg</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>hDlg</em>&nbsp;</td><td>The handle to the dialog box. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>nIDDlgItem</em>&nbsp;</td><td>The identifier of the control.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The handle to the control, zero for not found. </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga12" doxytag="window.h::GetDlgItemInt"></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__win32__types.htm#ga6">UINT</a> GUIAPI GetDlgItemInt           </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>hDlg</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>nIDDlgItem</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>lpTranslated</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>bSigned</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 the text of a control in a dialog box into an integer value. 
<p>
This function translates the text of the control, whose identifier is <em>nIDDlgItem</em> in the dialog box <em>hDlg</em> into an integer value.<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>hDlg</em>&nbsp;</td><td>The handle to the dialog box. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>nIDDlgItem</em>&nbsp;</td><td>The identifier of the control. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>lpTranslated</em>&nbsp;</td><td>The pointer to a boolean value, which indicates whether translated successfully. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>bSigned</em>&nbsp;</td><td>Indicates whether handle the text as a signed integer.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The translated 32-bit integer.</dd></dl>
<dl compact><dt><b>Note:</b></dt><dd>MiniGUI uses <em>strtol</em> or <em>strtoul</em> to convert the string value to a 32-bit integer, and pass the base as 0. Thus, the valid string value should be in the following forms:</dd></dl>
<ul>
<li>[+|-]0x[0-9|A-F]*<br>
 Will be read in base 16.</li><li>[+|-]0[0-7]*<br>
 Will be read in base 8.</li><li>[+|-][1-9][0-9]*<br>
 Will be read in base 10.</li></ul>
<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__dialog__fns.htm#ga13">GetDlgItemText</a>, <a class="el" href="group__dialog__fns.htm#ga18">SetDlgItemInt</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga13" doxytag="window.h::GetDlgItemText"></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 GetDlgItemText           </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>hDlg</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>nIDDlgItem</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>char *&nbsp;</td>
          <td class="mdname" nowrap> <em>lpString</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>nMaxCount</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>
Retrieves the title or text associated with a control in a dialog box. 
<p>
This function retrives the title or text associated with a control, whose identifier is <em>nIDDlgItem</em> in the dialog box <em>hDlg</em>.<p>