src/eric7/Documentation/Source/eric7.UI.NumbersWidget.html

Sat, 26 Apr 2025 12:34:32 +0200

author
Detlev Offenbach <detlev@die-offenbachs.de>
date
Sat, 26 Apr 2025 12:34:32 +0200
branch
eric7
changeset 11240
c48c615c04a3
parent 10692
9becf9ca115c
permissions
-rw-r--r--

MicroPython
- Added a configuration option to disable the support for the no longer produced Pimoroni Pico Wireless Pack.

<!DOCTYPE html>
<html><head>
<title>eric7.UI.NumbersWidget</title>
<meta charset="UTF-8">
<link rel="stylesheet" href="styles.css">
</head>
<body>
<a NAME="top" ID="top"></a>
<h1>eric7.UI.NumbersWidget</h1>
<p>
Module implementing a widget to show numbers in different formats.
</p>

<h3>Global Attributes</h3>
<table>
<tr><td>None</td></tr>
</table>

<h3>Classes</h3>
<table>
<tr>
<td><a href="#BinaryModel">BinaryModel</a></td>
<td>Class implementing a model for entering binary numbers.</td>
</tr>
<tr>
<td><a href="#NumbersWidget">NumbersWidget</a></td>
<td>Class implementing a widget to show numbers in different formats.</td>
</tr>
</table>

<h3>Functions</h3>
<table>
<tr><td>None</td></tr>
</table>

<hr />
<hr />
<a NAME="BinaryModel" ID="BinaryModel"></a>
<h2>BinaryModel</h2>
<p>
    Class implementing a model for entering binary numbers.
</p>

<h3>Derived from</h3>
QAbstractTableModel
<h3>Class Attributes</h3>
<table>
<tr><td>None</td></tr>
</table>

<h3>Class Methods</h3>
<table>
<tr><td>None</td></tr>
</table>

<h3>Methods</h3>
<table>
<tr>
<td><a href="#BinaryModel.__init__">BinaryModel</a></td>
<td>Constructor</td>
</tr>
<tr>
<td><a href="#BinaryModel.columnCount">columnCount</a></td>
<td>Public method to get the number of columns of the model.</td>
</tr>
<tr>
<td><a href="#BinaryModel.data">data</a></td>
<td>Public method to get data from the model.</td>
</tr>
<tr>
<td><a href="#BinaryModel.flags">flags</a></td>
<td>Public method to get flags from the model.</td>
</tr>
<tr>
<td><a href="#BinaryModel.getValue">getValue</a></td>
<td>Public slot to get the current value.</td>
</tr>
<tr>
<td><a href="#BinaryModel.headerData">headerData</a></td>
<td>Public method to get header data from the model.</td>
</tr>
<tr>
<td><a href="#BinaryModel.rowCount">rowCount</a></td>
<td>Public method to get the number of rows of the model.</td>
</tr>
<tr>
<td><a href="#BinaryModel.setBits">setBits</a></td>
<td>Public slot to set the number of bits.</td>
</tr>
<tr>
<td><a href="#BinaryModel.setBitsAndValue">setBitsAndValue</a></td>
<td>Public slot to set the number of bits and the value to show.</td>
</tr>
<tr>
<td><a href="#BinaryModel.setData">setData</a></td>
<td>Public method to set the data of a node cell.</td>
</tr>
<tr>
<td><a href="#BinaryModel.setValue">setValue</a></td>
<td>Public slot to set the value to show.</td>
</tr>
</table>

<h3>Static Methods</h3>
<table>
<tr><td>None</td></tr>
</table>


<a NAME="BinaryModel.__init__" ID="BinaryModel.__init__"></a>
<h4>BinaryModel (Constructor)</h4>
<b>BinaryModel</b>(<i>parent=None</i>)
<p>
        Constructor
</p>

<dl>

<dt><i>parent</i> (QWidget)</dt>
<dd>
reference to the parent widget
</dd>
</dl>
<a NAME="BinaryModel.columnCount" ID="BinaryModel.columnCount"></a>
<h4>BinaryModel.columnCount</h4>
<b>columnCount</b>(<i>_parent</i>)
<p>
        Public method to get the number of columns of the model.
</p>

<dl>

<dt><i>_parent</i> (QModelIndex)</dt>
<dd>
parent index (unused)
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
number of columns
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
int
</dd>
</dl>
<a NAME="BinaryModel.data" ID="BinaryModel.data"></a>
<h4>BinaryModel.data</h4>
<b>data</b>(<i>index, role=Qt.ItemDataRole.DisplayRole</i>)
<p>
        Public method to get data from the model.
</p>

<dl>

