031.PyQt5_QCommandLinkButton_命令链接按钮

QCommandLinkButton命令链接按钮

• 描述
  • 命令链接是Windows Vista引入的新控件
  • 它的用途类似于单选按钮的用途，因为它用于在一组互斥选项之间进行选择
  • 命令链接按钮不应单独使用，而应作为向导和对话框中单选按钮的替代选项
  • 外观通常类似于平面按钮的外观，但除了普通按钮文本之外，它还允许描述性文本
• 继承自QPushButton
• 功能作用
• 创建命令连接按钮

  QCommandLinkButton(parent)              # 创建按钮的同时设置父控件
  QCommandLinkButton(str, parent)         # 创建按钮的同时设置标题和父控件
  QCommandLinkButton(str, str, parent)    # 创建按钮的同时设置标题、描述和父控件
  

• 常用API

  setDescription(str)         # 设置描述信息
  
  description()               # 获取描述信息
  
  # 其他API同其父控件
  

• 可用信号

      # 继承自QAbstractButton类
          pressed()                   # 鼠标按下信号
          released()                  # 鼠标释放信号（控件内松开鼠标/鼠标移出控件范围后）
          clicked(checked = False)    # 单击信号（控件内按下+控件内释放），传递按钮是否被选中状态
          toffled(bool checked)       # 选中状态切换信号（一般在单选框或者复选框中使用），传递按钮是否被选中状态
          
      # 继承自QWidget类
          windowTitleChanged(QString)           # 窗口标题改变信号，发射新的窗口名称
          windowIconChanged(QIcon)              # 窗口图标改变信号，发射图标对象
          customContextMenuRequested(QPoint)    # 自定义上下文菜单请求信号(鼠标右键按下发射信号)，发射（传递）鼠标右键点击的坐标
          
          setContextMenuPolicy(Qt.CustomContextMenu)  # 设置控件自定义上下文菜单策略
          # 参数：
                  Qt.CustomContextMenu  # 发射信号customContextMenuRequested(QPoint)
                  Qt.DefaultContextMenu  # 默认，调用对象方法contextMenuEvent()
  

---

• 示例代码

  from PyQt5.Qt import *
  import sys
  
  app = QApplication(sys.argv)
  window = QWidget()
  window.resize(500, 500)
  window.setWindowTitle('QCommandLinkButton命令链接按钮')
  
  # 方法一创建：创建按钮的同时设置父控件
  btn1 = QCommandLinkButton(window)
  btn1.setText('按钮标题1')
  btn1.setDescription('描述内容1')
  btn1.move(100, 100)
  
  # 方法二创建：创建按钮的同时设置标题和父控件
  btn2 = QCommandLinkButton('按钮标题2', window)
  btn2.setDescription('描述内容2')
  btn2.move(100, 200)
  
  # 方法三创建：创建按钮的同时设置标题、描述和父控件
  btn3 = QCommandLinkButton('按钮标题3', '描述内容3', window)
  btn3.move(100, 300)
  
  # 重新设置按钮属性
  btn4 = QCommandLinkButton('按钮标题4', '描述内容3', window)
  btn4.move(100, 400)
  btn4.setText('重新设置标题')
  btn4.setDescription('重新设置描述内容')
  btn4.setIcon(QIcon('../ico/logo.ico'))
  
  
  window.show()
  sys.exit(app.exec_())