【PyQt】记录各种组件的使用方法

    使用Python开发GUI界面工具，通常可用选择PyQt框架，非常易使用，而且网上也有很多相关的文档分享。我也是在写了多个GUI界面后，自己整理了一些常用的使用文档，在此分享给大家（PyQt4~PyQt5适用）。

样式表

官网连接https://doc.qt.io/qt-5/stylesheet-examples.html，通过QSS样式可用将界面进行美化，幸好官网提供了比较详细的说明，可用去官网查看。

/**
   #evilButton 这个evilButton来自setObjectName
   语法和css类似
*/
QPushButton#evilButton {
    background-color: red;
    border-style: outset;
    border-width: 2px;
    border-color: beige;
}

FindWidget 找widget

有时候我们创建了很多的组件，但是不会每个组件都保持下来，可用通过查找的方式得到。

widget = Container 
# 某个父容器widget.findChild(QLabel, "xx") 
# 找他里面的objectName为xx的QLabel。
# 遍历找
for child in widget.children():
    if isinstance(child, QLabel) # 按类型
    if child.objectName() == "xx" # 按objectName

QTreeWidget 树形控件

nav = QTreeWidget()
for name in some_list:
    item = QTreeWidgetItem(nav)
    if name is list: # 如果还有子节点
        for child in name:
            c_node = QTreeWidgetItem(item)
# 通过QTreeWidgetItem创建子节点，子节点的子节点继续使用QTreeWidgetItem，parent为父节点。
# 设置节点的icon
icon = QIcon()
item.setIcon(icon)

QListWidget 列表控件

listw = QListWidget()
# 生成列表，待自定义的widget
item = QListWidgetItem()
item_content_widget = QWidget() #-->创建Qwidget并在里面填充所需的内容，例如加label，加checkbox等
item.setSizeHint(item_content_widget.sizeHint()) # 一定要调用这个设置列表每列的尺寸，否则显示异常。尺寸安装内部容器的尺寸
listw.addItem(item) # 添加到列表控件中
listw.setItemWidget(item, item_content_widget)# 把列组件和自定义的关联起来。
# 读取内容
for i in range(listw.count()): # 仅展示一种
  item = listw.item(i) # 这样就拿到了item 如果关联了自定义widget
  item_content_widget = listw.itemWidget(item) # 这样才可以拿到

QsciScintilla 代码编辑器需要额外安装Qsci库

class ScriptViewer(QsciScintilla):
    """"""
    def __init__(self, basename, parent=None):
        """"""
        QsciScintilla.__init__(self, parent)
        # 以\n换行
        self.setEolMode(self.SC_EOL_LF)
        # 自动换行。self.WrapWord是父类QsciScintilla的
        self.setWrapMode(self.WrapWord)
        # 自动补全。对于所有Ascii字符
        self.setAutoCompletionSource(self.AcsAll)
        # 自动补全大小写敏感
        self.setAutoCompletionCaseSensitivity(False)
        # 输入多少个字符才弹出补全提示
        self.setAutoCompletionThreshold(1)
        # 代码可折叠
        self.setFolding(True)
        # 设置默认字体
        self.setFont(QFont('Courier New', 12))
        # 0~4。第0个左边栏显示行号
        self.setMarginType(0, self.NumberMargin)
        # 设置空白
        # self.setMarginLineNumbers(0, True)
        # 边栏背景颜色
        self.setMarginsBackgroundColor(QColor(120, 220, 180))
        # 边栏宽度
        self.setMarginWidth(0, 30)
        # 换行后自动缩进
        self.setAutoIndent(True)
        # tab宽度是4
        self.setTabWidth(4)
        # 支持中文字符
        self.setUtf8(True)
        # 显示空格点和\t的箭头
        self.setWhitespaceVisibility(True)
        # 设置空格的宽度
        self.setWhitespaceSize(2)
        # 设置用空格代替tab
        self.setIndentationsUseTabs(False)
    def setPythonScriptLexer(self):
        """Python脚本语法高亮"""
        self.mTextLexer = QsciLexerPython()
        self.setLexer(self.mTextLexer)
    def setTextLexer(self):
        """"""
        self.mTextLexer = QsciLexerTeX()
        self.setLexer(self.mTextLexer)
    def setCssLexer(self):
        """CSS样式高亮"""
        self.mTextLexer = QsciLexerCSS()
        self.setLexer(self.mTextLexer)
    def setConfigLexer(self):
        """properties文件样式高亮"""
        self.mTextLexer = QsciLexerProperties()
        self.setLexer(self.mTextLexer)