<dt><i>index</i> (QModelIndex)</dt>
<dd>
index to get data for
</dd>
<dt><i>role</i> (int)</dt>
<dd>
role of the data to retrieve
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
requested data
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
Any
</dd>
</dl>
<a NAME="BinaryModel.flags" ID="BinaryModel.flags"></a>
<h4>BinaryModel.flags</h4>
<b>flags</b>(<i>_index</i>)
<p>
        Public method to get flags from the model.
</p>

<dl>

<dt><i>_index</i> (QModelIndex)</dt>
<dd>
index to get flags for (unused)
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
flags
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
Qt.ItemFlags
</dd>
</dl>
<a NAME="BinaryModel.getValue" ID="BinaryModel.getValue"></a>
<h4>BinaryModel.getValue</h4>
<b>getValue</b>(<i></i>)
<p>
        Public slot to get the current value.
</p>

<dl>
<dt>Return:</dt>
<dd>
current value of the model
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
int
</dd>
</dl>
<a NAME="BinaryModel.headerData" ID="BinaryModel.headerData"></a>
<h4>BinaryModel.headerData</h4>
<b>headerData</b>(<i>section, orientation, role=Qt.ItemDataRole.DisplayRole</i>)
<p>
        Public method to get header data from the model.
</p>

<dl>

<dt><i>section</i> (int)</dt>
<dd>
section number
</dd>
<dt><i>orientation</i> (Qt.Orientation)</dt>
<dd>
orientation
</dd>
<dt><i>role</i> (Qt.ItemDataRole)</dt>
<dd>
role of the data to retrieve
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
requested data
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
Any
</dd>
</dl>
<a NAME="BinaryModel.rowCount" ID="BinaryModel.rowCount"></a>
<h4>BinaryModel.rowCount</h4>
<b>rowCount</b>(<i>_parent</i>)
<p>
        Public method to get the number of rows of the model.
</p>

<dl>

<dt><i>_parent</i> (QModelIndex)</dt>
<dd>
parent index (unused)
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
number of columns
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
int
</dd>
</dl>
<a NAME="BinaryModel.setBits" ID="BinaryModel.setBits"></a>
<h4>BinaryModel.setBits</h4>
<b>setBits</b>(<i>bits</i>)
<p>
        Public slot to set the number of bits.
</p>

<dl>

<dt><i>bits</i> (int)</dt>
<dd>
number of bits to show
</dd>
</dl>
<a NAME="BinaryModel.setBitsAndValue" ID="BinaryModel.setBitsAndValue"></a>
<h4>BinaryModel.setBitsAndValue</h4>
<b>setBitsAndValue</b>(<i>bits, value</i>)
<p>
        Public slot to set the number of bits and the value to show.
</p>

<dl>

<dt><i>bits</i> (int)</dt>
<dd>
number of bits to show
</dd>
<dt><i>value</i> (int)</dt>
<dd>
value to show
</dd>
</dl>
<a NAME="BinaryModel.setData" ID="BinaryModel.setData"></a>
<h4>BinaryModel.setData</h4>
<b>setData</b>(<i>index, value, role=Qt.ItemDataRole.EditRole</i>)
<p>
        Public method to set the data of a node cell.
</p>

<dl>

<dt><i>index</i> (QModelIndex)</dt>
<dd>
index of the node cell
</dd>
<dt><i>value</i> (Any)</dt>
<dd>
value to be set
</dd>
<dt><i>role</i> (int)</dt>
<dd>
role of the data
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
flag indicating success
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
boolean)
</dd>
</dl>
<a NAME="BinaryModel.setValue" ID="BinaryModel.setValue"></a>
<h4>BinaryModel.setValue</h4>
<b>setValue</b>(<i>value</i>)
<p>
        Public slot to set the value to show.
</p>

<dl>

<dt><i>value</i> (int)</dt>
<dd>
value to show
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="NumbersWidget" ID="NumbersWidget"></a>
<h2>NumbersWidget</h2>
<p>
    Class implementing a widget to show numbers in different formats.
</p>

<h3>Signals</h3>
<dl>

<dt>insertNumber(str)</dt>
<dd>
emitted after the user has entered a number
            and selected the number format
</dd>
</dl>
<h3>Derived from</h3>
QWidget, Ui_NumbersWidget
<h3>Class Attributes</h3>
<table>
<tr><td>None</td></tr>
</table>

<h3>Class Methods</h3>
<table>
<tr><td>None</td></tr>
</table>

