File: mentryFixedPoint.html

package info (click to toggle)
tklib 0.9-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 23,156 kB
  • sloc: tcl: 105,088; sh: 2,573; ansic: 792; pascal: 359; makefile: 69; sed: 53; exp: 21
file content (176 lines) | stat: -rw-r--r-- 5,073 bytes parent folder | download | duplicates (2)
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> &ndash; 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.&nbsp; Both <code><i>count1</i></code> and
    <code><i>count2</i></code> must be positive integers.&nbsp; 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>.&nbsp; 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>&nbsp;&nbsp;&nbsp;&nbsp; <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> &ndash; 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>&nbsp;&nbsp;&nbsp;&nbsp; <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> &ndash; 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>&nbsp;&nbsp;&nbsp;&nbsp; <a href=
    "index.html">Start page</a></p>
  </div>
</body>
</html>