Event (酷Q SDK 帮助手册)

```
public interface Event
```

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`int`	`EVE_Disable()` 应用将被停用(Type=1004).
`void`	`EVE_DiscussMsg_EX(DiscussMsgEvent e)` 讨论组消息(Type=4).
`是否拦截`	`EVE_DiscussMsg(int subType, int msgId, long fromDiscuss, long fromQQ, string msg, int font)` 讨论组消息(Type=4).
`int`	`EVE_Enable()` 应用已被启用(Type=1003).
`int`	`EVE_Exit()` 酷Q退出(Type=1002).
`void`	`EVE_Friend_Add_EX(FriendAddEvent e)` 好友事件-好友已添加(Type=201).
`是否拦截`	`EVE_Friend_Add(int subType, int sendTime, long fromQQ)` 好友事件-好友已添加(Type=201).
`void`	`EVE_GroupMsg_EX(GroupMsgEvent e)` 群消息(Type=2).
`是否拦截`	`EVE_GroupMsg(int subType, int msgId, long fromGroup, long fromQQ, string fromAnonymous, string msg, int font)` 群消息(Type=2).
`是否拦截`	`EVE_GroupUpload(int subType, int sendTime, long fromGroup, long fromQQ, string file)` 群文件上传事件(Type=11).
`是否拦截`	`EVE_Menu()` 菜单.
`void`	`EVE_PrivateMsg_EX(PrivateMsgEvent e)` 私聊消息(Type=21).
`是否拦截`	`EVE_PrivateMsg(int subType, int msgId, long fromQQ, string msg, int font)` 私聊消息(Type=21).
`void`	`EVE_Request_AddFriend_EX(RequestAddFriendEvent e)` 请求-好友添加(Type=301).
`是否拦截`	`EVE_Request_AddFriend(int subType, int sendTime, long fromQQ, string msg, string responseFlag)` 请求-好友添加(Type=301).
`void`	`EVE_Request_AddGroup_EX(RequestAddGroupEvent e)` 请求-群添加(Type=302).
`是否拦截`	`EVE_Request_AddGroup(int subType, int sendTime, long fromGroup, long fromQQ, string msg, string responseFlag)` 请求-群添加(Type=302).
`int`	`EVE_Startup()` 酷Q启动事件(Type=1001).
`void`	`EVE_Status_EX(StatusEvent e)` 悬浮窗.
`string`	`EVE_Status()` 悬浮窗.
`void`	`EVE_System_GroupAdmin_EX(SystemGroupAdminEvent e)` 群事件-管理员变动(Type=101).
`是否拦截`	`EVE_System_GroupAdmin(int subType, int sendTime, long fromGroup, long beingOperateQQ)` 群事件-管理员变动(Type=101).
`是否拦截`	`EVE_System_GroupMemberDecrease(int subType, int sendTime, long fromGroup, long fromQQ, long beingOperateQQ)` 群事件-群成员减少(Type=102).
`是否拦截`	`EVE_System_GroupMemberIncrease(int subType, int sendTime, long fromGroup, long fromQQ, long beingOperateQQ)` 群事件-群成员增加(Type=103).
`string`	`MUST_AppInfo_RETURN()` 返回应用的ApiVer、Appid，打包后将不会调用.
`string`	`MUST_AppInfo()` 应用的ApiVer、Appid.

- 方法详细资料
  - MUST_AppInfo
```
string MUST_AppInfo()
```
    应用的ApiVer、Appid.
    请不要在本子程序添加其他代码
    
    返回:
    
    返回格式为: "ApiVer,AppID"
  - MUST_AppInfo_RETURN
```
string MUST_AppInfo_RETURN()
```
    返回应用的ApiVer、Appid，打包后将不会调用.
    MUST_AppInfo()的简化版本.
    例: MUST_AppInfo_RETURN("com.MikuPy2001.app")
    直接返回文本
    
    返回:
    
    自动返回相应文本
    
    另请参阅:
    
    MUST_AppInfo()
  - EVE_Startup
```
int EVE_Startup()
```
    酷Q启动事件(Type=1001).
    本子程序会在酷Q【主线程】中被调用。
    无论本应用是否被启用，本函数都会在酷Q启动后执行一次，请在这里执行插件初始化代码。
    请务必尽快返回本子程序，否则会卡住其他插件以及主程序的加载。
    名字如果使用下划线开头需要改成双下划线.
    
    返回:
    
    请固定返回 0.
  - EVE_Exit
```
int EVE_Exit()
```
    酷Q退出(Type=1002).
    本子程序会在酷Q【主线程】中被调用。
    无论本应用是否被启用，本函数都会在酷Q退出前执行一次，请在这里执行插件关闭代码。
    名字如果使用下划线开头需要改成双下划线。
    
    返回:
    
    请固定返回0，返回后酷Q将很快关闭，请不要再通过线程等方式执行其他代码。
  - EVE_Enable
