# eric3.Preferences.ConfigurationDialog

Module implementing a dialog for the configuration of eric3.

### Classes

ConfigurationDialog | Class implementing a dialog for the configuration of eric3.

### Functions

None

## ConfigurationDialog

Class implementing a dialog for the configuration of eric3.

### Derived from

ConfigurationForm

### Methods

ConfigurationDialog | Constructor
enableStyleList | Private method to enable/disable the style list and related widgets.
getApisFromListBox | Private slot to retrieve the api filenames from the listbox.
handleAllBackgroundColours | Private method used to select the background colour of all styles of a selected lexer.
handleAllFonts | Private method used to change the font of all styles of a selected lexer.
handleApiFile | Private method to select an api file.
handleApiFileAdd | Private slot to add the api file displayed to the listbox.
handleApiFileDelete | Private slot to delete the currently selected file of the listbox.
handleApiLanguageSelected | Private slot to fill the api listbox of the api page.
handleBackgroundColour | Private method used to select the background colour of the selected style and lexer.
handleCallTipsBackgroundColour | Private slot to set the background colour for calltips.
handleCaretForegroundColour | Private slot to set the foreground colour of the caret.
handleCaretlineBackgroundColour | Private slot to set the background colour of the caretline.
handleConfigPageSelected | Private slot to handle the selection of a new config page.
handleCurrentLineColour | Private slot to set the colour for the highlight of the current line.
handleCustomViewerSelection | Private slot to handle the custom viewer selection.
handleDebugClientSelection | Private slot to handle the Debug Client selection.
handleEdgeColour | Private slot to set the colour for the edge background or line.
handleEolFill | Private method used to set the eolfill for the selected style and lexer.
handleErrorLineColour | Private slot to set the colour for the highlight of the error line.
handleFont | Private method used to select the font of the selected style and lexer.
handleForegroundColour | Private method used to select the foreground colour of the selected style and lexer.
handleHeaderFont | Private method used to select the font for the page header.
handleIconDirectory | Private slot to select an icon directory.
handleIconDirectoryAdd | Private slot to add the icon directory displayed to the listbox.
handleIconDirectoryDelete | Private slot to delete the currently selected directory of the listbox.
handleIdlSelection | Private slot to handle the IDL compiler selection.
handleLayoutReset | Private method to reset layout to factory defaults
handleLayoutSelected | Private slot to handle the layout selected signal of the layout combo.
handleLexerAdd | Private slot to add the lexer association displayed to the listbox.
handleLexerAssocSelected | Private slot to handle the clicked signal of the lexer association list.
handleLexerDelete | Private slot to delete the currently selected lexer association of the listbox.
handleLexerSelected | Private slot to fill the style combo of the source page.
handleLinenumbersFont | Private method used to select the font for the editor margins.
handleMatchingBracesBackColour | Private slot to set the background colour for highlighting matching braces.
handleMatchingBracesColour | Private slot to set the colour for highlighting matching braces.
handleMonospacedFont | Private method used to select the font to be used as the monospaced font.
handleNonMatchingBracesBackColour | Private slot to set the background colour for highlighting nonmatching braces.
handleNonMatchingBracesColour | Private slot to set the colour for highlighting nonmatching braces.
handlePdfviewerSelection | Private slot to handle the PDF viewer selection.
handlePythonDocDirSelection | Private slot to select the Python documentation directory.
handlePythonInterpreterSelection | Private slot to handle the Python interpreter selection.
handleQtDirEntered | Private slot to handle a change in the entered Qt directory.
handleQtDirSelection | Private slot to handle the Qt directory selection.
handleQtDocDirSelection | Private slot to select the Qt documentation directory.
handleRubyInterpreterSelection | Private slot to handle the Ruby interpreter selection.
handleShowIconsPreview | Private slot to display a preview of an icons directory.
handleStyleSelected | Private method to set up the style element part of the source page.
handleTasksBgColour | Private slot to set the background colour for global tasks.
handleTasksBugfixFgColour | Private slot to set the colour for bugfix tasks.
handleTasksFgColour | Private slot to set the colour for standard tasks.
handleTasksProjectBgColour | Private slot to set the backgroundcolour for project tasks.
handleUseTabs | Private slot used to set the tab conversion check box.
handleWebbrowserSelection | Private slot to handle the Web browser selection.
handleWorkspacePreview | Private slot to show a preview of the selected workspace view type.
initApplicationPage | Private method to initialize the application page.
initDebuggerPages | Private method to initialize the debugger pages.
initEditorPages | Private method to initialize the editor pages.
initHelpPage | Private method to initialize the help page.
initIconsPage | Private method to initialize the icons page.
initInterfacePage | Private method to initialize the interface and viewmanager page.
initLanguageCombo | Private method to initialize the language combobox of the interface page.
initPrinterPage | Private method to initialize the printer page.
initProjectPage | Private method to initialize the project page.
initTasksPage | Private method to initialize the tasks page.
initTemplatesPage | Private method to initialize the templates page.
initVariousPages | Private method to initialize the various pages.
initWindowViewCombo | Private method to initialize the window view combobox of the interface page.
moveIconDirectoryDown | Private slot called to move the selected item down in the list.
moveIconDirectoryUp | Private slot called to move the selected item up in the list.
selectColour | Private method used by the buttons selecting the marker colours.
selectTasksColour | Private method used by the buttons selecting the tasks colours.
setPreferences | Public method called to store the selected values into the preferences storage.