<h3>Methods</h3>
<table>
<tr>
<td><a href="#NumbersWidget.__init__">NumbersWidget</a></td>
<td>Constructor</td>
</tr>
<tr>
<td><a href="#NumbersWidget.__binModelDataChanged">__binModelDataChanged</a></td>
<td>Private slot to handle a change of the binary model value by the user.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.__block">__block</a></td>
<td>Private slot to block some signals.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.__formatNumbers">__formatNumbers</a></td>
<td>Private method to format the various number inputs.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.on_binEdit_textChanged">on_binEdit_textChanged</a></td>
<td>Private slot to handle input of a binary number.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.on_binInButton_clicked">on_binInButton_clicked</a></td>
<td>Private slot to retrieve a binary number from the current editor.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.on_binOutButton_clicked">on_binOutButton_clicked</a></td>
<td>Private slot to send a binary number.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.on_byteOrderButton_clicked">on_byteOrderButton_clicked</a></td>
<td>Private slot to swap the byte order.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.on_decEdit_textChanged">on_decEdit_textChanged</a></td>
<td>Private slot to handle input of a decimal number.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.on_decInButton_clicked">on_decInButton_clicked</a></td>
<td>Private slot to retrieve a decimal number from the current editor.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.on_decOutButton_clicked">on_decOutButton_clicked</a></td>
<td>Private slot to send a decimal number.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.on_hexEdit_textChanged">on_hexEdit_textChanged</a></td>
<td>Private slot to handle input of a hexadecimal number.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.on_hexInButton_clicked">on_hexInButton_clicked</a></td>
<td>Private slot to retrieve a hexadecimal number from the current editor.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.on_hexOutButton_clicked">on_hexOutButton_clicked</a></td>
<td>Private slot to send a hexadecimal number.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.on_octEdit_textChanged">on_octEdit_textChanged</a></td>
<td>Private slot to handle input of an octal number.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.on_octInButton_clicked">on_octInButton_clicked</a></td>
<td>Private slot to retrieve an octal number from the current editor.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.on_octOutButton_clicked">on_octOutButton_clicked</a></td>
<td>Private slot to send an octal number.</td>
</tr>
<tr>
<td><a href="#NumbersWidget.on_sizeBox_valueChanged">on_sizeBox_valueChanged</a></td>
<td>Private slot handling a change of the bit size.</td>
</tr>
</table>

<h3>Static Methods</h3>
<table>
<tr><td>None</td></tr>
</table>


<a NAME="NumbersWidget.__init__" ID="NumbersWidget.__init__"></a>
<h4>NumbersWidget (Constructor)</h4>
<b>NumbersWidget</b>(<i>parent=None</i>)
<p>
        Constructor
</p>

<dl>

<dt><i>parent</i> (QWidget)</dt>
<dd>
reference to the parent widget
</dd>
</dl>
<a NAME="NumbersWidget.__binModelDataChanged" ID="NumbersWidget.__binModelDataChanged"></a>
<h4>NumbersWidget.__binModelDataChanged</h4>
<b>__binModelDataChanged</b>(<i>_start, _end</i>)
<p>
        Private slot to handle a change of the binary model value by the user.
</p>

<dl>

<dt><i>_start</i> (QModelIndex)</dt>
<dd>
start index (unused)
</dd>
<dt><i>_end</i> (QModelIndex)</dt>
<dd>
end index (unused)
</dd>
</dl>
<a NAME="NumbersWidget.__block" ID="NumbersWidget.__block"></a>
<h4>NumbersWidget.__block</h4>
<b>__block</b>(<i>b</i>)
<p>
        Private slot to block some signals.
</p>

<dl>

<dt><i>b</i> (bool)</dt>
<dd>
flah indicating the blocking state
</dd>
</dl>
<a NAME="NumbersWidget.__formatNumbers" ID="NumbersWidget.__formatNumbers"></a>
<h4>NumbersWidget.__formatNumbers</h4>
<b>__formatNumbers</b>(<i>numberFormat</i>)
<p>
        Private method to format the various number inputs.
</p>

<dl>

<dt><i>numberFormat</i> (int)</dt>
<dd>
number format indicator
</dd>
</dl>
<a NAME="NumbersWidget.on_binEdit_textChanged" ID="NumbersWidget.on_binEdit_textChanged"></a>
<h4>NumbersWidget.on_binEdit_textChanged</h4>
<b>on_binEdit_textChanged</b>(<i>txt</i>)
<p>
        Private slot to handle input of a binary number.
</p>

<dl>

<dt><i>txt</i> (str)</dt>
<dd>
text entered
</dd>
</dl>
<a NAME="NumbersWidget.on_binInButton_clicked" ID="NumbersWidget.on_binInButton_clicked"></a>
<h4>NumbersWidget.on_binInButton_clicked</h4>
<b>on_binInButton_clicked</b>(<i></i>)
<p>
        Private slot to retrieve a binary number from the current editor.