QTabWidget Tab组件

tab = QTabWidget()
tab.addTab(widget, "标题") # 有多个参数，支持显示图标

QDockWidget 窗口Dock

dock_widget = QDockWidget("标题", parent)
dock_widget.setFeatures(QDockWidget.DockWidgetMovable) # 可以拖动，其他功能看doc
dock_widget.setAllowedAreas(Qt.LeftDockWidgetArea | Qt.RightDockWidgetArea) # 设置停靠的区域。这里是主窗口左右两边
dock_widget.setWidget(widget) # 把widget放入dock内部
self.addDockWidget(Qt.RightDockWidgetArea, dock_widget) 
# 将dock窗口添加到主窗口中，这里的self用的QMainWindow。给他默认停靠位置

ToolBar工具栏

toolbar = self.addToolBar("标题")
toolbar.addAction(QAction) #增加按钮QAction

QMenuBar 菜单栏

memubar = QMenuBar(self) # self=主窗体，QMainWindow
menuItem = menubar.addMenu("File") # 增加一个主菜单
menuItem.addAction(QAction) # 增加子菜单
menuItem.addSeperator() # 增加一个分割线
menuItem.setShortcut("Ctrl+N") # 设置快捷键
child_item = menuItem.addMenu("xx") # 增加子菜单

QAction 动作(放在菜单和工具栏上面)

action = QAction("名字", self) #self=主窗体，QMainWindow
action = QAction(QIcon(), "名字", self) # 可以显示图标
action.triggered.connect(callable) # 点击事件
action.setShortcut("Ctrl + Q") # 设置快捷键
action.setCheckable(True) # 设置为选择菜单
action.setChecked(False) # 是否默认选择

QTextEdit 文本编辑框

text = QTextEdit()
text.setText("str") # 设置文本
cursor = text.textCursor() # 获取光标的位置，这样可以选择，修改颜色，指定地方插入文本等
cursor.movePosition(QTextCursor.End) #移动光标位置 -末尾
cursor.insertText("str") # 插入文本
text.setTextCursor(cursor)
text.ensureCursorVisible()

QSystemTrayIcon 系统托盘图标

class QSysTrayIcon(QSystemTrayIcon):
    """ 系统托盘图标功能 """
    def __init__(self, parent=None):
        super(QSysTrayIcon, self).__init__(parent)
        # 系统菜单
        self.mContextMenu = QMenu()
        # 设置系统菜单
        self.setContextMenu(self.mContextMenu)
        # 托盘的图标
        self.setIcon(QIcon("capture.png"))
    def send_message(self, title, content, icon_=0, delay_=10000):
        """
        显示一条消息通知
        :param title:
        :param content:
        :param icon_: （0没有图标 1信息图标 2警告图标 3错误图标），0还是有一个小图标
        :param delay_: 持续间隔（毫秒）
        :return:
        """
        self.showMessage(title, content, icon=icon_, msecs=delay_)
    def add_menu_action(self, label_, parent_, triggered_):
        """
        添加操作按钮
        :param label_:
        :param parent_:
        :param triggered_:
        :return:
        """
        action = QAction(label_, parent_, triggered=triggered_)
        self.mContextMenu.addAction(action)
        return action
    def quit(self):
        """
        退出
        :return:
        """
        self.setVisible(False)
