psychopy 2024.2.1__py3-none-any.whl → 2024.2.4__py3-none-any.whl

psychopy/app/builder/dialogs/paramCtrls.py.orig

@@ -0,0 +1,713 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Part of the PsychoPy library
+# Copyright (C) 2002-2018 Jonathan Peirce (C) 2019-2022 Open Science Tools Ltd.
+# Distributed under the terms of the GNU General Public License (GPL).
+
+import os
+import subprocess
+import sys
+
+import wx
+
+from psychopy.app.colorpicker import PsychoColorPicker
+from psychopy.app.dialogs import ListWidget
+from psychopy.colors import Color
+from psychopy.localization import _translate
+from psychopy import data, prefs, experiment
+import re
+from pathlib import Path
+
+from ..localizedStrings import _localizedDialogs as _localized
+from ...themes import icons
+
+
+class _ValidatorMixin:
+    def validate(self, evt=None):
+        """Redirect validate calls to global validate method, assigning
+        appropriate `valType`.
+        """
+        validate(self, self.valType)
+
+        if evt is not None:
+            evt.Skip()
+
+    def showValid(self, valid):
+        """Style input box according to valid"""
+        if not hasattr(self, "SetForegroundColour"):
+            return
+
+        if valid:
+            self.SetForegroundColour(wx.Colour(0, 0, 0))
+        else:
+            self.SetForegroundColour(wx.Colour(1, 0, 0))
+
+    def updateCodeFont(self, valType):
+        """Style input box according to code wanted"""
+        if not hasattr(self, "SetFont"):
+            # Skip if font not applicable to object type
+            return
+        if self.GetName() == "name":
+            # Name is never code
+            valType = "str"
+
+        fontNormal = self.GetTopLevelParent().app._mainFont
+        if valType == "code" or hasattr(self, "dollarLbl"):
+            # Set font
+            fontCode = self.GetTopLevelParent().app._codeFont
+            fontCodeBold = fontCode.Bold()
+            if fontCodeBold.IsOk():
+                self.SetFont(fontCodeBold)
+            else:
+                # use normal font if the bold version is invalid on the system
+                self.SetFont(fontCode)
+        else:
+            self.SetFont(fontNormal)
+
+
+class _FileMixin:
+    @property
+    def rootDir(self):
+        if not hasattr(self, "_rootDir"):
+            # Store location of root directory if not defined
+            self._rootDir = Path(self.GetTopLevelParent().frame.exp.filename)
+            if self._rootDir.is_file():
+                # Move up a dir if root is a file
+                self._rootDir = self._rootDir.parent
+        # Return stored rootDir
+        return self._rootDir
+    @rootDir.setter
+    def rootDir(self, value):
+        self._rootDir = value
+
+    def getFile(self, msg="Specify file ...", wildcard="All Files (*.*)|*.*"):
+        dlg = wx.FileDialog(self, message=_translate(msg), defaultDir=str(self.rootDir),
+                            style=wx.FD_OPEN | wx.FD_FILE_MUST_EXIST,
+                            wildcard=_translate(wildcard))
+        if dlg.ShowModal() != wx.ID_OK:
+            return
+        file = dlg.GetPath()
+        try:
+            filename = Path(file).relative_to(self.rootDir)
+        except ValueError:
+            filename = Path(file).absolute()
+        return str(filename).replace("\\", "/")
+
+    def getFiles(self, msg="Specify file or files...", wildcard="All Files (*.*)|*.*"):
+        dlg = wx.FileDialog(self, message=_translate(msg), defaultDir=str(self.rootDir),
+                            style=wx.FD_OPEN | wx.FD_FILE_MUST_EXIST | wx.FD_MULTIPLE,
+                            wildcard=_translate(wildcard))
+        if dlg.ShowModal() != wx.ID_OK:
+            return
+        inList = dlg.GetPaths()
+        outList = []
+        for file in inList:
+            try:
+                filename = Path(file).relative_to(self.rootDir)
+            except ValueError:
+                filename = Path(file).absolute()
+            outList.append(str(filename).replace("\\", "/"))
+        return outList
+
+
+class _HideMixin:
+    def ShowAll(self, visible):
+        # Get sizer, if present
+        if hasattr(self, "_szr"):
+            sizer = self._szr
+        elif isinstance(self, DictCtrl):
+            sizer = self
+        else:
+            sizer = self.GetSizer()
+        # If there is a sizer, recursively hide children
+        if sizer is not None:
+            self.tunnelShow(sizer, visible)
+        else:
+            self.Show(visible)
+
+    def HideAll(self):
+        self.Show(False)
+
+    def tunnelShow(self, sizer, visible):
+        if sizer is not None:
+            # Show/hide everything in the sizer
+            for child in sizer.Children:
+                if child.Window is not None:
+                    child.Window.Show(visible)
+                if child.Sizer is not None:
+                    # If child is a sizer, recur
+                    self.tunnelShow(child.Sizer, visible)
+
+
+class SingleLineCtrl(wx.TextCtrl, _ValidatorMixin, _HideMixin):
+    def __init__(self, parent, valType,
+                 val="", fieldName="",
+                 size=wx.Size(-1, 24), style=wx.DEFAULT):
+        # Create self
+        wx.TextCtrl.__init__(self)
+        self.Create(parent, -1, val, name=fieldName, size=size, style=style)
+        self.valType = valType
+
+        # On MacOS, we need to disable smart quotes
+        if sys.platform == 'darwin':
+            self.OSXDisableAllSmartSubstitutions()
+
+        # Add sizer
+        self._szr = wx.BoxSizer(wx.HORIZONTAL)
+        if not valType == "str" and not fieldName == "name":
+            # Add $ for anything to be interpreted verbatim
+            self.dollarLbl = wx.StaticText(parent, -1, "$", size=wx.Size(-1, -1), style=wx.ALIGN_RIGHT)
+            self.dollarLbl.SetToolTip(_translate("This parameter will be treated as code - we have already put in the $, so you don't have to."))
+            self._szr.Add(self.dollarLbl, border=5, flag=wx.ALIGN_CENTER_VERTICAL | wx.RIGHT | wx.LEFT)
+        # Add self to sizer
+        self._szr.Add(self, proportion=1, border=5, flag=wx.EXPAND)
+        # Bind to validation
+        self.Bind(wx.EVT_CHAR, self.validate)
+        self.validate()
+
+    def Show(self, value=True):
+        wx.TextCtrl.Show(self, value)
+        if hasattr(self, "dollarLbl"):
+            self.dollarLbl.Show(value)
+        if hasattr(self, "deleteBtn"):
+            self.deleteBtn.Show(value)
+
+
+class MultiLineCtrl(SingleLineCtrl, _ValidatorMixin, _HideMixin):
+    def __init__(self, parent, valType,
+                 val="", fieldName="",
+                 size=wx.Size(-1, 144)):
+        SingleLineCtrl.__init__(self, parent, valType,
+                                val=val, fieldName=fieldName,
+                                size=size, style=wx.TE_MULTILINE)
+
+
+class InvalidCtrl(SingleLineCtrl, _ValidatorMixin, _HideMixin):
+    def __init__(self, parent, valType,
+                 val="", fieldName="",
+                 size=wx.Size(-1, 24), style=wx.DEFAULT):
+        SingleLineCtrl.__init__(self, parent, valType,
+                                val=val, fieldName=fieldName,
+                                size=size, style=style)
+        self.Disable()
+        # Add delete button
+        self.deleteBtn = wx.Button(parent, label="×", size=(24, 24))
+        self.deleteBtn.SetForegroundColour("red")
+        self.deleteBtn.Bind(wx.EVT_BUTTON, self.deleteParam)
+        self.deleteBtn.SetToolTip(_translate(
+            "This parameter has come from an older version of PsychoPy. "
+            "In the latest version of PsychoPy, it is not used. Click this "
+            "button to delete it. WARNING: This may affect how this experiment "
+            "works in older versions!"))
+        self._szr.Add(self.deleteBtn, border=6, flag=wx.LEFT | wx.RIGHT)
+        # Add deleted label
+        self.deleteLbl = wx.StaticText(parent, label=_translate("DELETED"))
+        self.deleteLbl.SetForegroundColour("red")
+        self.deleteLbl.Hide()
+        self._szr.Add(self.deleteLbl, border=6, proportion=1, flag=wx.ALL | wx.ALIGN_CENTER_VERTICAL)
+        # Add undo delete button
+        self.undoBtn = wx.Button(parent, label="⟲", size=(24, 24))
+        self.undoBtn.SetToolTip(_translate(
+            "This parameter will not be deleted until you click Okay. "
+            "Click this button to revert the deletion and keep the parameter."))
+        self.undoBtn.Hide()
+        self.undoBtn.Bind(wx.EVT_BUTTON, self.undoDelete)
+        self._szr.Add(self.undoBtn, border=6, flag=wx.LEFT | wx.RIGHT)
+
+        # Set deletion flag
+        self.forDeletion = False
+
+    def deleteParam(self, evt=None):
+        """
+        When the remove button is pressed, mark this param as for deletion
+        """
+        # Mark for deletion
+        self.forDeletion = True
+        # Hide value ctrl and delete button
+        self.Hide()
+        self.deleteBtn.Hide()
+        # Show delete label and
+        self.undoBtn.Show()
+        self.deleteLbl.Show()
+
+        self._szr.Layout()
+
+    def undoDelete(self, evt=None):
+        # Mark not for deletion
+        self.forDeletion = False
+        # Show value ctrl and delete button
+        self.Show()
+        self.deleteBtn.Show()
+        # Hide delete label and
+        self.undoBtn.Hide()
+        self.deleteLbl.Hide()
+
+        self._szr.Layout()
+
+
+class IntCtrl(wx.SpinCtrl, _ValidatorMixin, _HideMixin):
+    def __init__(self, parent, valType,
+                 val="", fieldName="",
+                 size=wx.Size(-1, 24), limits=None):
+        wx.SpinCtrl.__init__(self)
+        limits = limits or (-100,100)
+        self.Create(parent, -1, str(val), name=fieldName, size=size, min=min(limits), max=max(limits))
+        self.valType = valType
+        self.Bind(wx.EVT_SPINCTRL, self.spin)
+
+    def spin(self, evt):
+        """Redirect validate calls to global validate method, assigning appropriate valType"""
+        if evt.EventType == wx.EVT_SPIN_UP.evtType[0]:
+            self.SetValue(str(int(self.GetValue())+1))
+        elif evt.EventType == wx.EVT_SPIN_DOWN.evtType[0]:
+            self.SetValue(str(int(self.GetValue()) - 1))
+        validate(self, "int")
+
+
+BoolCtrl = wx.CheckBox
+
+
+class ChoiceCtrl(wx.Choice, _ValidatorMixin, _HideMixin):
+    def __init__(self, parent, valType,
+                 val="", choices=[], labels=[], fieldName="",
+                 size=wx.Size(-1, 24)):
+<<<<<<< HEAD
+        # If not given any labels, alias values
+        if not labels:
+            labels = choices
+        # Map labels to values
+        self._choices = {}
+        for i, value in enumerate(choices):
+            if i < len(labels):
+                self._choices[labels[i]] = value
+            else:
+                self._choices[value] = value
+=======
+        # translate and add labels to the dropdown
+        choiceLabels = []
+        for i, value in enumerate(choices):
+            if i < len(labels):
+                label = labels[i]
+            else:
+                label = value
+            try:
+                choiceLabels.append(_localized[label])
+            except:
+                choiceLabels.append(label)
+
+>>>>>>> e32726e790e8485ee63b1419cb6e567f086836b9
+        # Create choice ctrl from labels
+        wx.Choice.__init__(self)
+        self.Create(parent, -1, size=size, choices=list(self._choices), name=fieldName)
+        self.valType = valType
+        self.SetStringSelection(val)
+
+    def SetStringSelection(self, string):
+        if string not in self._choices:
+<<<<<<< HEAD
+            self._choices[string] = string
+            self.SetItems(list(self._choices))
+        wx.Choice.SetStringSelection(self, string)
+
+    def GetValue(self):
+        lbl = self.GetStringSelection()
+        return self._choices[lbl]
+=======
+            self._choices.append(string)
+            self.SetItems(self._choices)
+        # Don't use wx.Choice.SetStringSelection here
+        # because label string is localized.
+        wx.Choice.SetSelection(self, self._choices.index(string))
+    
+    def GetValue(self):
+        # Don't use wx.Choice.GetStringSelection here
+        # because label string is localized.
+        return self._choices[self.GetSelection()]
+
+>>>>>>> e32726e790e8485ee63b1419cb6e567f086836b9
+
+
+class MultiChoiceCtrl(wx.CheckListBox, _ValidatorMixin, _HideMixin):
+    def __init__(self, parent, valType,
+                 vals="", choices=[], fieldName="",
+                 size=wx.Size(-1, -1)):
+        wx.CheckListBox.__init__(self)
+        self.Create(parent, id=wx.ID_ANY, size=size, choices=choices, name=fieldName, style=wx.LB_MULTIPLE)
+        self.valType = valType
+        self._choices = choices
+        # Make initial selection
+        if isinstance(vals, str):
+            # Convert to list if needed
+            vals = data.utils.listFromString(vals, excludeEmpties=True)
+        self.SetCheckedStrings(vals)
+        self.validate()
+
+    def SetCheckedStrings(self, strings):
+        if not isinstance(strings, (list, tuple)):
+            strings = [strings]
+        for s in strings:
+            if s not in self._choices:
+                self._choices.append(s)
+                self.SetItems(self._choices)
+        wx.CheckListBox.SetCheckedStrings(self, strings)
+
+    def GetValue(self, evt=None):
+        return self.GetCheckedStrings()
+
+
+class FileCtrl(wx.TextCtrl, _ValidatorMixin, _HideMixin, _FileMixin):
+    def __init__(self, parent, valType,
+                 val="", fieldName="",
+                 size=wx.Size(-1, 24)):
+        # Create self
+        wx.TextCtrl.__init__(self)
+        self.Create(parent, -1, val, name=fieldName, size=size)
+        self.valType = valType
+        # Add sizer
+        self._szr = wx.BoxSizer(wx.HORIZONTAL)
+        self._szr.Add(self, border=5, proportion=1, flag=wx.EXPAND | wx.RIGHT)
+        # Add button to browse for file
+        fldr = icons.ButtonIcon(stem="folder", size=16).bitmap
+        self.findBtn = wx.BitmapButton(parent, -1, size=wx.Size(24, 24), bitmap=fldr)
+        self.findBtn.SetToolTip(_translate("Specify file ..."))
+        self.findBtn.Bind(wx.EVT_BUTTON, self.findFile)
+        self._szr.Add(self.findBtn)
+        # Configure validation
+        self.Bind(wx.EVT_TEXT, self.validate)
+        self.validate()
+
+    def findFile(self, evt):
+        file = self.getFile()
+        if file:
+            self.SetValue(file)
+            self.validate(evt)
+
+
+class FileListCtrl(wx.ListBox, _ValidatorMixin, _HideMixin, _FileMixin):
+    def __init__(self, parent, valType,
+                 choices=[], size=None, pathtype="rel"):
+        wx.ListBox.__init__(self)
+        self.valType = valType
+        parent.Bind(wx.EVT_DROP_FILES, self.addItem)
+        self.app = parent.app
+        if type(choices) == str:
+            choices = data.utils.listFromString(choices)
+        self.Create(id=wx.ID_ANY, parent=parent, choices=choices, size=size, style=wx.LB_EXTENDED | wx.LB_HSCROLL)
+        self.addCustomBtn = wx.Button(parent, -1, size=(24,24), style=wx.BU_EXACTFIT, label="...")
+        self.addCustomBtn.Bind(wx.EVT_BUTTON, self.addCustomItem)
+        self.addBtn = wx.Button(parent, -1, size=(24,24), style=wx.BU_EXACTFIT, label="+")
+        self.addBtn.Bind(wx.EVT_BUTTON, self.addItem)
+        self.subBtn = wx.Button(parent, -1, size=(24,24), style=wx.BU_EXACTFIT, label="-")
+        self.subBtn.Bind(wx.EVT_BUTTON, self.removeItem)
+        self._szr = wx.BoxSizer(wx.HORIZONTAL)
+        self.btns = wx.BoxSizer(wx.VERTICAL)
+        self.btns.AddMany((self.addCustomBtn, self.addBtn, self.subBtn))
+        self._szr.Add(self, proportion=1, flag=wx.EXPAND)
+        self._szr.Add(self.btns)
+
+    def addItem(self, event):
+        # Get files
+        if event.GetEventObject() == self.addBtn:
+            fileList = self.getFiles()
+        else:
+            fileList = event.GetFiles()
+            for i, filename in enumerate(fileList):
+                try:
+                    fileList[i] = Path(filename).relative_to(self.rootDir)
+                except ValueError:
+                    fileList[i] = Path(filename).absolute()
+        # Add files to list
+        if fileList:
+            self.InsertItems(fileList, 0)
+
+    def removeItem(self, event):
+        i = self.GetSelections()
+        if isinstance(i, int):
+            i = [i]
+        items = [item for index, item in enumerate(self.Items)
+                 if index not in i]
+        self.SetItems(items)
+
+    def addCustomItem(self, event):
+        # Create string dialog
+        dlg = wx.TextEntryDialog(parent=self, message=_translate("Add custom item"))
+        # Show dialog
+        if dlg.ShowModal() != wx.ID_OK:
+            return
+        # Get string
+        stringEntry = dlg.GetValue()
+        # Add to list
+        if stringEntry:
+            self.InsertItems([stringEntry], 0)
+
+    def GetValue(self):
+        return self.Items
+
+
+class TableCtrl(wx.TextCtrl, _ValidatorMixin, _HideMixin, _FileMixin):
+    def __init__(self, parent, valType,
+                 val="", fieldName="",
+                 size=wx.Size(-1, 24)):
+        # Create self
+        wx.TextCtrl.__init__(self)
+        self.Create(parent, -1, val, name=fieldName, size=size)
+        self.valType = valType
+        # Add sizer
+        self._szr = wx.BoxSizer(wx.HORIZONTAL)
+        self._szr.Add(self, proportion=1, border=5, flag=wx.EXPAND | wx.RIGHT)
+        # Add button to browse for file
+        fldr = icons.ButtonIcon(stem="folder", size=16).bitmap
+        self.findBtn = wx.BitmapButton(parent, -1, size=wx.Size(24,24), bitmap=fldr)
+        self.findBtn.SetToolTip(_translate("Specify file ..."))
+        self.findBtn.Bind(wx.EVT_BUTTON, self.findFile)
+        self._szr.Add(self.findBtn)
+        # Add button to open in Excel
+        xl = icons.ButtonIcon(stem="filecsv", size=16).bitmap
+        self.xlBtn = wx.BitmapButton(parent, -1, size=wx.Size(24,24), bitmap=xl)
+        self.xlBtn.SetToolTip(_translate("Open/create in your default table editor"))
+        self.xlBtn.Bind(wx.EVT_BUTTON, self.openExcel)
+        self._szr.Add(self.xlBtn)
+        # Link to Excel templates for certain contexts
+        cmpRoot = Path(experiment.components.__file__).parent
+        expRoot = Path(cmpRoot).parent
+        self.templates = {
+            'Form': Path(cmpRoot) / "form" / "formItems.xltx",
+            'TrialHandler': Path(expRoot) / "loopTemplate.xltx",
+            'StairHandler': Path(expRoot) / "loopTemplate.xltx",
+            'MultiStairHandler': Path(expRoot) / "loopTemplate.xltx",
+            'QuestHandler': Path(expRoot) / "loopTemplate.xltx",
+            'None': Path(expRoot) / 'blankTemplate.xltx',
+        }
+        # Specify valid extensions
+        self.validExt = [".csv",".tsv",".txt",
+                         ".xl",".xlsx",".xlsm",".xlsb",".xlam",".xltx",".xltm",".xls",".xlt",
+                         ".htm",".html",".mht",".mhtml",
+                         ".xml",".xla",".xlm",
+                         ".odc",".ods",
+                         ".udl",".dsn",".mdb",".mde",".accdb",".accde",".dbc",".dbf",
+                         ".iqy",".dqy",".rqy",".oqy",
+                         ".cub",".atom",".atomsvc",
+                         ".prn",".slk",".dif"]
+        # Configure validation
+        self.Bind(wx.EVT_TEXT, self.validate)
+        self.validate()
+
+    def validate(self, evt=None):
+        """Redirect validate calls to global validate method, assigning appropriate valType"""
+        validate(self, "file")
+        # Enable Excel button if valid
+        self.xlBtn.Enable(self.valid)
+        # Is component type available?
+        if self.GetValue() in [None, ""] + self.validExt and hasattr(self.GetTopLevelParent(), 'type'):
+            # Does this component have a default template?
+            if self.GetTopLevelParent().type in self.templates:
+                self.xlBtn.Enable(True)
+
+    def openExcel(self, event):
+        """Either open the specified excel sheet, or make a new one from a template"""
+        file = self.rootDir / self.GetValue()
+        if not (file.is_file() and file.suffix in self.validExt): # If not a valid file
+            dlg = wx.MessageDialog(self, _translate(
+                "Once you have created and saved your table,"
+                "please remember to add it to {name}").format(name=_translate(self.Name)),
+                             caption=_translate("Reminder"))
+            dlg.ShowModal()
+            if hasattr(self.GetTopLevelParent(), 'type'):
+                if self.GetTopLevelParent().type in self.templates:
+                    file = self.templates[self.GetTopLevelParent().type] # Open type specific template
+                else:
+                    file = self.templates['None'] # Open blank template
+        # Open whatever file is used
+        try:
+            os.startfile(file)
+        except AttributeError:
+            opener = "open" if sys.platform == "darwin" else "xdg-open"
+            subprocess.call([opener, file])
+
+    def findFile(self, event):
+        _wld = f"All Table Files({'*'+';*'.join(self.validExt)})|{'*'+';*'.join(self.validExt)}|All Files (*.*)|*.*"
+        file = self.getFile(msg="Specify table file ...", wildcard=_wld)
+        if file:
+            self.SetValue(file)
+            self.validate(event)
+
+
+class ColorCtrl(wx.TextCtrl, _ValidatorMixin, _HideMixin):
+    def __init__(self, parent, valType,
+                 val="", fieldName="",
+                 size=wx.Size(-1, 24)):
+        # Create self
+        wx.TextCtrl.__init__(self)
+        self.Create(parent, -1, val, name=fieldName, size=size)
+        self.valType = valType
+        # Add sizer
+        self._szr = wx.BoxSizer(wx.HORIZONTAL)
+        if valType == "code":
+            # Add $ for anything to be interpreted verbatim
+            self.dollarLbl = wx.StaticText(parent, -1, "$", size=wx.Size(-1, -1), style=wx.ALIGN_RIGHT)
+            self.dollarLbl.SetToolTip(_translate("This parameter will be treated as code - we have already put in the $, so you don't have to."))
+            self._szr.Add(self.dollarLbl, border=5, flag=wx.ALIGN_CENTER_VERTICAL | wx.RIGHT | wx.LEFT)
+        # Add ctrl to sizer
+        self._szr.Add(self, proportion=1, border=5, flag=wx.EXPAND | wx.RIGHT)
+        # Add button to activate color picker
+        fldr = icons.ButtonIcon(stem="color", size=16).bitmap
+        self.pickerBtn = wx.BitmapButton(parent, -1, size=wx.Size(24,24), bitmap=fldr)
+        self.pickerBtn.SetToolTip(_translate("Specify color ..."))
+        self.pickerBtn.Bind(wx.EVT_BUTTON, self.colorPicker)
+        self._szr.Add(self.pickerBtn)
+        # Bind to validation
+        self.Bind(wx.EVT_CHAR, self.validate)
+        self.validate()
+
+    def colorPicker(self, evt):
+        dlg = PsychoColorPicker(self, context=self, allowCopy=False)  # open a color picker
+        dlg.ShowModal()
+        dlg.Destroy()
+
+
+def validate(obj, valType):
+    val = str(obj.GetValue())
+    valid = True
+    if val.startswith("$"):
+        # If indicated as code, treat as code
+        valType = "code"
+    # Validate string
+    if valType == "str":
+        if re.findall(r"(?<!\\)\"", val):
+            # If there are unescaped "
+            valid = False
+        if re.findall(r"(?<!\\)\'", val):
+            # If there are unescaped '
+            valid = False
+    # Validate code
+    if valType == "code":
+        # Replace unescaped curly quotes
+        if re.findall(r"(?<!\\)[\u201c\u201d]", val):
+            pt = obj.GetInsertionPoint()
+            obj.SetValue(re.sub(r"(?<!\\)[\u201c\u201d]", "\"", val))
+            obj.SetInsertionPoint(pt)
+        # For now, ignore
+        pass
+    # Validate num
+    if valType in ["num", "int"]:
+        try:
+            # Try to convert value to a float
+            float(val)
+        except ValueError:
+            # If conversion fails, value is invalid
+            valid = False
+    # Validate bool
+    if valType == "bool":
+        if val not in ["True", "False"]:
+            # If value is not True or False, it is invalid
+            valid = False
+    # Validate list
+    if valType == "list":
+        empty = not bool(val) # Is value empty?
+        fullList = re.fullmatch(r"[\(\[].*[\]\)]", val) # Is value full list with parentheses?
+        partList = "," in val and not re.match(r"[\(\[].*[\]\)]", val) # Is value list without parentheses?
+        singleVal = not " " in val or re.match(r"[\"\'].*[\"\']", val) # Is value a single value?
+        if not any([empty, fullList, partList, singleVal]):
+            # If value is not any of valid types, it is invalid
+            valid = False
+    # Validate color
+    if valType == "color":
+        # Strip function calls
+        if re.fullmatch(r"\$?(Advanced)?Color\(.*\)", val):
+            val = re.sub(r"\$?(Advanced)?Color\(", "", val[:-1])
+        try:
+            # Try to create a Color object from value
+            obj.color = Color(val, False)
+            if not obj.color:
+                # If invalid object is created, input is invalid
+                valid = False
+        except:
+            # If object creation fails, input is invalid
+            valid = False
+    if valType == "file":
+        val = Path(str(val))
+        if not val.is_absolute():
+            frame = obj.GetTopLevelParent().frame
+            # If not an absolute path, append to current directory
+            val = Path(frame.filename).parent / val
+        if not val.is_file():
+            # Is value a valid filepath?
+            valid = False
+        if hasattr(obj, "validExt"):
+            # If control has specified list of ext, does value end in correct ext?
+            if val.suffix not in obj.validExt:
+                valid = False
+
+    # If additional allowed values are defined, override validation
+    if hasattr(obj, "allowedVals"):
+        if val in obj.allowedVals:
+            valid = True
+
+    # Apply valid status to object
+    obj.valid = valid
+    if hasattr(obj, "showValid"):
+        obj.showValid(valid)
+
+    # Update code font
+    obj.updateCodeFont(valType)
+
+
+class DictCtrl(ListWidget, _ValidatorMixin, _HideMixin):
+    def __init__(self, parent,
+                 val={}, valType='dict',
+                 fieldName=""):
+        if not isinstance(val, (dict, list)):
+            raise ValueError("DictCtrl must be supplied with either a dict or a list of 1-long dicts, value supplied was {}".format(val))
+        # If supplied with a dict, convert it to a list of dicts
+        if isinstance(val, dict):
+            newVal = []
+            for key, v in val.items():
+                newVal.append({'Field': key, 'Default': v.val})
+            val = newVal
+        # If any items within the list are not dicts or are dicts longer than 1, throw error
+        if not all(isinstance(v, dict) and len(v) == 2 for v in val):
+            raise ValueError("DictCtrl must be supplied with either a dict or a list of 1-long dicts, value supplied was {}".format(val))
+        # Create ListWidget
+        ListWidget.__init__(self, parent, val, order=['Field', 'Default'])
+
+    def SetForegroundColour(self, color):
+        for child in self.Children:
+            if hasattr(child, "SetForegroundColour"):
+                child.SetForegroundColour(color)
+
+    def Enable(self, enable=True):
+        """
+        Enable or disable all items in the dict ctrl
+        """
+        # Iterate through all children
+        for cell in self.Children:
+            # Get the actual child rather than the sizer item
+            child = cell.Window
+            # If it can be enabled/disabled, enable/disable it
+            if hasattr(child, "Enable"):
+                child.Enable(enable)
+
+    def Disable(self):
+        """
+        Disable all items in the dict ctrl
+        """
+        self.Enable(False)
+
+    def Show(self, show=True):
+        """
+        Show or hide all items in the dict ctrl
+        """
+        # Iterate through all children
+        for cell in self.Children:
+            # Get the actual child rather than the sizer item
+            child = cell.Window
+            # If it can be shown/hidden, show/hide it
+            if hasattr(child, "Show"):
+                child.Show(show)
+
+    def Hide(self):
+        """
+        Hide all items in the dict ctrl
+        """
+        self.Show(False)