PySide

From FreeCAD Documentation
Revision as of 21:28, 4 September 2010 by Jmvillar (talk | contribs) (Created page with '[http://en.wikipedia.org/wiki/PyQt PyQt] es un módulo de Python que permite a las aplicaciones python crear, acceder y modificar [http://en.wikipedia.org/wiki/Qt_(toolkit) Qt] …')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

PyQt es un módulo de Python que permite a las aplicaciones python crear, acceder y modificar Qt aplicaciones. Se puede utilizar por ejemplo para crear sus propios programas de Qt en Python, o para acceder y modificar la interfaz de una aplicación Qt en ejecución, como FreeCAD.

Al utilizar el módulo de PyQt desde el interior de FreeCAD, se tiene un control total sobre su interfaz. Por ejemplo, puede:

  • Añade sus propios paneles, widgets y barras de herramientas
  • Añadir u ocultar los elementos en los paneles existentes
  • Cambiar, redirigir o agregar conexiones entre todos los elementos

PyQt tiene una extensa API documentation, y hay muchos tutoriales en la red que le enseñan cómo funciona.

Si quiere trabajar en la interfaz FreeCAD, lo primero que debe hacer es crear una referencia a la ventana principal de FreeCAD :

import sys
from PyQt4 import QtGui
app = QtGui.qApp
mw = app.activeWindow()

A continuación, puede navegar por ejemplo a través de todos los widgets de la interfaz:

for child in mw.children:
   print 'widget name = ', child.getObjectName(), ', widget type = ', child

Los widgets en una interfaz Qt se suelen anidar en "contenedores" widgets, de modo que los hijos de nuestra ventana principal pueden contener otros hijos. Dependiendo del tipo de widget, hay un montón de cosas que usted puede hacer. Compruebe la documentación de la API para ver lo que es posible.

Agregar un nuevo widget, por ejemplo un dockWidget (que puede ser colocado en uno de los paneles laterales FreeCAD), es fácil:

myWidget = QtGui.QDockWidget()
mw.addDockWidget(QtCore.Qt.RightDockWidgetArea,myWidget)

A continuación, podría agregar cosas directamente a su widget:

  myWidget.setObjectName("my Nice New Widget")
  myWidget.resize(QtCore.QSize(QtCore.QRect(0,0,300,100))) # sets size of the widget
  label = QtGui.QLabel(myWidget) # creates a label
  label.setGeometry(QtCore.QRect(50,50,200,24)) # sets its size
  label.setObjectName("myLabel") # sets its name, so it can be found by name

Sin embargo, es preferible un método consiste en crear un objeto de interfaz de usuario (UI) que hará todo el trabajo de la configuración del widget a la vez. La gran ventaja es que tales objetos de interfaz de usuario puede ser created graphically (Creado gráficamente) con el programa de Qt Designer. Un objeto típico generado por Qt Designer es así:

class myWidget_Ui(object):
  def setupUi(self, myWidget):
    myWidget.setObjectName("my Nice New Widget")
    myWidget.resize(QtCore.QSize(QtCore.QRect(0,0,300,100).size()).expandedTo(myWidget.minimumSizeHint())) # sets size of the widget

    self.label = QtGui.QLabel(myWidget) # creates a label
    self.label.setGeometry(QtCore.QRect(50,50,200,24)) # sets its size
    self.label.setObjectName("label") # sets its name, so it can be found by name

  def retranslateUi(self, draftToolbar): # built-in QT function that manages translations of widgets
    myWidget.setWindowTitle(QtGui.QApplication.translate("myWidget", "My Widget", None, QtGui.QApplication.UnicodeUTF8))
    self.label.setText(QtGui.QApplication.translate("myWidget", "Welcome to my new widget!", None, QtGui.QApplication.UnicodeUTF8))

To use it, you just need to apply it to your freshly created widget like this: Para usarlo, sólo tiene que aplicarlo a su propio widget, recién creado, de esta manera:

myNewFreeCADWidget = QtGui.QDockWidget() # create a new dckwidget
myNewFreeCADWidget.ui = myWidget_Ui() # load the Ui script
myNewFreeCADWidget.ui.setupUi(myNewFreeCADWidget) # setup the ui
FCmw.addDockWidget(QtCore.Qt.RightDockWidgetArea,myNewFreeCADWidget) # add the widget to the main window


Pivy/es
Scripted objects/es
Available translations of this page: Template:Se