### ConfigurationDialog (Constructor)

ConfigurationDialog(parent = None, name = None, modal = 0, fl = 0)

Constructor

parent
  The parent widget of this dialog. (QWidget)
name
  The name of this dialog. (QString)
modal
  Flag indicating a modal dialog. (boolean)
fl
  The window flags.

### ConfigurationDialog.enableStyleList

enableStyleList(b)

Private method to enable/disable the style list and related widgets.

b
  Flag indicatin enabled or disabled state.

### ConfigurationDialog.getApisFromListBox

getApisFromListBox()

Private slot to retrieve the api filenames from the listbox. Returns list of api filenames (QStringList)

### ConfigurationDialog.handleAllBackgroundColours

handleAllBackgroundColours()

Private method used to select the background colour of all styles of a selected lexer.

### ConfigurationDialog.handleAllFonts

handleAllFonts()

Private method used to change the font of all styles of a selected lexer.

### ConfigurationDialog.handleApiFile

handleApiFile()

Private method to select an api file.

### ConfigurationDialog.handleApiFileAdd

handleApiFileAdd()

Private slot to add the api file displayed to the listbox.

### ConfigurationDialog.handleApiFileDelete

handleApiFileDelete()

Private slot to delete the currently selected file of the listbox.

### ConfigurationDialog.handleApiLanguageSelected

handleApiLanguageSelected(language)

Private slot to fill the api listbox of the api page.

language
  The selecte API language. (QString)

### ConfigurationDialog.handleBackgroundColour

handleBackgroundColour()

Private method used to select the background colour of the selected style and lexer.

### ConfigurationDialog.handleCallTipsBackgroundColour

handleCallTipsBackgroundColour()

Private slot to set the background colour for calltips.

### ConfigurationDialog.handleCaretForegroundColour

handleCaretForegroundColour()

Private slot to set the foreground colour of the caret.

### ConfigurationDialog.handleCaretlineBackgroundColour

handleCaretlineBackgroundColour()

Private slot to set the background colour of the caretline.

### ConfigurationDialog.handleConfigPageSelected

handleConfigPageSelected(itm)

Private slot to handle the selection of a new config page.

itm
  reference to the selected list view item (QListViewItem)

### ConfigurationDialog.handleCurrentLineColour

handleCurrentLineColour()

Private slot to set the colour for the highlight of the current line.