</p>

<a NAME="NumbersWidget.on_binOutButton_clicked" ID="NumbersWidget.on_binOutButton_clicked"></a>
<h4>NumbersWidget.on_binOutButton_clicked</h4>
<b>on_binOutButton_clicked</b>(<i></i>)
<p>
        Private slot to send a binary number.
</p>

<a NAME="NumbersWidget.on_byteOrderButton_clicked" ID="NumbersWidget.on_byteOrderButton_clicked"></a>
<h4>NumbersWidget.on_byteOrderButton_clicked</h4>
<b>on_byteOrderButton_clicked</b>(<i></i>)
<p>
        Private slot to swap the byte order.
</p>

<a NAME="NumbersWidget.on_decEdit_textChanged" ID="NumbersWidget.on_decEdit_textChanged"></a>
<h4>NumbersWidget.on_decEdit_textChanged</h4>
<b>on_decEdit_textChanged</b>(<i>txt</i>)
<p>
        Private slot to handle input of a decimal number.
</p>

<dl>

<dt><i>txt</i> (str)</dt>
<dd>
text entered
</dd>
</dl>
<a NAME="NumbersWidget.on_decInButton_clicked" ID="NumbersWidget.on_decInButton_clicked"></a>
<h4>NumbersWidget.on_decInButton_clicked</h4>
<b>on_decInButton_clicked</b>(<i></i>)
<p>
        Private slot to retrieve a decimal number from the current editor.
</p>

<a NAME="NumbersWidget.on_decOutButton_clicked" ID="NumbersWidget.on_decOutButton_clicked"></a>
<h4>NumbersWidget.on_decOutButton_clicked</h4>
<b>on_decOutButton_clicked</b>(<i></i>)
<p>
        Private slot to send a decimal number.
</p>

<a NAME="NumbersWidget.on_hexEdit_textChanged" ID="NumbersWidget.on_hexEdit_textChanged"></a>
<h4>NumbersWidget.on_hexEdit_textChanged</h4>
<b>on_hexEdit_textChanged</b>(<i>txt</i>)
<p>
        Private slot to handle input of a hexadecimal number.
</p>

<dl>

<dt><i>txt</i> (str)</dt>
<dd>
text entered
</dd>
</dl>
<a NAME="NumbersWidget.on_hexInButton_clicked" ID="NumbersWidget.on_hexInButton_clicked"></a>
<h4>NumbersWidget.on_hexInButton_clicked</h4>
<b>on_hexInButton_clicked</b>(<i></i>)
<p>
        Private slot to retrieve a hexadecimal number from the current editor.
</p>

<a NAME="NumbersWidget.on_hexOutButton_clicked" ID="NumbersWidget.on_hexOutButton_clicked"></a>
<h4>NumbersWidget.on_hexOutButton_clicked</h4>
<b>on_hexOutButton_clicked</b>(<i></i>)
<p>
        Private slot to send a hexadecimal number.
</p>

<a NAME="NumbersWidget.on_octEdit_textChanged" ID="NumbersWidget.on_octEdit_textChanged"></a>
<h4>NumbersWidget.on_octEdit_textChanged</h4>
<b>on_octEdit_textChanged</b>(<i>txt</i>)
<p>
        Private slot to handle input of an octal number.
</p>

<dl>

<dt><i>txt</i> (str)</dt>
<dd>
text entered
</dd>
</dl>
<a NAME="NumbersWidget.on_octInButton_clicked" ID="NumbersWidget.on_octInButton_clicked"></a>
<h4>NumbersWidget.on_octInButton_clicked</h4>
<b>on_octInButton_clicked</b>(<i></i>)
<p>
        Private slot to retrieve an octal number from the current editor.
</p>

<a NAME="NumbersWidget.on_octOutButton_clicked" ID="NumbersWidget.on_octOutButton_clicked"></a>
<h4>NumbersWidget.on_octOutButton_clicked</h4>
<b>on_octOutButton_clicked</b>(<i></i>)
<p>
        Private slot to send an octal number.
</p>

<a NAME="NumbersWidget.on_sizeBox_valueChanged" ID="NumbersWidget.on_sizeBox_valueChanged"></a>
<h4>NumbersWidget.on_sizeBox_valueChanged</h4>
<b>on_sizeBox_valueChanged</b>(<i>value</i>)
<p>
        Private slot handling a change of the bit size.
</p>

<dl>

<dt><i>value</i> (int)</dt>
<dd>
selected bit size
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>

eric ide

mercurial