PyQt（Python+Qt）学习随笔：QDockWidget停靠部件floating和features属性

• 专栏：Python基础教程目录
• 专栏：使用PyQt开发图形界面Python应用
• 专栏：PyQt入门学习
• 老猿Python博文目录

1、floating属性

floating属性表示QDockWidget对象是否浮动在主窗口之上，如果为True表示浮动停靠部件作为漂浮在其父QMainWindow的“顶部”使用独立窗口展现，为False则停靠在在QMainWindow中。缺省为True，可通过方法isFloating()、setFloating(bool

floating)来访问该属性，当此属性改变时，会发射 topLevelChanged(bool floating) 信号，信号签名表示QDockWidget对象现状是否浮动在主窗口之上

2、features属性

features属性用于设置浮动部件的特征，其类型为枚举类型 QDockWidget.DockWidgetFeatures,特征包括浮动窗是否可关闭（DockWidgetClosable）、是否可移动（DockWidgetMovable）、是否可浮动（DockWidgetFloatable）、是否将标题栏展示在窗口左边成竖直标题栏（DockWidgetVerticalTitleBar）。除了这几个值之外，该特征类型在Designer中还有如下取值：

• AllDockWidgetFeatures：表示同时设置了DockWidgetClosable、DockWidgetMovable、DockWidgetFloatable这三个特征，但不一定设置了DockWidgetVerticalTitleBar特征，但不建议使用这个值，因为Qt或PyQt可能会增加其他特征值时，AllDockWidgetFeatures包括的特征范围可能会增加
• DockWidgetFeatureMask：表示同时设置了DockWidgetClosable、DockWidgetMovable、DockWidgetFloatable、DockWidgetVerticalTitleBar这四个特征，这个DockWidgetFeatureMask值仅在Designer中使用，选择这个特征则自动勾选上述四个特征，但在类中无此枚举值，即代码不识别该值；
• NoDockWidgetFeatures：表示不设置任何特征，在Designer中选择此值自动去掉其他特征，由于此值对应数值为0，代码中如果使用此值与其他值组合，则此值将失效，以其他值为准
• Reserved：这个值在Designer中选择后，将会勾选所有除NoDockWidgetFeatures之外的特征值，但该值在代码中无效。

features属性缺省为 DockWidgetClosable, DockWidgetMovable和DockWidgetFloatable的组合，可通过方法features() 和setFeatures(DockWidgetFeatures features)访问该属性。

当features属性修改时，会发射featuresChanged(QDockWidget.DockWidgetFeatures features)信号。

注意：

• 当floating为True，而features属性未设置为可浮动（DockWidgetFloatable）时，浮动窗是浮动状态，但一旦停靠后就不能通过手工操作将其再浮动起来

老猿Python，跟老猿学Python!

• 专栏：Python基础教程目录
• 专栏：使用PyQt开发图形界面Python应用
• 专栏：PyQt入门学习
• 老猿Python博文目录