group__system__font.htm

MINIGUI1.6开发API

<p>
This function returns the height of a character of the system default font. MiniGUI uses mono-space font as the default system font.<p>
Normally, the width of one multi-byte character is equal to the width of two single-byte character when using the default system font.<p>
<dl compact><dt><b>Returns:</b></dt><dd>The character height of the default system font.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__system__font.htm#ga7">GetSysCharWidth</a>, <a class="el" href="group__system__font.htm#ga8">GetSysCCharWidth</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga5" doxytag="gdi.h::GetSysCharset"></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">const char *GUIAPI GetSysCharset           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="group__simple__types.htm#ga0">BOOL</a>&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>wchar</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 current system charset. 
<p>
This function gets the current system charset and returns the charset name. By default, the system charset is ISO8859-1 (for single-byte charset) or GB2312.1980-0 (for wide charset), but you can change it by modifying <em>MiniGUI.cfg</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>wchar</em>&nbsp;</td><td>Whether to retrieve the wide charset supported currently. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The read-only buffer of charset name. If you pass <em>wchar</em> TRUE, This function may return NULL, if there is not any wide charset supported. </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga7" doxytag="gdi.h::GetSysCharWidth"></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 GetSysCharWidth           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">void&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </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 width of a single-byte character of the default system font. 
<p>
This function returns the width of a single-byte character of the default system font. MiniGUI uses mono-space font as the default system font, but you can specify a different font to output text in windows of MiniGUI.<p>
<dl compact><dt><b>Returns:</b></dt><dd>The width of single-byte character of the default system font.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__system__font.htm#ga6">GetSysCharHeight</a>, <a class="el" href="group__system__font.htm#ga8">GetSysCCharWidth</a>, <a class="el" href="group__font__fns.htm#ga19">SelectFont</a>, <a class="el" href="group__font__fns.htm#ga13">CreateLogFont</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga3" doxytag="gdi.h::GetSysFontAveWidth"></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 GetSysFontAveWidth           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">int&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>font_id</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 average width of a single-byte character of a system font. 
<p>
This function returns the average width of a single-byte character of one system font.<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>font_id</em>&nbsp;</td><td>The identifier of a system font.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The average width of single-byte character of the default system font.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__system__font.htm#ga1">GetSystemFont</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga4" doxytag="gdi.h::GetSysFontHeight"></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 GetSysFontHeight           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">int&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>font_id</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 height of a single-byte character of a system font. 
<p>
This function returns the height of a single-byte character of one system font.<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>font_id</em>&nbsp;</td><td>The identifier of a system font.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The height of single-byte character of the default system font.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__system__font.htm#ga1">GetSystemFont</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga2" doxytag="gdi.h::GetSysFontMaxWidth"></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 GetSysFontMaxWidth           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">int&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>font_id</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 maximal width of a single-byte character of a system font. 
<p>
This function returns the maximal width of a single-byte character of one system font.<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>font_id</em>&nbsp;</td><td>The identifier of a system font.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The maximal width of single-byte character of the default system font.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__system__font.htm#ga1">GetSystemFont</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga1" doxytag="gdi.h::GetSystemFont"></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="struct__LOGFONT.htm">PLOGFONT</a> GUIAPI GetSystemFont           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">int&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>font_id</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap><code> [inline, static]</code></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Gets the system logical font through an font identifier. 
<p>
This function returns the system logical font through the font identifier <em>font_id</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>font_id</em>&nbsp;</td><td>The identifier of a system font, can be one of the following values:<ul>
<li>SYSLOGFONT_DEFAULT<br>
 The default system logical font in single-byte charset, must be rbf.</li><li>SYSLOGFONT_WCHAR_DEF<br>
 The default system logical font in multi-byte charset, must be rbf.</li><li>SYSLOGFONT_FIXED<br>
 The fixed space system logical font.</li><li>SYSLOGFONT_CAPTION<br>
 The system logical font used to draw caption text.</li><li>SYSLOGFONT_MENU<br>
 The system logical font used to draw menu items.</li><li>SYSLOGFONT_CONTROL<br>
 The system logical font used to draw controls. </li></ul>
</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The pointer to the system logical font. NULL on error. </dd></dl>

<p>
Definition at line <a class="el" href="gdi_8h-source.htm#l06166">6166</a> of file <a class="el" href="gdi_8h-source.htm">gdi.h</a>.
<p>
References <a class="el" href="common_8h-source.htm#l00270">NULL</a>.    </td>
  </tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Thu Nov 22 15:35:54 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>