message — 消息通知
在 IDE 中显示通知消息。
self.message 提供消息通知能力。所有插件类型可用(需声明 message 权限)。
方法
| 方法 | 说明 |
|---|---|
show(message, type?, callback?) | 显示指定类型的通知 |
info(message, callback?) | 显示信息通知 |
success(message, callback?) | 显示成功通知 |
warning(message, callback?) | 显示警告通知 |
error(message, callback?) | 显示错误通知 |
show(message, type?, callback?)
显示通知消息,type 决定外观。
self.message.show("操作完成", "success")参数:
message(str) — 消息文本type(str) — 消息类型:"info"、"success"、"warning"、"error",默认"info"callback(callable, 可选) — 完成后的回调
info(message, callback?)
显示信息通知。
self.message.info("插件已启动")success(message, callback?)
显示成功通知。
self.message.success("文件已保存")warning(message, callback?)
显示警告通知。
self.message.warning("磁盘空间不足")error(message, callback?)
显示错误通知。
self.message.error("连接失败")使用示例
class MyPlugin(UiPlugin):
def on_start(self):
self.message.info("插件已启动")
def on_dispose(self):
self.message.info("插件已停止")
def _save_data(self):
try:
# 保存逻辑
self.message.success("数据已保存")
except Exception as e:
self.message.error(f"保存失败: {e}")回调约定: 若传入 callback,它以关键字参数形式调用(如 callback(data=..., error=...))。未传入 callback 时,结果会被直接丢弃。回调运行在 Bridge 线程(非主/UI 线程),因此回调内不应直接操作 UI。