### ConfigurationDialog.handleCustomViewerSelection

handleCustomViewerSelection()

Private slot to handle the custom viewer selection.

### ConfigurationDialog.handleDebugClientSelection

handleDebugClientSelection()

Private slot to handle the Debug Client selection.

### ConfigurationDialog.handleEdgeColour

handleEdgeColour()

Private slot to set the colour for the edge background or line.

### ConfigurationDialog.handleEolFill

handleEolFill(b)

Private method used to set the eolfill for the selected style and lexer.

b
  Flag indicating enabled or disabled state.

### ConfigurationDialog.handleErrorLineColour

handleErrorLineColour()

Private slot to set the colour for the highlight of the error line.

### ConfigurationDialog.handleFont

handleFont()

Private method used to select the font of the selected style and lexer.

### ConfigurationDialog.handleForegroundColour

handleForegroundColour()

Private method used to select the foreground colour of the selected style and lexer.

### ConfigurationDialog.handleHeaderFont

handleHeaderFont()

Private method used to select the font for the page header.

### ConfigurationDialog.handleIconDirectory

handleIconDirectory()

Private slot to select an icon directory.

### ConfigurationDialog.handleIconDirectoryAdd

handleIconDirectoryAdd()

Private slot to add the icon directory displayed to the listbox.

### ConfigurationDialog.handleIconDirectoryDelete

handleIconDirectoryDelete()

Private slot to delete the currently selected directory of the listbox.

### ConfigurationDialog.handleIdlSelection

handleIdlSelection()

Private slot to handle the IDL compiler selection.

### ConfigurationDialog.handleLayoutReset

handleLayoutReset()

Private method to reset layout to factory defaults

### ConfigurationDialog.handleLayoutSelected

handleLayoutSelected(layout)

Private slot to handle the layout selected signal of the layout combo.

layout
  number of the selected layout

### ConfigurationDialog.handleLexerAdd

handleLexerAdd()

Private slot to add the lexer association displayed to the listbox.

### ConfigurationDialog.handleLexerAssocSelected

handleLexerAssocSelected(itm)

Private slot to handle the clicked signal of the lexer association list.

itm
  reference to the selecte item (QListViewItem)

### ConfigurationDialog.handleLexerDelete

handleLexerDelete()

Private slot to delete the currently selected lexer association of the listbox.

### ConfigurationDialog.handleLexerSelected

handleLexerSelected(language)

Private slot to fill the style combo of the source page.

language
  The lexer language (string or QString)

### ConfigurationDialog.handleLinenumbersFont

handleLinenumbersFont()

Private method used to select the font for the editor margins.

### ConfigurationDialog.handleMatchingBracesBackColour

handleMatchingBracesBackColour()

Private slot to set the background colour for highlighting matching braces.

### ConfigurationDialog.handleMatchingBracesColour

handleMatchingBracesColour()

Private slot to set the colour for highlighting matching braces.

### ConfigurationDialog.handleMonospacedFont

handleMonospacedFont()

Private method used to select the font to be used as the monospaced font.

### ConfigurationDialog.handleNonMatchingBracesBackColour

handleNonMatchingBracesBackColour()

Private slot to set the background colour for highlighting nonmatching braces.

### ConfigurationDialog.handleNonMatchingBracesColour

handleNonMatchingBracesColour()

Private slot to set the colour for highlighting nonmatching braces.

### ConfigurationDialog.handlePdfviewerSelection

handlePdfviewerSelection()

Private slot to handle the PDF viewer selection.

### ConfigurationDialog.handlePythonDocDirSelection

handlePythonDocDirSelection()

Private slot to select the Python documentation directory.

### ConfigurationDialog.handlePythonInterpreterSelection

handlePythonInterpreterSelection()

Private slot to handle the Python interpreter selection.

### ConfigurationDialog.handleQtDirEntered

handleQtDirEntered(dir)

Private slot to handle a change in the entered Qt directory.

dir
  the entered string (QString)

