group__dialog__fns.htm

MINIGUI1.6开发API

<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>lpString</em>&nbsp;</td><td>The pointer to a buffer which receives the text. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>nMaxCount</em>&nbsp;</td><td>The maximal length of the string, not including the null character.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The length of the null-terminated text.</dd></dl>
<dl compact><dt><b>Note:</b></dt><dd>The buffer should at least have size of (<em>nMaxCount</em> + 1).</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__dialog__fns.htm#ga12">GetDlgItemInt</a>, <a class="el" href="group__dialog__fns.htm#ga14">GetDlgItemText2</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga14" doxytag="window.h::GetDlgItemText2"></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">char *GUIAPI GetDlgItemText2           </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>id</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>lenPtr</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 is similiar as <em>GetDlgItemText</em> function, but it allocates memory for the text and returns the pointer to the allocated buffer. You should free the buffer when done by using <em>free</em> function.<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>id</em>&nbsp;</td><td>The identifier of the control. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>lenPtr</em>&nbsp;</td><td>The pointer to an integer which receives the length of the text if it is not NULL.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The pointer to the allocated buffer.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__dialog__fns.htm#ga13">GetDlgItemText</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga15" doxytag="window.h::GetNextDlgGroupItem"></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 GetNextDlgGroupItem           </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><a class="el" href="group__handles.htm#ga1">HWND</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>hCtl</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>bPrevious</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 handle to the first control in a group of controls that precedes (or follows) the specified control in a dialog box. 
<p>
This function retrieves the handle to the first control in a group of controls that precedes (or follows) the specified control <em>hCtl</em> in the 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>hCtl</em>&nbsp;</td><td>The handle to the control. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>bPrevious</em>&nbsp;</td><td>A boolean value indicates to retrive the preceding or following control. TRUE for preceding control.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The handle to the preceding or following control.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__dialog__fns.htm#ga16">GetNextDlgTabItem</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga16" doxytag="window.h::GetNextDlgTabItem"></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 GetNextDlgTabItem           </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><a class="el" href="group__handles.htm#ga1">HWND</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>hCtl</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>bPrevious</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 handle to the first control that has the WS_TABSTOP style that precedes (or follows) the specified control. 
<p>
This function retrieves the handle to the first control that has the WS_TABSTOP style that precedes (or follows) the specified control <em>hCtl</em> in the 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>hCtl</em>&nbsp;</td><td>The handle to the control. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>bPrevious</em>&nbsp;</td><td>A boolean value indicates to retrive the preceding or following control. TRUE for preceding control.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The handle to the preceding or following control.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__dialog__fns.htm#ga15">GetNextDlgGroupItem</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga22" doxytag="window.h::IsDlgButtonChecked"></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 IsDlgButtonChecked           </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>idButton</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>
Determines whether a button control has a check mark next to it or whether a three-state button control is grayed, checked, or neither. 
<p>
This function determines whether the button control whose identifier is <em>idButton</em> has a check mark next to it or whether a three-state button control is grayed, checked, or neither.<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>idButton</em>&nbsp;</td><td>The identifier of the button.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The check state of the button. If the button is a normal button, the value being zero means the button is checked, otherwise unchecked. If the button is a special button with three states, the value can be one of the following values:<ul>
<li>BST_UNCHECKED<br>
 The button is unchecked.</li><li>BST_CHECKED<br>
 The button is checked.</li><li>BST_INDETERMINATE<br>
 The button is in indeterminate state.</li></ul>
</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__dialog__fns.htm#ga20">CheckDlgButton</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga17" doxytag="window.h::SendDlgItemMessage"></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 SendDlgItemMessage           </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>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"></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>
Sends a message