setObjectName ():设置对象的唯一名称标识,传入字符串(如setObjectName("main_btn")),用于通过名称查找对象、样式表精准匹配控件,是对象标识的核心方法。
objectName ():获取对象的名称标识,返回字符串,用于校验对象名称、通过名称定位对象(如findChild())。
setParent ():设置当前对象的父对象,传入 QObject 子类对象(如setParent(main_window)),管理对象生命周期(父对象销毁时自动销毁子对象)、构建对象树。
parent ():获取当前对象的父对象,返回 QObject 对象(无父对象则返回 None),读取对象的层级归属。
children ():获取当前对象的所有直接子对象列表,返回List[QObject],遍历子对象(如批量修改子控件属性)。
findChild ():查找指定类型 + 名称的直接 / 间接子对象,参数为(对象类型, 名称, 查找选项)(如findChild(QPushButton, "submit_btn")),精准定位子对象。
findChildren ():查找所有指定类型 + 名称的直接 / 间接子对象,返回列表(如findChildren(QLineEdit)),批量获取同类型子对象。
deleteLater ():标记对象为待销毁,在 Qt 事件循环空闲时销毁对象(安全销毁,避免内存泄漏),是 Qt 推荐的对象销毁方式。
connect ():绑定信号与槽函数,核心方法(如btn.clicked.connect(self.on_click)),实现对象间的事件通信,支持多信号绑定、参数传递。
disconnect ():断开信号与槽函数的绑定,参数为(信号, 槽函数)(如btn.clicked.disconnect(self.on_click)),停止指定的事件通信。
sender ():在槽函数中获取触发信号的源对象,返回 QObject 对象,识别是哪个对象触发了当前槽函数(如多个按钮绑定同一槽函数时区分来源)。
setProperty ():设置对象的自定义属性,参数为(属性名, 属性值)(如setProperty("status", "active")),为对象添加额外的自定义数据。
property ():获取对象的自定义属性值,传入属性名返回值(如property("status")),读取自定义数据。
dynamicPropertyNames ():获取对象所有自定义属性的名称列表,返回List[QByteArray],遍历所有自定义属性。
installEventFilter ():为对象安装事件过滤器,传入 QObject 子类对象(需重写eventFilter()),拦截并处理对象的所有事件(如拦截按钮点击、键盘输入)。
removeEventFilter ():移除已安装的事件过滤器,传入过滤器对象,停止事件拦截。
event ():处理对象的原始事件(需重写),返回布尔值(True 表示事件已处理,False 表示继续传递),自定义事件处理逻辑。
eventFilter ():事件过滤器的核心方法(需重写),参数为(目标对象, 事件),返回布尔值,实现对目标对象事件的拦截 / 修改。
timerEvent ():处理定时器事件(需重写),参数为 QTimerEvent 对象,自定义定时器触发后的逻辑。
startTimer ():启动定时器,传入定时时长(ms),返回定时器 ID,触发周期性的timerEvent()。
killTimer ():停止指定 ID 的定时器,传入定时器 ID,终止周期性事件触发。
metaObject ():获取对象的元对象,返回 QMetaObject 对象,用于反射(如获取对象类名、属性列表、信号槽信息)。
className ():获取对象的类名称(字符串),如obj.className()返回 "QPushButton",识别对象类型。
inherits ():判断对象是否继承自指定类,传入类名 / 类对象返回布尔值(如obj.inherits("QWidget")),校验对象的继承关系。
isWidgetType ():判断对象是否为 QWidget 子类(可视化控件),返回布尔值,区分可视化 / 非可视化对象。
isWindowType ():判断对象是否为窗口类(QWindow/QMainWindow 等),返回布尔值,识别窗口对象。
thread ():获取对象所属的线程,返回 QThread 对象,识别对象运行的线程环境。
moveToThread ():将对象移动到指定线程,传入 QThread 对象,实现对象的跨线程操作(需遵循 Qt 线程规则)。