## 使用
mTrayIcon = QSysTrayIcon(self) # self=主窗体，QMainWindow
mToggleAction = mTrayIcon.add_menu_action("隐藏界面", self, self.on_toggle_widget)
mTrayIcon.show()
# 在主窗体的closeEvent中调用self.mTrayIcon.quit()来保证icon消失
# 发送一个气泡消息，可以做icon和显示的时长
mTrayIcon.send_message("提示", "界面已经显示")

QSplashScreen 启动画面

　　这是官方提供的一种，也可以自己用QWidget搞

class SplashScreen(QSplashScreen):
    def set_image_data(self, image, w, h):
        """设置启动图数据"""
        # 缩放图片和设置画面尺寸
        self.setMaximumSize(w, h)
        image = image.scaled(w, h, Qt.KeepAspectRatio)
        self.setPixmap(image) # 这个就是设置启动画面图
    def effect_fade_in(self, timeout=1.0, addv=0.02):
        """ 淡入 """
        self.setWindowOpacity(0)
        loop_count = int(1 / addv)
        sleep_time = timeout / loop_count
        for i in range(loop_count):
            new_opacity = self.windowOpacity() + 0.02  # 设置淡入
            if new_opacity > 1:
                break
            self.setWindowOpacity(new_opacity)
            time.sleep(sleep_time)
    def effect_fade_out(self, timeout=0.5, addv=0.02):
        """ 淡出 """
        self.setWindowOpacity(1)
        loop_count = int(1 / addv)
        sleep_time = timeout / loop_count
        for i in range(loop_count):
            new_opacity = self.windowOpacity() - 0.02  # 设置淡出
            if new_opacity < 0:
                break
            self.setWindowOpacity(new_opacity)
            time.sleep(sleep_time)
    def on_show_effect(self):
        """ 开始显示的效果 """
        self.setWindowOpacity(0)
        self.show()
        self.effect_fade_in()
    def on_hide_effect(self):
        """ 结束显示的效果 """
        self.effect_fade_out()
    def mousePressEvent(self, evt):
        """重写鼠标点击事件，阻止点击后消失"""
        pass
    def mouseDoubleClickEvent(self, *args, **kwargs):
        """重写鼠标移动事件，阻止出现卡顿现象"""
        pass
    def enterEvent(self, *args, **kwargs):
        """重写鼠标移动事件，阻止出现卡顿现象"""
        pass
    def mouseMoveEvent(self, *args, **kwargs):
        """重写鼠标移动事件，阻止出现卡顿现象"""
        pass
# 样例，正常的流程可以自己随便接
app = QApplication(argv)
app.processEvents() # 让事件继续派发
sp = SplashScreen() # 动画没有试过，需要
sp.on_show_effect()
 <some main widiget init > # 可以在这里初始化主界面
sp.on_hide_effect()
sp.finish(some widget) # 这样启动画面会等待这个widget显示后才会消失。
sp.deleteLater()
# 下面是网上的显示gif动画的代码
class GifSplashScreen(QSplashScreen):
    def __init__(self, *args, **kwargs):
        super(GifSplashScreen, self).__init__(*args, **kwargs)
        self.movie = QMovie('some.gif')
        self.movie.frameChanged.connect(self.onFrameChanged)
        self.movie.start()
    def onFrameChanged(self, _):
        self.setPixmap(self.movie.currentPixmap())
    def finish(self, widget):
        self.movie.stop()
        super(GifSplashScreen, self).finish(widget)

QMovie 显示动画

# 在界面显示gif动画，需要用到QMovie和QLabel
label = QLabel()
movie = QMovie("gif")
movie.setScaledSize(QSize()) # 设置缩放尺寸
movie.setCacheMode(QMovie.CacheAll) # 缓存
movie.setSpeed(100) # 设置速度
label.setMovie(movie) # 设置动画
label.setScaledContents(True) #按内容缩放
movie.start() # 开始播放

    文章来自我的公众号，大家如果有兴趣可以关注，具体扫描关注下图。