PySide/ru: Difference between revisions
Renatorivo (talk | contribs) (Created page with "[http://ru.wikipedia.org/wiki/PyQt PyQt] это модуль python, который позволяет приложениям на python создавать, получать...") |
(Updating to match new version of source page) |
||
(34 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
|||
{{Note|PySide|Recently, FreeCAD has switched internally to use [http://qt-project.org/wiki/PySide PySide] instead of PyQt. That change was mainly done because of the licenses, PySide having an LGPL license which is more compatible with FreeeCAD. Other than that, PySide works exactly the same way as PyQt, and in FreeCAD you can usually use any of them, as you prefer. If you choose to use PySide, just replace all "PyQt" in the example code below with "PySide". See [http://qt-project.org/wiki/Differences_Between_PySide_and_PyQt Differences Between PySide and PyQt]}} |
|||
{{docnav|Pivy|FeaturePython Objects}} |
|||
==Introduction== |
|||
[http://ru.wikipedia.org/wiki/PyQt PyQt] это модуль python, который позволяет приложениям на python создавать, получать доступ и изменять [http://ru.wikipedia.org/wiki/Qt Qt] приложения. Вы можете использовать его для создания собственных Qt программ на python, или получать доступ и изменять интерфейс запущенного qt приложения, такого как FreeCAD. |
|||
<div class="mw-translate-fuzzy"> |
|||
By using the PyQt module from inside FreeCAD, you have therefore full control over its interface. You can for example: |
|||
[http://en.wikipedia.org/wiki/PySide PySide] это привязка Python кросс-платформенного инструментария GUI Qt. FreeCAD использует PySide для всех целей GUI (графический интерфейс пользователя) внутри Python. PySide является альтернативой пакету PyQt, который ранее использовался FreeCAD для своего графического интерфейса. PySide имеет более допустимую лицензию. Увидеть [http://qt-project.org/wiki/Differences_Between_PySide_and_PyQt Differences Between PySide and PyQt] для получения дополнительной информации о различиях. |
|||
* Add your own panels, widgets and toolbars |
|||
</div> |
|||
* Add or hide elements to existing panels |
|||
* Change, redirect or add connections between all those elements |
|||
== PySide in FreeCAD with Qt5 == |
|||
PyQt has an extensive [http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/classes.html API documentation], and there are many tutorials on the net to teach you how it works. |
|||
FreeCAD was developed to be used with Python 2 and Qt4. As these two libraries became obsolete, FreeCAD transitioned to Python 3 and Qt5. In most cases this transition was done without needing to break backwards compatibility. |
|||
If you want to work on the FreeCAD interface, the very first thing to do is create a reference to the FreeCAD main window: |
|||
Normally, the {{incode|PySide}} module provides support for Qt4, while {{incode|PySide2}} provides support for Qt5. However, in FreeCAD, there is no need to use {{incode|PySide2}} directly, as a special {{incode|PySide}} module is included to handle Qt5. |
|||
This {{incode|PySide}} module is located in the {{incode|Ext/}} directory of an installation of FreeCAD compiled for Qt5. |
|||
{{Code|code= |
{{Code|code= |
||
/usr/share/freecad/Ext/PySide |
|||
import sys |
|||
from PySide import QtGui ,QtCore |
|||
app = QtGui.qApp |
|||
mw = app.activeWindow() |
|||
}} |
}} |
||
Then, you can for example browse through all the widgets of the interface: |
|||
This module just imports the necessary classes from {{incode|PySide2}}, but places them in the {{incode|PySide}} namespace. This means that in most cases the same code can be used with both Qt4 and Qt5, as long as it imports {{incode|PySide}}. |
|||
{{Code|code= |
{{Code|code= |
||
PySide2.QtCore -> PySide.QtCore |
|||
for child in mw.children(): |
|||
PySide2.QtGui -> PySide.QtGui |
|||
print 'widget name = ', child.objectName(), ', widget type = ', child |
|||
PySide2.QtSvg -> PySide.QtSvg |
|||
PySide2.QtUiTools -> PySide.QtUiTools |
|||
}} |
}} |
||
The widgets in a Qt interface are usually nested into "containers" widgets, so the children of our main window can themselves contain other children. Depending on the widget type, there are a lot of things you can do. Check the API documentation to see what is possible. |
|||
The only unusual aspect is that the {{incode|PySide2.QtWidgets}} classes are placed in the {{incode|PySide.QtGui}} namespace. |
|||
Adding a new widget, for example a dockWidget (which can be placed in one of FreeCAD's side panels) is easy: |
|||
{{Code|code= |
{{Code|code= |
||
PySide2.QtWidgets.QCheckBox -> PySide.QtGui.QCheckBox |
|||
myWidget = QtGui.QDockWidget() |
|||
mw.addDockWidget(QtCore.Qt.RightDockWidgetArea,myWidget) |
|||
}} |
}} |
||
You could then add stuff directly to your widget: |
|||
{{Code|code= |
|||
myWidget.setObjectName("my Nice New Widget") |
|||
myWidget.resize(QtCore.QSize(300,100)) # sets size of the widget |
|||
label = QtGui.QLabel("Hello World", 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 |
|||
}} |
|||
But a preferred method is to create a UI object which will do all of the setup of your widget at once. The big advantage is that such an UI object can be [[Dialog creation|created graphically]] with the Qt Designer program. A typical object generated by Qt Designer is like this: |
|||
{{Code|code= |
|||
class myWidget_Ui(object): |
|||
def setupUi(self, myWidget): |
|||
myWidget.setObjectName("my Nice New Widget") |
|||
myWidget.resize(QtCore.QSize(300,100).expandedTo(myWidget.minimumSizeHint())) # sets size of the widget |
|||
== PySide information == |
|||
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 |
|||
Пользователи FreeCAD часто добиваются всего, используя встроенный интерфейс. Но для пользователей, которые хотят настроить свои операции, существует интерфейс Python, который описан в [[Python_scripting_tutorial | Python Scripting Tutorial]]. Интерфейс Python для FreeCAD обладает большой гибкостью и мощью. Для взаимодействия с пользователем Python с FreeCAD использует PySide, что описано на этой странице. |
|||
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)) |
|||
Python предлагает оператор 'print', который дает код: |
|||
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: |
|||
{{Code|code= |
{{Code|code= |
||
print 'Hello World' |
|||
app = QtGui.qApp |
|||
FCmw = app.activeWindow() |
|||
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 |
|||
}} |
}} |
||
С оператором 'print' Python вы имеете только ограниченный контроль над внешним видом и поведением. PySide предоставляет отсутствующий элемент управления, а также обрабатывает среды (такие как среда макрофайловых файлов FreeCAD), где встроенных средств Python недостаточно. |
|||
Возможности PySide варьируются от: |
|||
[[File:PySideScreenSnapshot1.jpg]] |
|||
до: |
|||
[[File:PySideScreenSnapshot2.jpg]] |
|||
'''Familiarize yourself with some real-world examples of PySide''' |
|||
* [[PySide Beginner Examples]] (Hello World, announcements, enter text, enter number) |
|||
* [[PySide Intermediate Examples]] (window sizing, hiding widgets, popup menus, mouse position, mouse events) |
|||
* [[PySide Advanced Examples]] (widgets etc.) |
|||
They divide the subject matter into 3 parts, differentiated by level of exposure to PySide, Python and the FreeCAD internals. The first page has overview and background material giving a description of PySide and how it is put together while the second and third pages are mostly code examples at different levels. |
|||
The intention is that the associated pages will provide simple Python code to run PySide so that the user working on a problem can easily copy the code, paste it into their own work, adapt it as necessary and return to their problem solving with FreeCAD. Hopefully they don't have to go chasing off across the internet looking for answers to PySide questions. At the same time this page is not intended to replace the various comprehensive PySide tutorials and reference sites available on the web. |
|||
<div class="mw-translate-fuzzy"> |
|||
{{docnav|Pivy|Scripted objects}} |
{{docnav|Pivy|Scripted objects}} |
||
</div> |
|||
{{Userdocnavi/ru}} |
|||
[[Category:Poweruser Documentation]] |
|||
[[Category:Poweruser Documentation/ru]] |
|||
[[Category:Developer/ru]] |
|||
[[Category:Developer Documentation/ru]] |
|||
{{clear}} |
{{clear}} |
||
<languages/> |
Revision as of 22:59, 10 February 2020
Introduction
PySide это привязка Python кросс-платформенного инструментария GUI Qt. FreeCAD использует PySide для всех целей GUI (графический интерфейс пользователя) внутри Python. PySide является альтернативой пакету PyQt, который ранее использовался FreeCAD для своего графического интерфейса. PySide имеет более допустимую лицензию. Увидеть Differences Between PySide and PyQt для получения дополнительной информации о различиях.
PySide in FreeCAD with Qt5
FreeCAD was developed to be used with Python 2 and Qt4. As these two libraries became obsolete, FreeCAD transitioned to Python 3 and Qt5. In most cases this transition was done without needing to break backwards compatibility.
Normally, the PySide
module provides support for Qt4, while PySide2
provides support for Qt5. However, in FreeCAD, there is no need to use PySide2
directly, as a special PySide
module is included to handle Qt5.
This PySide
module is located in the Ext/
directory of an installation of FreeCAD compiled for Qt5.
/usr/share/freecad/Ext/PySide
This module just imports the necessary classes from PySide2
, but places them in the PySide
namespace. This means that in most cases the same code can be used with both Qt4 and Qt5, as long as it imports PySide
.
PySide2.QtCore -> PySide.QtCore
PySide2.QtGui -> PySide.QtGui
PySide2.QtSvg -> PySide.QtSvg
PySide2.QtUiTools -> PySide.QtUiTools
The only unusual aspect is that the PySide2.QtWidgets
classes are placed in the PySide.QtGui
namespace.
PySide2.QtWidgets.QCheckBox -> PySide.QtGui.QCheckBox
PySide information
Пользователи FreeCAD часто добиваются всего, используя встроенный интерфейс. Но для пользователей, которые хотят настроить свои операции, существует интерфейс Python, который описан в Python Scripting Tutorial. Интерфейс Python для FreeCAD обладает большой гибкостью и мощью. Для взаимодействия с пользователем Python с FreeCAD использует PySide, что описано на этой странице.
Python предлагает оператор 'print', который дает код:
print 'Hello World'
С оператором 'print' Python вы имеете только ограниченный контроль над внешним видом и поведением. PySide предоставляет отсутствующий элемент управления, а также обрабатывает среды (такие как среда макрофайловых файлов FreeCAD), где встроенных средств Python недостаточно.
Возможности PySide варьируются от:
до:
Familiarize yourself with some real-world examples of PySide
- PySide Beginner Examples (Hello World, announcements, enter text, enter number)
- PySide Intermediate Examples (window sizing, hiding widgets, popup menus, mouse position, mouse events)
- PySide Advanced Examples (widgets etc.)
They divide the subject matter into 3 parts, differentiated by level of exposure to PySide, Python and the FreeCAD internals. The first page has overview and background material giving a description of PySide and how it is put together while the second and third pages are mostly code examples at different levels.
The intention is that the associated pages will provide simple Python code to run PySide so that the user working on a problem can easily copy the code, paste it into their own work, adapt it as necessary and return to their problem solving with FreeCAD. Hopefully they don't have to go chasing off across the internet looking for answers to PySide questions. At the same time this page is not intended to replace the various comprehensive PySide tutorials and reference sites available on the web.
- Начинающим
- Установка: Загрузка, Windows, Linux, Mac, Дополнительных компонентов, Docker, AppImage, Ubuntu Snap
- Базовая: О FreeCAD, Интерфейс, Навигация мыши, Методы выделения, Имя объекта, Настройки, Верстаки, Структура документа, Свойства, Помоги FreeCAD, Пожертвования
- Помощь: Учебники, Видео учебники
- Верстаки: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web