### ConfigurationDialog.handleQtDirSelection

handleQtDirSelection()

Private slot to handle the Qt directory selection.

### ConfigurationDialog.handleQtDocDirSelection

handleQtDocDirSelection()

Private slot to select the Qt documentation directory.

### ConfigurationDialog.handleRubyInterpreterSelection

handleRubyInterpreterSelection()

Private slot to handle the Ruby interpreter selection.

### ConfigurationDialog.handleShowIconsPreview

handleShowIconsPreview()

Private slot to display a preview of an icons directory.

### ConfigurationDialog.handleStyleSelected

handleStyleSelected(index)

Private method to set up the style element part of the source page.

index
  the style index.

### ConfigurationDialog.handleTasksBgColour

handleTasksBgColour()

Private slot to set the background colour for global tasks.

### ConfigurationDialog.handleTasksBugfixFgColour

handleTasksBugfixFgColour()

Private slot to set the colour for bugfix tasks.

### ConfigurationDialog.handleTasksFgColour

handleTasksFgColour()

Private slot to set the colour for standard tasks.

### ConfigurationDialog.handleTasksProjectBgColour

handleTasksProjectBgColour()

Private slot to set the backgroundcolour for project tasks.

### ConfigurationDialog.handleUseTabs

handleUseTabs(checked)

Private slot used to set the tab conversion check box.

checked
  flag received from the signal (boolean)

### ConfigurationDialog.handleWebbrowserSelection

handleWebbrowserSelection()

Private slot to handle the Web browser selection.

### ConfigurationDialog.handleWorkspacePreview

handleWorkspacePreview(workspace)

Private slot to show a preview of the selected workspace view type.

workspace
  Workspace view type. (string or QString)

### ConfigurationDialog.initApplicationPage

initApplicationPage()

Private method to initialize the application page.

### ConfigurationDialog.initDebuggerPages

initDebuggerPages()

Private method to initialize the debugger pages.

### ConfigurationDialog.initEditorPages

initEditorPages()

Private method to initialize the editor pages.

### ConfigurationDialog.initHelpPage

initHelpPage()

Private method to initialize the help page.

### ConfigurationDialog.initIconsPage

initIconsPage()

Private method to initialize the icons page.

### ConfigurationDialog.initInterfacePage

initInterfacePage()

Private method to initialize the interface and viewmanager page.

### ConfigurationDialog.initLanguageCombo

initLanguageCombo()

Private method to initialize the language combobox of the interface page.

### ConfigurationDialog.initPrinterPage

initPrinterPage()

Private method to initialize the printer page.

### ConfigurationDialog.initProjectPage

initProjectPage()

Private method to initialize the project page.

### ConfigurationDialog.initTasksPage

initTasksPage()

Private method to initialize the tasks page.

### ConfigurationDialog.initTemplatesPage

initTemplatesPage()

Private method to initialize the templates page.

### ConfigurationDialog.initVariousPages

initVariousPages()

Private method to initialize the various pages.

### ConfigurationDialog.initWindowViewCombo

initWindowViewCombo()

Private method to initialize the window view combobox of the interface page.

### ConfigurationDialog.moveIconDirectoryDown

moveIconDirectoryDown()

Private slot called to move the selected item down in the list.

### ConfigurationDialog.moveIconDirectoryUp

moveIconDirectoryUp()

Private slot called to move the selected item up in the list.

### ConfigurationDialog.selectColour

selectColour(colourstr, button)

Private method used by the buttons selecting the marker colours.

colourstr
  Colour to be set. (string)
button
  Reference to a QButton to show the colour on.

### ConfigurationDialog.selectTasksColour

selectTasksColour(colourstr, button)

Private method used by the buttons selecting the tasks colours.

colourstr
  Colour to be set. (string)
button
  Reference to a QButton to show the colour on.

### ConfigurationDialog.setPreferences

setPreferences()

Public method called to store the selected values into the preferences storage.

Up