1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176
|
<!DOCTYPE html>
<html>
<head>
<title>Multi-Entry Widgets for Real Numbers in Fixed-Point Format</title>
<meta name="Author" content="Csaba Nemethi">
<meta name="Keywords" content="mentry, widget, real number">
<link rel="stylesheet" type="text/css" href="stylesheet.css">
</head>
<body>
<div>
<h1>Multi-Entry Widgets for Real Numbers<br>
in Fixed-Point Format</h1>
<h2>For Mentry Version 4.3</h2>
<h3>by</h3>
<h2>Csaba Nemethi</h2>
<address>
<a href="mailto:csaba.nemethi@t-online.de">csaba.nemethi@t-online.de</a>
</address>
</div>
<hr>
<h2 id="contents">Contents</h2>
<ul>
<li><a href="#fixedPointMentry">The
<code><b>mentry::fixedPointMentry</b></code> Command</a></li>
<li><a href="#putReal">The <code><b>mentry::putReal</b></code>
Command</a></li>
<li><a href="#getReal">The <code><b>mentry::getReal</b></code>
Command</a></li>
</ul>
<div>
<p><a href="index.html">Start page</a></p>
</div>
<hr>
<h2 id="fixedPointMentry">The <code><b>mentry::fixedPointMentry</b></code>
Command</h2>
<dl>
<dt><b>NAME</b></dt>
<dd><code>mentry::fixedPointMentry</code> – Create and manipulate
mentry widgets for real numbers in fixed-point format</dd>
<dt class="tm"><b>SYNOPSIS</b></dt>
<dd>
<pre>
<b>mentry::fixedPointMentry</b> <i>pathName count1 count2</i> ?<b>-comma</b>? ?<i>options</i>?
</pre>
</dd>
<dt><b>DESCRIPTION</b></dt>
<dd>This command creates a new mentry widget <code><i>pathName</i></code>
for displaying and editing real numbers in fixed-point format, with
<code><i>count1</i></code> characters before and <code><i>count2</i></code>
digits after the decimal point. Both <code><i>count1</i></code> and
<code><i>count2</i></code> must be positive integers. The mentry will
have two entry components, separated by a label displaying a
<code><b>"."</b></code> character by default; the optional
<code><b>-comma</b></code> switch changes the label text to
<code><b>","</b></code>. The supported <code><i>options</i></code>
are the same as in the case of the <code><b><a href=
"mentryWidget.html">mentry::mentry</a></b></code> command.</dd>
<dd class="tm">The command sets the <code><b>type</b></code> attribute of
the widget to the value <code>"FixedPoint"</code> and returns the name of
the newly created widget.</dd>
<dt class="tm"><b>KEYWORDS</b></dt>
<dd>mentry, widget, real number</dd>
</dl>
<div>
<p><a href="#contents">Contents</a> <a href=
"index.html">Start page</a></p>
</div>
<hr>
<h2 id="putReal">The <code><b>mentry::putReal</b></code> Command</h2>
<dl>
<dt><b>NAME</b></dt>
<dd><code>mentry::putReal</code> – Output a real number to a mentry
of type <code>"FixedPoint"</code></dd>
<dt class="tm"><b>SYNOPSIS</b></dt>
<dd>
<pre>
<b>mentry::putReal</b> <i>number</i> <i>pathName</i>
</pre>
</dd>
<dt><b>DESCRIPTION</b></dt>
<dd>This command outputs the real number <code><i>number</i></code> to the
mentry widget <code><i>pathName</i></code>, which must have been created
with the <code><b><a href=
"#fixedPointMentry">mentry::fixedPointMentry</a></b></code> command (this
is checked by examining the widget's <code><b>type</b></code> attribute,
which must have the value <code>"FixedPoint"</code>).</dd>
<dd class="tm">The command generates an error if the number does not fit
into the widget because it has too many characters before the decimal
point.</dd>
<dt class="tm"><b>KEYWORDS</b></dt>
<dd>mentry, widget, real number</dd>
</dl>
<div>
<p><a href="#contents">Contents</a> <a href=
"index.html">Start page</a></p>
</div>
<hr>
<h2 id="getReal">The <code><b>mentry::getReal</b></code> Command</h2>
<dl>
<dt><b>NAME</b></dt>
<dd><code>mentry::getReal</code> – Get a real number from a mentry of
type <code>"FixedPoint"</code></dd>
<dt class="tm"><b>SYNOPSIS</b></dt>
<dd>
<pre>
<b>mentry::getReal</b> <i>pathName</i>
</pre>
</dd>
<dt><b>DESCRIPTION</b></dt>
<dd>This command returns the number contained in the mentry widget
<code><i>pathName</i></code>, which must have been created with the
<code><b><a href=
"#fixedPointMentry">mentry::fixedPointMentry</a></b></code> command (this
is checked by examining the widget's <code><b>type</b></code> attribute,
which must have the value <code>"FixedPoint"</code>).</dd>
<dd class="tm">If both entry components of the widget are empty, the
command sets the focus to the first entry component, generates an error,
and returns the string <code>"EMPTY"</code>.</dd>
<dt class="tm"><b>KEYWORDS</b></dt>
<dd>mentry, widget, real number</dd>
</dl>
<div>
<p><a href="#contents">Contents</a> <a href=
"index.html">Start page</a></p>
</div>
</body>
</html>
|