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。

On this page