--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Documentation/Source/eric5.QScintilla.MiniEditor.html Sat Jan 02 18:19:35 2010 +0000 @@ -0,0 +1,911 @@ +<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Strict//EN' +'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'> +<html><head> +<title>eric5.QScintilla.MiniEditor</title> +<style> +b'body {\n background:white;\n margin: 0em 1em 10em 1em;\n color: black;\n}\n\nh1 { color: white; background: #4FA4FF; }\nh2 { color: white; background: #4FA4FF; }\nh3 { color: white; background: #00557F; }\nh4 { color: white; background: #00557F; }\n \na { color: #AA5500; }\n' +</style> +</head> +<body><a NAME="top" ID="top"></a> +<h1>eric5.QScintilla.MiniEditor</h1> +<p> +Module implementing a minimalistic editor for simple editing tasks. +</p> +<h3>Global Attributes</h3> +<table> +<tr><td>None</td></tr> +</table> +<h3>Classes</h3> +<table> +<tr> +<td><a href="#MiniEditor">MiniEditor</a></td> +<td>Class implementing a minimalistic editor for simple editing tasks.</td> +</tr><tr> +<td><a href="#MiniScintilla">MiniScintilla</a></td> +<td>Class implementing a QsciScintillaCompat subclass for handling focus events.</td> +</tr> +</table> +<h3>Functions</h3> +<table> +<tr><td>None</td></tr> +</table> +<hr /><hr /> +<a NAME="MiniEditor" ID="MiniEditor"></a> +<h2>MiniEditor</h2> +<p> + Class implementing a minimalistic editor for simple editing tasks. +</p><h4>Signals</h4> +<dl> +<dt>editorSaved</dt> +<dd> +emitted after the file has been saved +</dd> +</dl> +<h3>Derived from</h3> +QMainWindow +<h3>Class Attributes</h3> +<table> +<tr><td>None</td></tr> +</table> +<h3>Methods</h3> +<table> +<tr> +<td><a href="#MiniEditor.__init__">MiniEditor</a></td> +<td>Constructor</td> +</tr><tr> +<td><a href="#MiniEditor.__about">__about</a></td> +<td>Private slot to show a little About message.</td> +</tr><tr> +<td><a href="#MiniEditor.__aboutQt">__aboutQt</a></td> +<td>Private slot to handle the About Qt dialog.</td> +</tr><tr> +<td><a href="#MiniEditor.__bindLexer">__bindLexer</a></td> +<td>Private slot to set the correct lexer depending on language.</td> +</tr><tr> +<td><a href="#MiniEditor.__bindName">__bindName</a></td> +<td>Private method to generate a dummy filename for binding a lexer.</td> +</tr><tr> +<td><a href="#MiniEditor.__checkActions">__checkActions</a></td> +<td>Private slot to check some actions for their enable/disable status and set the statusbar info.</td> +</tr><tr> +<td><a href="#MiniEditor.__checkLanguage">__checkLanguage</a></td> +<td>Private method to check the selected language of the language submenu.</td> +</tr><tr> +<td><a href="#MiniEditor.__contextMenuRequested">__contextMenuRequested</a></td> +<td>Private slot to show the context menu.</td> +</tr><tr> +<td><a href="#MiniEditor.__createActions">__createActions</a></td> +<td>Private method to create the actions.</td> +</tr><tr> +<td><a href="#MiniEditor.__createEditActions">__createEditActions</a></td> +<td>Private method to create the Edit actions.</td> +</tr><tr> +<td><a href="#MiniEditor.__createFileActions">__createFileActions</a></td> +<td>Private method to create the File actions.</td> +</tr><tr> +<td><a href="#MiniEditor.__createHelpActions">__createHelpActions</a></td> +<td>Private method to create the Help actions.</td> +</tr><tr> +<td><a href="#MiniEditor.__createMenus">__createMenus</a></td> +<td>Private method to create the menus of the menu bar.</td> +</tr><tr> +<td><a href="#MiniEditor.__createSearchActions">__createSearchActions</a></td> +<td>Private method defining the user interface actions for the search commands.</td> +</tr><tr> +<td><a href="#MiniEditor.__createStatusBar">__createStatusBar</a></td> +<td>Private method to initialize the status bar.</td> +</tr><tr> +<td><a href="#MiniEditor.__createToolBars">__createToolBars</a></td> +<td>Private method to create the various toolbars.</td> +</tr><tr> +<td><a href="#MiniEditor.__cursorPositionChanged">__cursorPositionChanged</a></td> +<td>Private slot to handle the cursorPositionChanged signal.</td> +</tr><tr> +<td><a href="#MiniEditor.__deselectAll">__deselectAll</a></td> +<td>Private slot handling the deselect all context menu action.</td> +</tr><tr> +<td><a href="#MiniEditor.__documentWasModified">__documentWasModified</a></td> +<td>Private slot to handle a change in the documents modification status.</td> +</tr><tr> +<td><a href="#MiniEditor.__getCurrentWord">__getCurrentWord</a></td> +<td>Private method to get the word at the current position.</td> +</tr><tr> +<td><a href="#MiniEditor.__getWord">__getWord</a></td> +<td>Private method to get the word at a position.</td> +</tr><tr> +<td><a href="#MiniEditor.__initContextMenu">__initContextMenu</a></td> +<td>Private method used to setup the context menu</td> +</tr><tr> +<td><a href="#MiniEditor.__initContextMenuLanguages">__initContextMenuLanguages</a></td> +<td>Private method used to setup the Languages context sub menu.</td> +</tr><tr> +<td><a href="#MiniEditor.__languageMenuTriggered">__languageMenuTriggered</a></td> +<td>Private method to handle the selection of a lexer language.</td> +</tr><tr> +<td><a href="#MiniEditor.__loadFile">__loadFile</a></td> +<td>Private method to load the given file.</td> +</tr><tr> +<td><a href="#MiniEditor.__markOccurrences">__markOccurrences</a></td> +<td>Private method to mark all occurrences of the current word.</td> +</tr><tr> +<td><a href="#MiniEditor.__maybeSave">__maybeSave</a></td> +<td>Private method to ask the user to save the file, if it was modified.</td> +</tr><tr> +<td><a href="#MiniEditor.__modificationChanged">__modificationChanged</a></td> +<td>Private slot to handle the modificationChanged signal.</td> +</tr><tr> +<td><a href="#MiniEditor.__newFile">__newFile</a></td> +<td>Private slot to create a new file.</td> +</tr><tr> +<td><a href="#MiniEditor.__open">__open</a></td> +<td>Private slot to open a file.</td> +</tr><tr> +<td><a href="#MiniEditor.__printFile">__printFile</a></td> +<td>Private slot to print the text.</td> +</tr><tr> +<td><a href="#MiniEditor.__printPreview">__printPreview</a></td> +<td>Private slot to generate a print preview.</td> +</tr><tr> +<td><a href="#MiniEditor.__printPreviewFile">__printPreviewFile</a></td> +<td>Private slot to show a print preview of the text.</td> +</tr><tr> +<td><a href="#MiniEditor.__readSettings">__readSettings</a></td> +<td>Private method to read the settings remembered last time.</td> +</tr><tr> +<td><a href="#MiniEditor.__readShortcut">__readShortcut</a></td> +<td>Private function to read a single keyboard shortcut from the settings.</td> +</tr><tr> +<td><a href="#MiniEditor.__redo">__redo</a></td> +<td>Public method to redo the last recorded change.</td> +</tr><tr> +<td><a href="#MiniEditor.__replace">__replace</a></td> +<td>Private method to handle the replace action.</td> +</tr><tr> +<td><a href="#MiniEditor.__resetLanguage">__resetLanguage</a></td> +<td>Private method used to reset the language selection.</td> +</tr><tr> +<td><a href="#MiniEditor.__save">__save</a></td> +<td>Private slot to save a file.</td> +</tr><tr> +<td><a href="#MiniEditor.__saveAs">__saveAs</a></td> +<td>Private slot to save a file with a new name.</td> +</tr><tr> +<td><a href="#MiniEditor.__saveFile">__saveFile</a></td> +<td>Private method to save to the given file.</td> +</tr><tr> +<td><a href="#MiniEditor.__search">__search</a></td> +<td>Private method to handle the search action.</td> +</tr><tr> +<td><a href="#MiniEditor.__searchClearMarkers">__searchClearMarkers</a></td> +<td>Private method to clear the search markers of the active window.</td> +</tr><tr> +<td><a href="#MiniEditor.__selectAll">__selectAll</a></td> +<td>Private slot handling the select all context menu action.</td> +</tr><tr> +<td><a href="#MiniEditor.__selectPygmentsLexer">__selectPygmentsLexer</a></td> +<td>Private method to select a specific pygments lexer.</td> +</tr><tr> +<td><a href="#MiniEditor.__setCurrentFile">__setCurrentFile</a></td> +<td>Private method to register the file name of the current file.</td> +</tr><tr> +<td><a href="#MiniEditor.__setEolMode">__setEolMode</a></td> +<td>Private method to configure the eol mode of the editor.</td> +</tr><tr> +<td><a href="#MiniEditor.__setMargins">__setMargins</a></td> +<td>Private method to configure the margins.</td> +</tr><tr> +<td><a href="#MiniEditor.__setMonospaced">__setMonospaced</a></td> +<td>Private method to set/reset a monospaced font.</td> +</tr><tr> +<td><a href="#MiniEditor.__setSbFile">__setSbFile</a></td> +<td>Private method to set the file info in the status bar.</td> +</tr><tr> +<td><a href="#MiniEditor.__setTextDisplay">__setTextDisplay</a></td> +<td>Private method to configure the text display.</td> +</tr><tr> +<td><a href="#MiniEditor.__showContextMenuLanguages">__showContextMenuLanguages</a></td> +<td>Private slot handling the aboutToShow signal of the languages context menu.</td> +</tr><tr> +<td><a href="#MiniEditor.__strippedName">__strippedName</a></td> +<td>Private method to return the filename part of the given path.</td> +</tr><tr> +<td><a href="#MiniEditor.__styleNeeded">__styleNeeded</a></td> +<td>Private slot to handle the need for more styling.</td> +</tr><tr> +<td><a href="#MiniEditor.__undo">__undo</a></td> +<td>Public method to undo the last recorded change.</td> +</tr><tr> +<td><a href="#MiniEditor.__whatsThis">__whatsThis</a></td> +<td>Private slot called in to enter Whats This mode.</td> +</tr><tr> +<td><a href="#MiniEditor.__writeSettings">__writeSettings</a></td> +<td>Private method to write the settings for reuse.</td> +</tr><tr> +<td><a href="#MiniEditor.activeWindow">activeWindow</a></td> +<td>Public method to fulfill the ViewManager interface.</td> +</tr><tr> +<td><a href="#MiniEditor.clearSearchIndicators">clearSearchIndicators</a></td> +<td>Public method to clear all search indicators.</td> +</tr><tr> +<td><a href="#MiniEditor.closeEvent">closeEvent</a></td> +<td>Public method to handle the close event.</td> +</tr><tr> +<td><a href="#MiniEditor.getFileName">getFileName</a></td> +<td>Public method to return the name of the file being displayed.</td> +</tr><tr> +<td><a href="#MiniEditor.getLanguage">getLanguage</a></td> +<td>Public method to retrieve the language of the editor.</td> +</tr><tr> +<td><a href="#MiniEditor.getSRHistory">getSRHistory</a></td> +<td>Public method to get the search or replace history list.</td> +</tr><tr> +<td><a href="#MiniEditor.readLine0">readLine0</a></td> +<td>Public slot to read the first line from a file.</td> +</tr><tr> +<td><a href="#MiniEditor.setLanguage">setLanguage</a></td> +<td>Public method to set a lexer language.</td> +</tr><tr> +<td><a href="#MiniEditor.setSearchIndicator">setSearchIndicator</a></td> +<td>Public method to set a search indicator for the given range.</td> +</tr><tr> +<td><a href="#MiniEditor.setText">setText</a></td> +<td>Public method to set the text programatically.</td> +</tr><tr> +<td><a href="#MiniEditor.textForFind">textForFind</a></td> +<td>Public method to determine the selection or the current word for the next find operation.</td> +</tr> +</table> +<a NAME="MiniEditor.__init__" ID="MiniEditor.__init__"></a> +<h4>MiniEditor (Constructor)</h4> +<b>MiniEditor</b>(<i>filename = "", filetype = "", parent = None, name = None</i>) +<p> + Constructor +</p><dl> +<dt><i>filename</i></dt> +<dd> +name of the file to open (string) +</dd><dt><i>filetype</i></dt> +<dd> +type of the source file (string) +</dd><dt><i>parent</i></dt> +<dd> +reference to the parent widget (QWidget) +</dd><dt><i>name</i></dt> +<dd> +object name of the window (string) +</dd> +</dl><a NAME="MiniEditor.__about" ID="MiniEditor.__about"></a> +<h4>MiniEditor.__about</h4> +<b>__about</b>(<i></i>) +<p> + Private slot to show a little About message. +</p><a NAME="MiniEditor.__aboutQt" ID="MiniEditor.__aboutQt"></a> +<h4>MiniEditor.__aboutQt</h4> +<b>__aboutQt</b>(<i></i>) +<p> + Private slot to handle the About Qt dialog. +</p><a NAME="MiniEditor.__bindLexer" ID="MiniEditor.__bindLexer"></a> +<h4>MiniEditor.__bindLexer</h4> +<b>__bindLexer</b>(<i>filename, pyname = ""</i>) +<p> + Private slot to set the correct lexer depending on language. +</p><dl> +<dt><i>filename</i></dt> +<dd> +filename used to determine the associated lexer language (string) +</dd><dt><i>pyname=</i></dt> +<dd> +name of the pygments lexer to use (string) +</dd> +</dl><a NAME="MiniEditor.__bindName" ID="MiniEditor.__bindName"></a> +<h4>MiniEditor.__bindName</h4> +<b>__bindName</b>(<i>line0</i>) +<p> + Private method to generate a dummy filename for binding a lexer. +</p><dl> +<dt><i>line0</i></dt> +<dd> +first line of text to use in the generation process (string) +</dd> +</dl><a NAME="MiniEditor.__checkActions" ID="MiniEditor.__checkActions"></a> +<h4>MiniEditor.__checkActions</h4> +<b>__checkActions</b>(<i>setSb = True</i>) +<p> + Private slot to check some actions for their enable/disable status + and set the statusbar info. +</p><dl> +<dt><i>setSb</i></dt> +<dd> +flag indicating an update of the status bar is wanted (boolean) +</dd> +</dl><a NAME="MiniEditor.__checkLanguage" ID="MiniEditor.__checkLanguage"></a> +<h4>MiniEditor.__checkLanguage</h4> +<b>__checkLanguage</b>(<i></i>) +<p> + Private method to check the selected language of the language submenu. +</p><a NAME="MiniEditor.__contextMenuRequested" ID="MiniEditor.__contextMenuRequested"></a> +<h4>MiniEditor.__contextMenuRequested</h4> +<b>__contextMenuRequested</b>(<i>coord</i>) +<p> + Private slot to show the context menu. +</p><dl> +<dt><i>coord</i></dt> +<dd> +the position of the mouse pointer (QPoint) +</dd> +</dl><a NAME="MiniEditor.__createActions" ID="MiniEditor.__createActions"></a> +<h4>MiniEditor.__createActions</h4> +<b>__createActions</b>(<i></i>) +<p> + Private method to create the actions. +</p><a NAME="MiniEditor.__createEditActions" ID="MiniEditor.__createEditActions"></a> +<h4>MiniEditor.__createEditActions</h4> +<b>__createEditActions</b>(<i></i>) +<p> + Private method to create the Edit actions. +</p><a NAME="MiniEditor.__createFileActions" ID="MiniEditor.__createFileActions"></a> +<h4>MiniEditor.__createFileActions</h4> +<b>__createFileActions</b>(<i></i>) +<p> + Private method to create the File actions. +</p><a NAME="MiniEditor.__createHelpActions" ID="MiniEditor.__createHelpActions"></a> +<h4>MiniEditor.__createHelpActions</h4> +<b>__createHelpActions</b>(<i></i>) +<p> + Private method to create the Help actions. +</p><a NAME="MiniEditor.__createMenus" ID="MiniEditor.__createMenus"></a> +<h4>MiniEditor.__createMenus</h4> +<b>__createMenus</b>(<i></i>) +<p> + Private method to create the menus of the menu bar. +</p><a NAME="MiniEditor.__createSearchActions" ID="MiniEditor.__createSearchActions"></a> +<h4>MiniEditor.__createSearchActions</h4> +<b>__createSearchActions</b>(<i></i>) +<p> + Private method defining the user interface actions for the search commands. +</p><a NAME="MiniEditor.__createStatusBar" ID="MiniEditor.__createStatusBar"></a> +<h4>MiniEditor.__createStatusBar</h4> +<b>__createStatusBar</b>(<i></i>) +<p> + Private method to initialize the status bar. +</p><a NAME="MiniEditor.__createToolBars" ID="MiniEditor.__createToolBars"></a> +<h4>MiniEditor.__createToolBars</h4> +<b>__createToolBars</b>(<i></i>) +<p> + Private method to create the various toolbars. +</p><a NAME="MiniEditor.__cursorPositionChanged" ID="MiniEditor.__cursorPositionChanged"></a> +<h4>MiniEditor.__cursorPositionChanged</h4> +<b>__cursorPositionChanged</b>(<i>line, pos</i>) +<p> + Private slot to handle the cursorPositionChanged signal. +</p><dl> +<dt><i>line</i></dt> +<dd> +line number of the cursor +</dd><dt><i>pos</i></dt> +<dd> +position in line of the cursor +</dd> +</dl><a NAME="MiniEditor.__deselectAll" ID="MiniEditor.__deselectAll"></a> +<h4>MiniEditor.__deselectAll</h4> +<b>__deselectAll</b>(<i></i>) +<p> + Private slot handling the deselect all context menu action. +</p><a NAME="MiniEditor.__documentWasModified" ID="MiniEditor.__documentWasModified"></a> +<h4>MiniEditor.__documentWasModified</h4> +<b>__documentWasModified</b>(<i></i>) +<p> + Private slot to handle a change in the documents modification status. +</p><a NAME="MiniEditor.__getCurrentWord" ID="MiniEditor.__getCurrentWord"></a> +<h4>MiniEditor.__getCurrentWord</h4> +<b>__getCurrentWord</b>(<i></i>) +<p> + Private method to get the word at the current position. +</p><dl> +<dt>Returns:</dt> +<dd> +the word at that current position +</dd> +</dl><a NAME="MiniEditor.__getWord" ID="MiniEditor.__getWord"></a> +<h4>MiniEditor.__getWord</h4> +<b>__getWord</b>(<i>line, index</i>) +<p> + Private method to get the word at a position. +</p><dl> +<dt><i>line</i></dt> +<dd> +number of line to look at (int) +</dd><dt><i>index</i></dt> +<dd> +position to look at (int) +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +the word at that position (string) +</dd> +</dl><a NAME="MiniEditor.__initContextMenu" ID="MiniEditor.__initContextMenu"></a> +<h4>MiniEditor.__initContextMenu</h4> +<b>__initContextMenu</b>(<i></i>) +<p> + Private method used to setup the context menu +</p><a NAME="MiniEditor.__initContextMenuLanguages" ID="MiniEditor.__initContextMenuLanguages"></a> +<h4>MiniEditor.__initContextMenuLanguages</h4> +<b>__initContextMenuLanguages</b>(<i></i>) +<p> + Private method used to setup the Languages context sub menu. +</p><a NAME="MiniEditor.__languageMenuTriggered" ID="MiniEditor.__languageMenuTriggered"></a> +<h4>MiniEditor.__languageMenuTriggered</h4> +<b>__languageMenuTriggered</b>(<i>act</i>) +<p> + Private method to handle the selection of a lexer language. +</p><dl> +<dt><i>act</i></dt> +<dd> +reference to the action that was triggered (QAction) +</dd> +</dl><a NAME="MiniEditor.__loadFile" ID="MiniEditor.__loadFile"></a> +<h4>MiniEditor.__loadFile</h4> +<b>__loadFile</b>(<i>fileName, filetype = None</i>) +<p> + Private method to load the given file. +</p><dl> +<dt><i>fileName</i></dt> +<dd> +name of the file to load (string) +</dd><dt><i>filetype</i></dt> +<dd> +type of the source file (string) +</dd> +</dl><a NAME="MiniEditor.__markOccurrences" ID="MiniEditor.__markOccurrences"></a> +<h4>MiniEditor.__markOccurrences</h4> +<b>__markOccurrences</b>(<i></i>) +<p> + Private method to mark all occurrences of the current word. +</p><a NAME="MiniEditor.__maybeSave" ID="MiniEditor.__maybeSave"></a> +<h4>MiniEditor.__maybeSave</h4> +<b>__maybeSave</b>(<i></i>) +<p> + Private method to ask the user to save the file, if it was modified. +</p><dl> +<dt>Returns:</dt> +<dd> +flag indicating, if it is ok to continue (boolean) +</dd> +</dl><a NAME="MiniEditor.__modificationChanged" ID="MiniEditor.__modificationChanged"></a> +<h4>MiniEditor.__modificationChanged</h4> +<b>__modificationChanged</b>(<i>m</i>) +<p> + Private slot to handle the modificationChanged signal. +</p><dl> +<dt><i>m</i></dt> +<dd> +modification status +</dd> +</dl><a NAME="MiniEditor.__newFile" ID="MiniEditor.__newFile"></a> +<h4>MiniEditor.__newFile</h4> +<b>__newFile</b>(<i></i>) +<p> + Private slot to create a new file. +</p><a NAME="MiniEditor.__open" ID="MiniEditor.__open"></a> +<h4>MiniEditor.__open</h4> +<b>__open</b>(<i></i>) +<p> + Private slot to open a file. +</p><a NAME="MiniEditor.__printFile" ID="MiniEditor.__printFile"></a> +<h4>MiniEditor.__printFile</h4> +<b>__printFile</b>(<i></i>) +<p> + Private slot to print the text. +</p><a NAME="MiniEditor.__printPreview" ID="MiniEditor.__printPreview"></a> +<h4>MiniEditor.__printPreview</h4> +<b>__printPreview</b>(<i>printer</i>) +<p> + Private slot to generate a print preview. +</p><dl> +<dt><i>printer</i></dt> +<dd> +reference to the printer object (QScintilla.Printer.Printer) +</dd> +</dl><a NAME="MiniEditor.__printPreviewFile" ID="MiniEditor.__printPreviewFile"></a> +<h4>MiniEditor.__printPreviewFile</h4> +<b>__printPreviewFile</b>(<i></i>) +<p> + Private slot to show a print preview of the text. +</p><a NAME="MiniEditor.__readSettings" ID="MiniEditor.__readSettings"></a> +<h4>MiniEditor.__readSettings</h4> +<b>__readSettings</b>(<i></i>) +<p> + Private method to read the settings remembered last time. +</p><a NAME="MiniEditor.__readShortcut" ID="MiniEditor.__readShortcut"></a> +<h4>MiniEditor.__readShortcut</h4> +<b>__readShortcut</b>(<i>act, category</i>) +<p> + Private function to read a single keyboard shortcut from the settings. +</p><dl> +<dt><i>act</i></dt> +<dd> +reference to the action object (E4Action) +</dd><dt><i>category</i></dt> +<dd> +category the action belongs to (string) +</dd><dt><i>prefClass</i></dt> +<dd> +preferences class used as the storage area +</dd> +</dl><a NAME="MiniEditor.__redo" ID="MiniEditor.__redo"></a> +<h4>MiniEditor.__redo</h4> +<b>__redo</b>(<i></i>) +<p> + Public method to redo the last recorded change. +</p><a NAME="MiniEditor.__replace" ID="MiniEditor.__replace"></a> +<h4>MiniEditor.__replace</h4> +<b>__replace</b>(<i></i>) +<p> + Private method to handle the replace action. +</p><a NAME="MiniEditor.__resetLanguage" ID="MiniEditor.__resetLanguage"></a> +<h4>MiniEditor.__resetLanguage</h4> +<b>__resetLanguage</b>(<i></i>) +<p> + Private method used to reset the language selection. +</p><a NAME="MiniEditor.__save" ID="MiniEditor.__save"></a> +<h4>MiniEditor.__save</h4> +<b>__save</b>(<i></i>) +<p> + Private slot to save a file. +</p><a NAME="MiniEditor.__saveAs" ID="MiniEditor.__saveAs"></a> +<h4>MiniEditor.__saveAs</h4> +<b>__saveAs</b>(<i></i>) +<p> + Private slot to save a file with a new name. +</p><a NAME="MiniEditor.__saveFile" ID="MiniEditor.__saveFile"></a> +<h4>MiniEditor.__saveFile</h4> +<b>__saveFile</b>(<i>fileName</i>) +<p> + Private method to save to the given file. +</p><dl> +<dt><i>fileName</i></dt> +<dd> +name of the file to save to (string) +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +flag indicating success (boolean) +</dd> +</dl><a NAME="MiniEditor.__search" ID="MiniEditor.__search"></a> +<h4>MiniEditor.__search</h4> +<b>__search</b>(<i></i>) +<p> + Private method to handle the search action. +</p><a NAME="MiniEditor.__searchClearMarkers" ID="MiniEditor.__searchClearMarkers"></a> +<h4>MiniEditor.__searchClearMarkers</h4> +<b>__searchClearMarkers</b>(<i></i>) +<p> + Private method to clear the search markers of the active window. +</p><a NAME="MiniEditor.__selectAll" ID="MiniEditor.__selectAll"></a> +<h4>MiniEditor.__selectAll</h4> +<b>__selectAll</b>(<i></i>) +<p> + Private slot handling the select all context menu action. +</p><a NAME="MiniEditor.__selectPygmentsLexer" ID="MiniEditor.__selectPygmentsLexer"></a> +<h4>MiniEditor.__selectPygmentsLexer</h4> +<b>__selectPygmentsLexer</b>(<i></i>) +<p> + Private method to select a specific pygments lexer. +</p><dl> +<dt>Returns:</dt> +<dd> +name of the selected pygments lexer (string) +</dd> +</dl><a NAME="MiniEditor.__setCurrentFile" ID="MiniEditor.__setCurrentFile"></a> +<h4>MiniEditor.__setCurrentFile</h4> +<b>__setCurrentFile</b>(<i>fileName</i>) +<p> + Private method to register the file name of the current file. +</p><dl> +<dt><i>fileName</i></dt> +<dd> +name of the file to register (string) +</dd> +</dl><a NAME="MiniEditor.__setEolMode" ID="MiniEditor.__setEolMode"></a> +<h4>MiniEditor.__setEolMode</h4> +<b>__setEolMode</b>(<i></i>) +<p> + Private method to configure the eol mode of the editor. +</p><a NAME="MiniEditor.__setMargins" ID="MiniEditor.__setMargins"></a> +<h4>MiniEditor.__setMargins</h4> +<b>__setMargins</b>(<i></i>) +<p> + Private method to configure the margins. +</p><a NAME="MiniEditor.__setMonospaced" ID="MiniEditor.__setMonospaced"></a> +<h4>MiniEditor.__setMonospaced</h4> +<b>__setMonospaced</b>(<i>on</i>) +<p> + Private method to set/reset a monospaced font. +</p><dl> +<dt><i>on</i></dt> +<dd> +flag to indicate usage of a monospace font (boolean) +</dd> +</dl><a NAME="MiniEditor.__setSbFile" ID="MiniEditor.__setSbFile"></a> +<h4>MiniEditor.__setSbFile</h4> +<b>__setSbFile</b>(<i>line = None, pos = None</i>) +<p> + Private method to set the file info in the status bar. +</p><dl> +<dt><i>line</i></dt> +<dd> +line number to display (int) +</dd><dt><i>pos</i></dt> +<dd> +character position to display (int) +</dd> +</dl><a NAME="MiniEditor.__setTextDisplay" ID="MiniEditor.__setTextDisplay"></a> +<h4>MiniEditor.__setTextDisplay</h4> +<b>__setTextDisplay</b>(<i></i>) +<p> + Private method to configure the text display. +</p><a NAME="MiniEditor.__showContextMenuLanguages" ID="MiniEditor.__showContextMenuLanguages"></a> +<h4>MiniEditor.__showContextMenuLanguages</h4> +<b>__showContextMenuLanguages</b>(<i></i>) +<p> + Private slot handling the aboutToShow signal of the languages context menu. +</p><a NAME="MiniEditor.__strippedName" ID="MiniEditor.__strippedName"></a> +<h4>MiniEditor.__strippedName</h4> +<b>__strippedName</b>(<i>fullFileName</i>) +<p> + Private method to return the filename part of the given path. +</p><dl> +<dt><i>fullFileName</i></dt> +<dd> +full pathname of the given file (string) +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +filename part (string) +</dd> +</dl><a NAME="MiniEditor.__styleNeeded" ID="MiniEditor.__styleNeeded"></a> +<h4>MiniEditor.__styleNeeded</h4> +<b>__styleNeeded</b>(<i>position</i>) +<p> + Private slot to handle the need for more styling. +</p><dl> +<dt><i>position</i></dt> +<dd> +end position, that needs styling (integer) +</dd> +</dl><a NAME="MiniEditor.__undo" ID="MiniEditor.__undo"></a> +<h4>MiniEditor.__undo</h4> +<b>__undo</b>(<i></i>) +<p> + Public method to undo the last recorded change. +</p><a NAME="MiniEditor.__whatsThis" ID="MiniEditor.__whatsThis"></a> +<h4>MiniEditor.__whatsThis</h4> +<b>__whatsThis</b>(<i></i>) +<p> + Private slot called in to enter Whats This mode. +</p><a NAME="MiniEditor.__writeSettings" ID="MiniEditor.__writeSettings"></a> +<h4>MiniEditor.__writeSettings</h4> +<b>__writeSettings</b>(<i></i>) +<p> + Private method to write the settings for reuse. +</p><a NAME="MiniEditor.activeWindow" ID="MiniEditor.activeWindow"></a> +<h4>MiniEditor.activeWindow</h4> +<b>activeWindow</b>(<i></i>) +<p> + Public method to fulfill the ViewManager interface. +</p><dl> +<dt>Returns:</dt> +<dd> +reference to the text edit component (QsciScintillaCompat) +</dd> +</dl><a NAME="MiniEditor.clearSearchIndicators" ID="MiniEditor.clearSearchIndicators"></a> +<h4>MiniEditor.clearSearchIndicators</h4> +<b>clearSearchIndicators</b>(<i></i>) +<p> + Public method to clear all search indicators. +</p><a NAME="MiniEditor.closeEvent" ID="MiniEditor.closeEvent"></a> +<h4>MiniEditor.closeEvent</h4> +<b>closeEvent</b>(<i>event</i>) +<p> + Public method to handle the close event. +</p><dl> +<dt><i>event</i></dt> +<dd> +close event (QCloseEvent) +</dd> +</dl><a NAME="MiniEditor.getFileName" ID="MiniEditor.getFileName"></a> +<h4>MiniEditor.getFileName</h4> +<b>getFileName</b>(<i></i>) +<p> + Public method to return the name of the file being displayed. +</p><dl> +<dt>Returns:</dt> +<dd> +filename of the displayed file (string) +</dd> +</dl><a NAME="MiniEditor.getLanguage" ID="MiniEditor.getLanguage"></a> +<h4>MiniEditor.getLanguage</h4> +<b>getLanguage</b>(<i></i>) +<p> + Public method to retrieve the language of the editor. +</p><dl> +<dt>Returns:</dt> +<dd> +language of the editor (string) +</dd> +</dl><a NAME="MiniEditor.getSRHistory" ID="MiniEditor.getSRHistory"></a> +<h4>MiniEditor.getSRHistory</h4> +<b>getSRHistory</b>(<i>key</i>) +<p> + Public method to get the search or replace history list. +</p><dl> +<dt><i>key</i></dt> +<dd> +list to return (must be 'search' or 'replace') +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +the requested history list (list of strings) +</dd> +</dl><a NAME="MiniEditor.readLine0" ID="MiniEditor.readLine0"></a> +<h4>MiniEditor.readLine0</h4> +<b>readLine0</b>(<i>fn, createIt = False</i>) +<p> + Public slot to read the first line from a file. +</p><dl> +<dt><i>fn</i></dt> +<dd> +filename to read from (string) +</dd><dt><i>createIt</i></dt> +<dd> +flag indicating the creation of a new file, if the given + one doesn't exist (boolean) +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +first line of the file (string) +</dd> +</dl><a NAME="MiniEditor.setLanguage" ID="MiniEditor.setLanguage"></a> +<h4>MiniEditor.setLanguage</h4> +<b>setLanguage</b>(<i>filename, initTextDisplay = True, pyname = ""</i>) +<p> + Public method to set a lexer language. +</p><dl> +<dt><i>filename</i></dt> +<dd> +filename used to determine the associated lexer language (string) +</dd><dt><i>initTextDisplay</i></dt> +<dd> +flag indicating an initialization of the text display + is required as well (boolean) +</dd><dt><i>pyname=</i></dt> +<dd> +name of the pygments lexer to use (string) +</dd> +</dl><a NAME="MiniEditor.setSearchIndicator" ID="MiniEditor.setSearchIndicator"></a> +<h4>MiniEditor.setSearchIndicator</h4> +<b>setSearchIndicator</b>(<i>startPos, indicLength</i>) +<p> + Public method to set a search indicator for the given range. +</p><dl> +<dt><i>startPos</i></dt> +<dd> +start position of the indicator (integer) +</dd><dt><i>indicLength</i></dt> +<dd> +length of the indicator (integer) +</dd> +</dl><a NAME="MiniEditor.setText" ID="MiniEditor.setText"></a> +<h4>MiniEditor.setText</h4> +<b>setText</b>(<i>txt, filetype = None</i>) +<p> + Public method to set the text programatically. +</p><dl> +<dt><i>txt</i></dt> +<dd> +text to be set (string) +</dd><dt><i>filetype</i></dt> +<dd> +type of the source file (string) +</dd> +</dl><a NAME="MiniEditor.textForFind" ID="MiniEditor.textForFind"></a> +<h4>MiniEditor.textForFind</h4> +<b>textForFind</b>(<i></i>) +<p> + Public method to determine the selection or the current word for the next + find operation. +</p><dl> +<dt>Returns:</dt> +<dd> +selection or current word (string) +</dd> +</dl> +<div align="right"><a href="#top">Up</a></div> +<hr /><hr /> +<a NAME="MiniScintilla" ID="MiniScintilla"></a> +<h2>MiniScintilla</h2> +<p> + Class implementing a QsciScintillaCompat subclass for handling focus events. +</p> +<h3>Derived from</h3> +QsciScintillaCompat +<h3>Class Attributes</h3> +<table> +<tr><td>None</td></tr> +</table> +<h3>Methods</h3> +<table> +<tr> +<td><a href="#MiniScintilla.__init__">MiniScintilla</a></td> +<td>Constructor</td> +</tr><tr> +<td><a href="#MiniScintilla.focusInEvent">focusInEvent</a></td> +<td>Protected method called when the editor receives focus.</td> +</tr><tr> +<td><a href="#MiniScintilla.focusOutEvent">focusOutEvent</a></td> +<td>Public method called when the editor loses focus.</td> +</tr><tr> +<td><a href="#MiniScintilla.getFileName">getFileName</a></td> +<td>Public method to return the name of the file being displayed.</td> +</tr> +</table> +<a NAME="MiniScintilla.__init__" ID="MiniScintilla.__init__"></a> +<h4>MiniScintilla (Constructor)</h4> +<b>MiniScintilla</b>(<i>parent = None</i>) +<p> + Constructor +</p><dl> +<dt><i>parent</i></dt> +<dd> +parent widget (QWidget) +</dd><dt><i>name</i></dt> +<dd> +name of this instance (string) +</dd><dt><i>flags</i></dt> +<dd> +window flags +</dd> +</dl><a NAME="MiniScintilla.focusInEvent" ID="MiniScintilla.focusInEvent"></a> +<h4>MiniScintilla.focusInEvent</h4> +<b>focusInEvent</b>(<i>event</i>) +<p> + Protected method called when the editor receives focus. +</p><p> + This method checks for modifications of the current file and + rereads it upon request. The cursor is placed at the current position + assuming, that it is in the vicinity of the old position after the reread. +</p><dl> +<dt><i>event</i></dt> +<dd> +the event object (QFocusEvent) +</dd> +</dl><a NAME="MiniScintilla.focusOutEvent" ID="MiniScintilla.focusOutEvent"></a> +<h4>MiniScintilla.focusOutEvent</h4> +<b>focusOutEvent</b>(<i>event</i>) +<p> + Public method called when the editor loses focus. +</p><dl> +<dt><i>event</i></dt> +<dd> +the event object (QFocusEvent) +</dd> +</dl><a NAME="MiniScintilla.getFileName" ID="MiniScintilla.getFileName"></a> +<h4>MiniScintilla.getFileName</h4> +<b>getFileName</b>(<i></i>) +<p> + Public method to return the name of the file being displayed. +</p><dl> +<dt>Returns:</dt> +<dd> +filename of the displayed file (string) +</dd> +</dl> +<div align="right"><a href="#top">Up</a></div> +<hr /> +</body></html> \ No newline at end of file