pymel.core.windows.loadUI

loadUI(*args, **kwargs)

loadUI command allows loading of a user interface created in Trolltech Qt Designer. Some Qt classes have equivalents in Maya. If a widget’s class is recognized, the Maya-equivelent will be created instead. Any dynamic properties on a widget which start with a ‘-‘ character will be treated as a MEL flag/value pair. Similarly, any which start with a ‘+’ will be treated as a Python flag/value pair. Such pairs will be applied to the widget upon creation.

Flags:

Long name (short name)		Argument Types	Properties
listTypes (lt)		bool
	Returns the list of recognized UI types and their associated Maya command. Flag can have multiple arguments, passed either as a tuple or a list.
uiFile (f)		unicode
	Full path to a user interface file to load.
uiString (s)		unicode
	Load UI from a formated string.
verbose (v)		bool
	Extra information about created controls will be printed.
workingDirectory (wd)		unicode
	Sets the working directory, the loader looks for resources such as icons and resouce files in paths relative to this directory.

Derived from mel command maya.cmds.loadUI

Example:

import pymel.core as pm

# Note: mydialog.ui must already exist
dialog1 = pm.loadUI(f='/users/username/mydialog.ui')
pm.showWindow(dialog1)

# Load from a string
dialogString = \\
r""""?xml version="1.0" encoding="UTF-8"?"
"ui version="4.0""
 "class"Dialog"/class"
 "widget class="QDialog" name="Dialog""
  "layout class="QVBoxLayout" name="verticalLayout""
   "item"
    "widget class="QLabel" name="label""
     "property name="text""
      "string"Test Dialog"/string"
     "/property"
    "/widget"
   "/item"
  "/layout"
 "/widget"
"/ui"
"""
dialog2 = pm.loadUI(uiString=dialogString)
pm.showWindow(dialog2)