```
int EVE_Enable()
```
    应用已被启用(Type=1003).
    当应用被启用后，将收到此事件。
    如果酷Q载入时应用已被启用，则在 EVE_Startup(Type=1001,酷Q启动) 被调用后，本函数也将被调用一次。
    如非必要，不建议在这里加载窗口。（可以添加菜单，让用户手动打开窗口）
    名字如果使用下划线开头需要改成双下划线。
    
    返回:
    
    请固定返回0。
  - EVE_Disable
```
int EVE_Disable()
```
    应用将被停用(Type=1004).
    当应用被停用前，将收到此事件。
    如果酷Q载入时应用已被停用，则本函数【不会】被调用。
    无论本应用是否被启用，酷Q关闭前本函数都【不会】被调用。
    
    返回:
    
    请固定返回0。
  - EVE_PrivateMsg
```
是否拦截 EVE_PrivateMsg(int subType,
                    int msgId,
                    long fromQQ,
                    string msg,
                    int font)
```
    私聊消息(Type=21).
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    subType - 子类型，11/来自好友 1/来自在线状态 2/来自群 3/来自讨论组
    
    msgId - 消息ID
    
    fromQQ - 来源QQ
    
    msg - 消息内容
    
    font - 此参数现在已经废弃
    
    返回:
    
    返回规定参考值.
  - EVE_PrivateMsg_EX
```
void EVE_PrivateMsg_EX(PrivateMsgEvent e)
```
    私聊消息(Type=21).
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    e - 事件对象
  - EVE_GroupMsg
```
是否拦截 EVE_GroupMsg(int subType,
                  int msgId,
                  long fromGroup,
                  long fromQQ,
                  string fromAnonymous,
                  string msg,
                  int font)
```
    群消息(Type=2).
    如果消息来自匿名者,fromQQ 固定为 80000000,可使用工具将 fromAnonymous 转换为匿名者信息
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    subType - 子类型，目前固定为1
    
    msgId - 消息ID
    
    fromGroup - 来源群号
    
    fromQQ - 来源QQ号
    
    fromAnonymous - 来源匿名者
    
    msg - 消息内容
    
    font - 此参数现在已经废弃
    
    返回:
    
    返回规定参考值.
  - EVE_GroupMsg_EX
```
void EVE_GroupMsg_EX(GroupMsgEvent e)
```
    群消息(Type=2).
    如果消息来自匿名者,isAnonymous() 返回 true, 可使用 getFromAnonymousInfo() 获取匿名者信息
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    e - 事件对象
    
    另请参阅:
    
    GroupMsgEvent.isAnonymous(), GroupMsgEvent.getFromAnonymousInfo(), AnonymousInfo
  - EVE_DiscussMsg
```
是否拦截 EVE_DiscussMsg(int subType,
                    int msgId,
                    long fromDiscuss,
                    long fromQQ,
                    string msg,
                    int font)
```
    讨论组消息(Type=4).
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    subType - 子类型，目前固定为1
    
    msgId - 消息ID
    
    fromDiscuss - 来源讨论组
    
    fromQQ - 来源QQ号
    
    msg - 消息内容
    
    font - 此参数现在已经废弃
    
    返回:
    
    返回规定参考值.
  - EVE_DiscussMsg_EX
```
void EVE_DiscussMsg_EX(DiscussMsgEvent e)
```
    讨论组消息(Type=4).
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    e - 事件对象
  - EVE_GroupUpload
```
是否拦截 EVE_GroupUpload(int subType,
                     int sendTime,
                     long fromGroup,
                     long fromQQ,
                     string file)
```
    群文件上传事件(Type=11).
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    subType - 子类型，目前固定为1
    
    sendTime - 发送时间(时间戳)
    
    fromGroup - 来源群号
    
    fromQQ - 来源QQ号
    
    file - 上传文件信息,需要转换为有效数据.
    
    返回:
    
    返回规定参考值.
  - EVE_System_GroupAdmin
```
是否拦截 EVE_System_GroupAdmin(int subType,
                           int sendTime,
                           long fromGroup,
                           long beingOperateQQ)
```
    群事件-管理员变动(Type=101).
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    subType - 子类型，1/被取消管理员 2/被设置管理员
    
    sendTime - 发送时间(时间戳)
    
    fromGroup - 来源群号
    
    beingOperateQQ - 被操作QQ
    
    返回:
    
    返回规定参考值.
  - EVE_System_GroupAdmin_EX
```
void EVE_System_GroupAdmin_EX(SystemGroupAdminEvent e)
```
    群事件-管理员变动(Type=101).
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    e - 事件对象
  - EVE_System_GroupMemberDecrease
```
是否拦截 EVE_System_GroupMemberDecrease(int subType,
                                    int sendTime,
                                    long fromGroup,
                                    long fromQQ,
                                    long beingOperateQQ)
```
    群事件-群成员减少(Type=102).
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    subType - 子类型，1/群员离开 2/群员被踢 3/自己(即登录号)被踢
    
    sendTime - 发送时间(时间戳)
    
    fromGroup - 来源群号
    
    fromQQ - 操作者QQ(仅子类型为2、3时存在)
    
    beingOperateQQ - 被操作QQ
    
    返回:
    
    返回规定参考值.
  - EVE_System_GroupMemberIncrease
