遨游插件开发参考

I. 基本介绍

一、插件类型

傲游插件类型由文件类型和界面元素类型2个方面同时定义(一)、插件文件类型

包括 Script(脚本)、HTML、COM、EXE(可执行文件)

1.Script

(1).可以是按钮类型，在点击按钮时执行脚本。脚本可以采用 IE 支持的脚本语言编写，比如 javascript 及vbscript。

此外 Maxthon 2.0 提供额外的 mscript 脚本执行方式，可以实现更强大插件功能。

Script 文件必须按以下形式写:

示例（例I-1-(1)_1 Script文件）：

引用

被IE支持的任何有效语言都可在此使用.

(2).亦可以是侧边栏类型，在侧边栏显示插件指定的 HTML 档案。

HTML 档案可以采用 IE 支持的 HTML 语言格式编写。

2.HTML

是 Maxthon 2.0 新添加的插件类型，和 Script 侧边栏插件性质相同，主要分别是 Script 侧边栏插件在侧边栏显示，而 HTML 插件则以按钮型式在工具栏显示。

可以采用任何 MSCOM 支持的语言编写，比如 C++，C#，Visual Basic，Delphi 等。Maxthon 默认支持按钮类型，工具栏类型及侧边栏类型 COM 插件。

另外，COM 插件亦可以自行添加拟采用的插件显现方式，比如菜单或弹出窗口。COM 对象必须实现IMyIEClient 接口. 具体实现请看SDK包里的 IMyIE.h

4.EXE

可以是任何可执行档案，以工具栏按钮形式在Maxthon 显现。Maxthon 可以在执行 EXE 插件是提供参数，比如页面地址及 Maxthon 窗口的句柄等。

任何win32可执行文件都可以做为插件. Maxthon 将根据不同的用途传递各种参数, 但不保证参数按顺序传递.

通用参数有:

General parameter:

a. "-h=handle" : handle是Maxthon 主窗口的hWnd句柄, 为10进制数字.

(二)、界面元素类型

包括 Button(按钮)、SideBar(侧边栏)、Toolbar(工具栏) 及 Other(其他)

1.Button

插件会在插件栏添加一个按钮，点击按钮时会执行指定由脚本 (Script 插件)，程序 (EXE 插件)，DLL (COM 类型插件)，指定的操作。Script 及 EXE类型按钮插件可以选择性在插件按钮添加下拉菜单。

2.SideBar

插件会在侧边栏添加一个按钮，及在主菜 > 查看 > 侧边栏添加一个命令，在执行时会打开侧边栏及显示插件指定的 HTML 页面。

3.Toolbar

插件会添加一个工具栏，新添加的工具栏可以在主

菜 > 查看 > 工具栏选择是否显示。

4.Other

插件没有固定显示接口，插件可以因应需要自行改变接口，比如改变菜单，添加按钮。

(三)、傲游插件类型支持情况

插件文件类型和界面元素类型的关系

表I-1-(3)_1

代码

类型__________Button___SideBar___Toolbar___Other Script_________支持_____支持

HTML(仅2.x)___支持

EXE___________支持

COM(仅1.x)____支持_____支持______支持_____支持

二、插件档案

傲游插件档案一般包含plugin.ini、运行文件、图标、config.html

(一)、plugin.ini（必须）

说明：定义插件的各项属性

示例（例I-2-(1)_1 全部）：

引用

[General]（必须,定义插件的主要属性）

Name=插件名称

Author=作者名字

Version=版本号

ModuleType=可以是 Script，HTML，COM 或 EXE

FileName=可以是 HTML 档案(Script 及HTML 插件)，DLL 档案 (COM 插件)，或 EXE 档案 (EXE 插件) Comments=在插件选项或按钮的工具提示所显示的描述

Type=可以是 M2Plugin_BUTTON，M2Plugin_SIDEBAR，M2Plugin_Toolbar 或 M2Plugin_Other

IdealSize=指定插件在接口显示的大小，比如“120 20”(阔度高度，适用于 HTML 插件)

IdealSizeVertical=选摘性，指定当工具栏在垂直放置的插件接口显示的大小，比如“120 20”(阔度高度，适用于 HTML 插件)

Icon=在按钮或侧边栏插件显示的图标 (适用于按钮及侧边栏插件)

HotIcon=当鼠标移到插件按钮上时显示的图标 (适用于按钮插件)

CLSID=COM 插件的 CLSID (适用于 COM 插件)

[MyIE2Buttons] （可选,定义按钮类型插件的下拉菜单，适用于 Script 及 EXE 类型插件）

Count=插件下拉菜单项目的数量

Name1=第一个下拉菜单项目的名称，如此类推

FileName1=提供第一个下拉菜单项目应执行的代码的档案，如此类推

例I-2-(1)_2.1 Script 类型=按钮

引用

[General]

Name=LastModified

Author=bloodchen

Version=1.0

ModuleType=SCRIPT

FileName=LastModified.htm

Comments=See last modified date of current page Type=M2Plugin_BUTTON

HotIcon=hot.ico

Icon=cold.ico

例I-2-(1)_2.2 Script 类型=侧边栏