eric7/Documentation/Source/eric7.HexEdit.HexEditSearchReplaceWidget.html

branch
eric7
changeset 8372
e0227a7c850e
child 8596
d64760b2da50
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/eric7/Documentation/Source/eric7.HexEdit.HexEditSearchReplaceWidget.html	Mon May 24 11:19:57 2021 +0200
@@ -0,0 +1,611 @@
+<!DOCTYPE html>
+<html><head>
+<title>eric7.HexEdit.HexEditSearchReplaceWidget</title>
+<meta charset="UTF-8">
+<style>
+body {
+    background: #EDECE6;
+    margin: 0em 1em 10em 1em;
+    color: black;
+}
+
+h1 { color: white; background: #85774A; }
+h2 { color: white; background: #85774A; }
+h3 { color: white; background: #9D936E; }
+h4 { color: white; background: #9D936E; }
+    
+a { color: #BA6D36; }
+
+</style>
+</head>
+<body>
+<a NAME="top" ID="top"></a>
+<h1>eric7.HexEdit.HexEditSearchReplaceWidget</h1>
+
+<p>
+Module implementing a search and replace widget for the hex editor.
+</p>
+<h3>Global Attributes</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<h3>Classes</h3>
+
+<table>
+
+<tr>
+<td><a href="#HexEditSearchReplaceWidget">HexEditSearchReplaceWidget</a></td>
+<td>Class implementing a search and replace widget for the hex editor.</td>
+</tr>
+</table>
+<h3>Functions</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<hr />
+<hr />
+<a NAME="HexEditSearchReplaceWidget" ID="HexEditSearchReplaceWidget"></a>
+<h2>HexEditSearchReplaceWidget</h2>
+
+<p>
+    Class implementing a search and replace widget for the hex editor.
+</p>
+<h3>Derived from</h3>
+QWidget
+<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="#HexEditSearchReplaceWidget.__init__">HexEditSearchReplaceWidget</a></td>
+<td>Constructor</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.__bytearray2int">__bytearray2int</a></td>
+<td>Private method to convert a byte array to an integer value.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.__bytearray2text">__bytearray2text</a></td>
+<td>Private method to convert a byte array to a text.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.__convertText">__convertText</a></td>
+<td>Private method to convert text from one format into another.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.__doReplace">__doReplace</a></td>
+<td>Private method to replace one occurrence of data.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.__findByReturnPressed">__findByReturnPressed</a></td>
+<td>Private slot to handle a return pressed in the find combo.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.__getContent">__getContent</a></td>
+<td>Private method to get the contents of the find/replace combo as a bytearray.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.__int2bytearray">__int2bytearray</a></td>
+<td>Private method to convert an integer to a byte array.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.__showFind">__showFind</a></td>
+<td>Private method to display this widget in find mode.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.__showReplace">__showReplace</a></td>
+<td>Private slot to display this widget in replace mode.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.__text2bytearray">__text2bytearray</a></td>
+<td>Private method to convert a text to a byte array.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.findPrevNext">findPrevNext</a></td>
+<td>Public slot to find the next occurrence of the search term.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.keyPressEvent">keyPressEvent</a></td>
+<td>Protected slot to handle key press events.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.on_closeButton_clicked">on_closeButton_clicked</a></td>
+<td>Private slot to close the widget.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.on_findFormatCombo_currentIndexChanged">on_findFormatCombo_currentIndexChanged</a></td>
+<td>Private slot to handle a selection from the find format.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.on_findNextButton_clicked">on_findNextButton_clicked</a></td>
+<td>Private slot to find the next occurrence.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.on_findPrevButton_clicked">on_findPrevButton_clicked</a></td>
+<td>Private slot to find the previous occurrence.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.on_findtextCombo_activated">on_findtextCombo_activated</a></td>
+<td>Private slot to handle a selection from the find history.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.on_findtextCombo_editTextChanged">on_findtextCombo_editTextChanged</a></td>
+<td>Private slot to enable/disable the find buttons.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.on_replaceAllButton_clicked">on_replaceAllButton_clicked</a></td>
+<td>Private slot to replace all occurrences of data.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.on_replaceButton_clicked">on_replaceButton_clicked</a></td>
+<td>Private slot to replace one occurrence of data.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.on_replaceFormatCombo_currentIndexChanged">on_replaceFormatCombo_currentIndexChanged</a></td>
+<td>Private slot to handle a selection from the replace format.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.on_replaceSearchButton_clicked">on_replaceSearchButton_clicked</a></td>
+<td>Private slot to replace one occurrence of data and search for the next one.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.on_replacetextCombo_activated">on_replacetextCombo_activated</a></td>
+<td>Private slot to handle a selection from the replace history.</td>
+</tr>
+<tr>
+<td><a href="#HexEditSearchReplaceWidget.show">show</a></td>
+<td>Public slot to show the widget.</td>
+</tr>
+</table>
+<h3>Static Methods</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+
+<a NAME="HexEditSearchReplaceWidget.__init__" ID="HexEditSearchReplaceWidget.__init__"></a>
+<h4>HexEditSearchReplaceWidget (Constructor)</h4>
+<b>HexEditSearchReplaceWidget</b>(<i>editor, mainWindow, replace=False, parent=None</i>)
+
+<p>
+        Constructor
+</p>
+<dl>
+
+<dt><i>editor</i> (HexEditWidget)</dt>
+<dd>
+reference to the hex editor widget
+</dd>
+<dt><i>mainWindow</i> (HexEditMainWindow)</dt>
+<dd>
+reference to the main window
+</dd>
+<dt><i>replace</i> (bool)</dt>
+<dd>
+flag indicating a replace widget
+</dd>
+<dt><i>parent</i> (QWidget)</dt>
+<dd>
+reference to the parent widget
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.__bytearray2int" ID="HexEditSearchReplaceWidget.__bytearray2int"></a>
+<h4>HexEditSearchReplaceWidget.__bytearray2int</h4>
+<b>__bytearray2int</b>(<i>array</i>)
+
+<p>
+        Private method to convert a byte array to an integer value.
+</p>
+<dl>
+
+<dt><i>array</i> (bytearray)</dt>
+<dd>
+byte array to be converted
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+integer value of the given array
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+int
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.__bytearray2text" ID="HexEditSearchReplaceWidget.__bytearray2text"></a>
+<h4>HexEditSearchReplaceWidget.__bytearray2text</h4>
+<b>__bytearray2text</b>(<i>array, dataFormat</i>)
+
+<p>
+        Private method to convert a byte array to a text.
+</p>
+<dl>
+
+<dt><i>array</i> (bytearray)</dt>
+<dd>
+byte array to be converted
+</dd>
+<dt><i>dataFormat</i> (str)</dt>
+<dd>
+format of the text
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+formatted text
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+str
+</dd>
+</dl>
+<dl>
+
+<dt>Raises <b>ValueError</b>:</dt>
+<dd>
+raised to indicate an invalid dataFormat
+            parameter
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.__convertText" ID="HexEditSearchReplaceWidget.__convertText"></a>
+<h4>HexEditSearchReplaceWidget.__convertText</h4>
+<b>__convertText</b>(<i>txt, oldFormat, newFormat</i>)
+
+<p>
+        Private method to convert text from one format into another.
+</p>
+<dl>
+
+<dt><i>txt</i> (str)</dt>
+<dd>
+text to be converted
+</dd>
+<dt><i>oldFormat</i> (str)</dt>
+<dd>
+current format of the text
+</dd>
+<dt><i>newFormat</i> (str)</dt>
+<dd>
+format to convert to
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+converted text
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+str
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.__doReplace" ID="HexEditSearchReplaceWidget.__doReplace"></a>
+<h4>HexEditSearchReplaceWidget.__doReplace</h4>
+<b>__doReplace</b>(<i>searchNext</i>)
+
+<p>
+        Private method to replace one occurrence of data.
+</p>
+<dl>
+
+<dt><i>searchNext</i> (bool)</dt>
+<dd>
+flag indicating to search for the next occurrence
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.__findByReturnPressed" ID="HexEditSearchReplaceWidget.__findByReturnPressed"></a>
+<h4>HexEditSearchReplaceWidget.__findByReturnPressed</h4>
+<b>__findByReturnPressed</b>(<i></i>)
+
+<p>
+        Private slot to handle a return pressed in the find combo.
+</p>
+<a NAME="HexEditSearchReplaceWidget.__getContent" ID="HexEditSearchReplaceWidget.__getContent"></a>
+<h4>HexEditSearchReplaceWidget.__getContent</h4>
+<b>__getContent</b>(<i>replace=False</i>)
+
+<p>
+        Private method to get the contents of the find/replace combo as
+        a bytearray.
+</p>
+<dl>
+
+<dt><i>replace</i> (bool)</dt>
+<dd>
+flag indicating to retrieve the replace contents
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+search or replace term as text and binary data
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+tuple of bytearray and str
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.__int2bytearray" ID="HexEditSearchReplaceWidget.__int2bytearray"></a>
+<h4>HexEditSearchReplaceWidget.__int2bytearray</h4>
+<b>__int2bytearray</b>(<i>value</i>)
+
+<p>
+        Private method to convert an integer to a byte array.
+</p>
+<dl>
+
+<dt><i>value</i> (int)</dt>
+<dd>
+value to be converted
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+byte array for the given value
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+bytearray
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.__showFind" ID="HexEditSearchReplaceWidget.__showFind"></a>
+<h4>HexEditSearchReplaceWidget.__showFind</h4>
+<b>__showFind</b>(<i>text=''</i>)
+
+<p>
+        Private method to display this widget in find mode.
+</p>
+<dl>
+
+<dt><i>text</i> (str)</dt>
+<dd>
+hex encoded text to be shown in the findtext edit
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.__showReplace" ID="HexEditSearchReplaceWidget.__showReplace"></a>
+<h4>HexEditSearchReplaceWidget.__showReplace</h4>
+<b>__showReplace</b>(<i>text=''</i>)
+
+<p>
+        Private slot to display this widget in replace mode.
+</p>
+<dl>
+
+<dt><i>text</i> (str)</dt>
+<dd>
+hex encoded text to be shown in the findtext edit
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.__text2bytearray" ID="HexEditSearchReplaceWidget.__text2bytearray"></a>
+<h4>HexEditSearchReplaceWidget.__text2bytearray</h4>
+<b>__text2bytearray</b>(<i>txt, dataFormat</i>)
+
+<p>
+        Private method to convert a text to a byte array.
+</p>
+<dl>
+
+<dt><i>txt</i> (str)</dt>
+<dd>
+text to be converted
+</dd>
+<dt><i>dataFormat</i> (str)</dt>
+<dd>
+format of the text
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+converted text
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+bytearray
+</dd>
+</dl>
+<dl>
+
+<dt>Raises <b>ValueError</b>:</dt>
+<dd>
+raised to indicate an invalid dataFormat
+            parameter
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.findPrevNext" ID="HexEditSearchReplaceWidget.findPrevNext"></a>
+<h4>HexEditSearchReplaceWidget.findPrevNext</h4>
+<b>findPrevNext</b>(<i>prev=False</i>)
+
+<p>
+        Public slot to find the next occurrence of the search term.
+</p>
+<dl>
+
+<dt><i>prev</i> (bool)</dt>
+<dd>
+flag indicating a backwards search
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+flag indicating a successful search
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+bool
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.keyPressEvent" ID="HexEditSearchReplaceWidget.keyPressEvent"></a>
+<h4>HexEditSearchReplaceWidget.keyPressEvent</h4>
+<b>keyPressEvent</b>(<i>event</i>)
+
+<p>
+        Protected slot to handle key press events.
+</p>
+<dl>
+
+<dt><i>event</i> (QKeyEvent)</dt>
+<dd>
+reference to the key press event
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.on_closeButton_clicked" ID="HexEditSearchReplaceWidget.on_closeButton_clicked"></a>
+<h4>HexEditSearchReplaceWidget.on_closeButton_clicked</h4>
+<b>on_closeButton_clicked</b>(<i></i>)
+
+<p>
+        Private slot to close the widget.
+</p>
+<a NAME="HexEditSearchReplaceWidget.on_findFormatCombo_currentIndexChanged" ID="HexEditSearchReplaceWidget.on_findFormatCombo_currentIndexChanged"></a>
+<h4>HexEditSearchReplaceWidget.on_findFormatCombo_currentIndexChanged</h4>
+<b>on_findFormatCombo_currentIndexChanged</b>(<i>idx</i>)
+
+<p>
+        Private slot to handle a selection from the find format.
+</p>
+<dl>
+
+<dt><i>idx</i> (int)</dt>
+<dd>
+index of the selected entry
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.on_findNextButton_clicked" ID="HexEditSearchReplaceWidget.on_findNextButton_clicked"></a>
+<h4>HexEditSearchReplaceWidget.on_findNextButton_clicked</h4>
+<b>on_findNextButton_clicked</b>(<i></i>)
+
+<p>
+        Private slot to find the next occurrence.
+</p>
+<a NAME="HexEditSearchReplaceWidget.on_findPrevButton_clicked" ID="HexEditSearchReplaceWidget.on_findPrevButton_clicked"></a>
+<h4>HexEditSearchReplaceWidget.on_findPrevButton_clicked</h4>
+<b>on_findPrevButton_clicked</b>(<i></i>)
+
+<p>
+        Private slot to find the previous occurrence.
+</p>
+<a NAME="HexEditSearchReplaceWidget.on_findtextCombo_activated" ID="HexEditSearchReplaceWidget.on_findtextCombo_activated"></a>
+<h4>HexEditSearchReplaceWidget.on_findtextCombo_activated</h4>
+<b>on_findtextCombo_activated</b>(<i>idx</i>)
+
+<p>
+        Private slot to handle a selection from the find history.
+</p>
+<dl>
+
+<dt><i>idx</i> (int)</dt>
+<dd>
+index of the selected entry
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.on_findtextCombo_editTextChanged" ID="HexEditSearchReplaceWidget.on_findtextCombo_editTextChanged"></a>
+<h4>HexEditSearchReplaceWidget.on_findtextCombo_editTextChanged</h4>
+<b>on_findtextCombo_editTextChanged</b>(<i>txt</i>)
+
+<p>
+        Private slot to enable/disable the find buttons.
+</p>
+<dl>
+
+<dt><i>txt</i> (str)</dt>
+<dd>
+text of the find text combo
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.on_replaceAllButton_clicked" ID="HexEditSearchReplaceWidget.on_replaceAllButton_clicked"></a>
+<h4>HexEditSearchReplaceWidget.on_replaceAllButton_clicked</h4>
+<b>on_replaceAllButton_clicked</b>(<i></i>)
+
+<p>
+        Private slot to replace all occurrences of data.
+</p>
+<a NAME="HexEditSearchReplaceWidget.on_replaceButton_clicked" ID="HexEditSearchReplaceWidget.on_replaceButton_clicked"></a>
+<h4>HexEditSearchReplaceWidget.on_replaceButton_clicked</h4>
+<b>on_replaceButton_clicked</b>(<i></i>)
+
+<p>
+        Private slot to replace one occurrence of data.
+</p>
+<a NAME="HexEditSearchReplaceWidget.on_replaceFormatCombo_currentIndexChanged" ID="HexEditSearchReplaceWidget.on_replaceFormatCombo_currentIndexChanged"></a>
+<h4>HexEditSearchReplaceWidget.on_replaceFormatCombo_currentIndexChanged</h4>
+<b>on_replaceFormatCombo_currentIndexChanged</b>(<i>idx</i>)
+
+<p>
+        Private slot to handle a selection from the replace format.
+</p>
+<dl>
+
+<dt><i>idx</i> (int)</dt>
+<dd>
+index of the selected entry
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.on_replaceSearchButton_clicked" ID="HexEditSearchReplaceWidget.on_replaceSearchButton_clicked"></a>
+<h4>HexEditSearchReplaceWidget.on_replaceSearchButton_clicked</h4>
+<b>on_replaceSearchButton_clicked</b>(<i></i>)
+
+<p>
+        Private slot to replace one occurrence of data and search for the next
+        one.
+</p>
+<a NAME="HexEditSearchReplaceWidget.on_replacetextCombo_activated" ID="HexEditSearchReplaceWidget.on_replacetextCombo_activated"></a>
+<h4>HexEditSearchReplaceWidget.on_replacetextCombo_activated</h4>
+<b>on_replacetextCombo_activated</b>(<i>idx</i>)
+
+<p>
+        Private slot to handle a selection from the replace history.
+</p>
+<dl>
+
+<dt><i>idx</i> (int)</dt>
+<dd>
+index of the selected entry
+</dd>
+</dl>
+<a NAME="HexEditSearchReplaceWidget.show" ID="HexEditSearchReplaceWidget.show"></a>
+<h4>HexEditSearchReplaceWidget.show</h4>
+<b>show</b>(<i>text=''</i>)
+
+<p>
+        Public slot to show the widget.
+</p>
+<dl>
+
+<dt><i>text</i> (str)</dt>
+<dd>
+hex encoded text to be shown in the findtext edit
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr />
+</body></html>
\ No newline at end of file

eric ide

mercurial