```
是否拦截 EVE_System_GroupMemberIncrease(int subType,
                                    int sendTime,
                                    long fromGroup,
                                    long fromQQ,
                                    long beingOperateQQ)
```
    群事件-群成员增加(Type=103).
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    subType - 子类型，1/管理员已同意 2/管理员邀请
    
    sendTime - 发送时间(时间戳)
    
    fromGroup - 来源群号
    
    fromQQ - 操作者QQ(即管理员QQ)
    
    beingOperateQQ - 被操作QQ(即加群的QQ)
    
    返回:
    
    返回规定参考值.
  - EVE_Friend_Add
```
是否拦截 EVE_Friend_Add(int subType,
                    int sendTime,
                    long fromQQ)
```
    好友事件-好友已添加(Type=201).
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    subType - 子类型，目前固定为1
    
    sendTime - 发送时间(时间戳)
    
    fromQQ - 来源QQ
    
    返回:
    
    返回规定参考值.
  - EVE_Friend_Add_EX
```
void EVE_Friend_Add_EX(FriendAddEvent e)
```
    好友事件-好友已添加(Type=201).
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    e - 事件对象
  - EVE_Request_AddFriend
```
是否拦截 EVE_Request_AddFriend(int subType,
                           int sendTime,
                           long fromQQ,
                           string msg,
                           string responseFlag)
```
    请求-好友添加(Type=301). 如果要通过请求或者拒绝请求请查看相应函数
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    subType - 子类型，目前固定为1
    
    sendTime - 发送时间(时间戳)
    
    fromQQ - 来源QQ
    
    msg - 附言
    
    responseFlag - 反馈标识(处理请求用)
    
    返回:
    
    返回规定参考值.
    
    另请参阅:
    
    API.setFriendAddRequest(c.string, int, c.string)
  - EVE_Request_AddFriend_EX
```
void EVE_Request_AddFriend_EX(RequestAddFriendEvent e)
```
    请求-好友添加(Type=301). 本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    e - 事件对象
  - EVE_Request_AddGroup
```
是否拦截 EVE_Request_AddGroup(int subType,
                          int sendTime,
                          long fromGroup,
                          long fromQQ,
                          string msg,
                          string responseFlag)
```
    请求-群添加(Type=302).
    如果 subtype ＝ 1
    setGroupAddRequest (responseFlag, #请求_群添加, #请求_通过, 一些拒绝的理由)
    如果 subtype ＝ 2
    setGroupAddRequest (responseFlag, #请求_群邀请, #请求_通过, 一些拒绝的理由)
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    subType - 子类型，1/他人申请入群 2/自己(即登录号)受邀入群
    
    sendTime - 发送时间(时间戳)
    
    fromGroup - 来源群号
    
    fromQQ - 来源QQ
    
    msg - 附言
    
    responseFlag - 反馈标识(处理请求用)
    
    返回:
    
    返回规定参考值.
    
    另请参阅:
    
    API.setGroupAddRequest(c.string, int, int, c.string)
  - EVE_Request_AddGroup_EX
```
void EVE_Request_AddGroup_EX(RequestAddGroupEvent e)
```
    请求-群添加(Type=302).
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    e - 事件对象
  - EVE_Menu
```
是否拦截 EVE_Menu()
```
    菜单.
    可在 .json 文件中设置菜单数目、函数名
    如果不使用菜单，请在 .json 及此处删除无用菜单
    本子程序会在酷Q【主线程】中被调用。
    名字如果使用下划线开头需要改成双下划线
    
    返回:
    
    固定返回0.
  - EVE_Status
```
string EVE_Status()
```
    悬浮窗.
    请务必使用EX版本.
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    返回:
    
    base64_encode(Unpack.add(数据).add(数据单位).add(颜色).getAll());
  - EVE_Status_EX
```
void EVE_Status_EX(StatusEvent e)
```
    悬浮窗.
    请设置 e.data e.dataf e.color 其他函数保持不动即可
    本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize).
    名字如果使用下划线开头需要改成双下划线
    
    参数:
    
    e - 事件对象

接口 Event

方法概要

方法详细资料

MUST_AppInfo

MUST_AppInfo_RETURN

EVE_Startup

EVE_Exit

EVE_Enable

EVE_Disable

EVE_PrivateMsg

EVE_PrivateMsg_EX

EVE_GroupMsg

EVE_GroupMsg_EX

EVE_DiscussMsg

EVE_DiscussMsg_EX

EVE_GroupUpload

EVE_System_GroupAdmin

EVE_System_GroupAdmin_EX

EVE_System_GroupMemberDecrease

EVE_System_GroupMemberIncrease

EVE_Friend_Add

EVE_Friend_Add_EX

EVE_Request_AddFriend

EVE_Request_AddFriend_EX

EVE_Request_AddGroup

EVE_Request_AddGroup_EX

EVE_Menu

EVE_Status

EVE_Status_EX