飞秋 FeiQ(局域网聊天软件)二次开发文档
作者:卢本陶
lubentao@tom.com
版权所有 侵权必究
FQ_SENDDATA_RESULT
描述的是在模块里发送数据返回的结果.
enum FQ_SENDDATA_RESULT
{
FQ_MODULE_SEND_DATA_RESULT_OK = 0,
FQ_MODULE_SEND_DATA_RESULT_FAILED = -1,
FQ_MODULE_SEND_DATA_RESULT_TIME_OUT = -2,
FQ_MODULE_SEND_DATA_RESULT_UNKNOWN_ERROR = -3,
FQ_MODULE_SEND_DATA_RESULT_NOT_EXIST = -4
};
Values:
FQ _MODULE_SEND_DATA_RESULT_OK
发送数据成功。
FQ _MODULE_SEND_DATA_RESULT_FAILED
发送数据失败.
FQ _MODULE_SEND_DATA_RESULT_TIME_OUT
发送数据超时.
FQ _MODULE_SEND_DATA_RESULT_UNKNOWN_ERROR
未知错误.
FQ _MODULE_SEND_DATA_RESULT_NOT_EXIST
结果不存在.说明对方没有此插件。
FQ_UI_TYPE
枚举描述在界面上的菜单位置.
enum FQ_UI_TYPE
{
FQ_UI_TYPE_TRAY_MENU = 0,
FQ_UI_TYPE_TREE_USERSEL = 1,
FQ_UI_TYPE_LIST_USERSEL = 2,
FQ_UI_TYPE_MORE_NOUSERSEL = 3,
FQ_UI_TYPE_MULTICHAT_LIST = 4,
FQ_UI_TYPE_SEARCHUSER_RESULT = 5,
FQ_UI_TYPE_CUSTOMFACE_SEL = 6,
FQ_UI_TYPE_DAYCALENDER_SEL = 7,
FQ_UI_TYPE_DAYCLOCK_TIP = 8,
FQ_UI_TYPE_MAIN_ONLINESTATUS = 9,
FQ_UI_TYPE_QUN_SEL = 10,
FQ_UI_TYPE_CHAT_REPLY = 11,
FQ_UI_TYPE_QUNCHAT_REPLY = 12,
FQ_UI_TYPE_CHAT_SENDOPT = 13,
FQ_UI_TYPE_MULTICHAT_SENDOPT = 14,
FQ_UI_TYPE_QUNCHAT_SENDOPT = 15,
FQ_UI_TYPE_CHAT_PLUGIN = 16,
FQ_UI_TYPE_MULTICHAT_PLUGIN = 17,
FQ_UI_TYPE_QUNCHAT_PLUGIN = 18
};
Values:
FQ_UI_TYPE_TRAY_MENU
托盘菜单。
FQ_UI_TYPE_TREE_USERSEL
树型风格时,有用户选中时的菜单。
FQ_UI_TYPE_LIST_USERSEL
列表风格时,有用户选中时的菜单。
FQ_UI_TYPE_MORE_NOUSERSEL
无用户选中时的菜单,同时也是指更多功能菜单。
FQ_UI_TYPE_MULTICHAT_LIST
多人聊天对话框,用户列表右键菜单。
FQ_UI_TYPE_SEARCHUSER_RESULT
搜索用户结果时的右键菜单。
FQ_UI_TYPE_CUSTOMFACE_SEL
表情面板里选择了自定义表情后的右键菜单。
FQ_UI_TYPE_DAYCALENDER_SEL
日程提醒选择了一天的记事内容的右键菜单。
FQ_UI_TYPE_DAYCLOCK_TIP
日程提醒后提示框中的操作菜单。
FQ_UI_TYPE_MAIN_ONLINESTATUS
主面板上的在线状态菜单。
FQ_UI_TYPE_QUN_SEL
选择群名称后的右键菜单。
FQ_UI_TYPE_CHAT_REPLY
两个聊天时快捷回复菜单。
FQ_UI_TYPE_QUNCHAT_REPLY
群聊天时快捷回复菜单。
FQ_UI_TYPE_CHAT_SENDOPT
两个聊天时发送按钮旁边发送选项菜单。
FQ_UI_TYPE_MULTICHAT_SENDOPT
多个聊天时发送按钮旁边发送选项菜单。
FQ_UI_TYPE_QUNCHAT_SENDOPT
群聊天时发送按钮旁边发送选项菜单。
FQ_UI_TYPE_CHAT_PLUGIN
两个聊天时对话框中的插件按钮菜单。
FQ_UI_TYPE_MULTICHAT_PLUGIN
多人聊天时对话框中的插件按钮菜单。
FQ_UI_TYPE_QUNCHAT_PLUGIN
群聊天时对话框中的插件按钮菜单。
FQ_UI_ITEM_STATE
设置菜单项显示的状态
enum FQ_UI_ITEM_STATE
{
FQ_UI_ITEM_STATE_NORMAL = 0,
FQ_UI_ITEM_STATE_DISABLED = 1,
FQ_UI_ITEM_STATE_CHECKED = 2
};
Values:
FQ_UI_ITEM_STATE_NORMAL
菜单项的状态为正常。
FQ_UI_ITEM_STATE_ DISABLED
菜单项的状态为不可使用。
FQ_UI_ITEM_STATE_ CHECKED
菜单项的状态为 Checked。
FQ_MENU_ITEM_SEPARATOR
添加菜单的分隔符
enum FQ_MENU_ITEM_SEPARATOR
{
FQ_MENU_ITEM_SEPARATOR_NONE = 0,
FQ_MENU_ITEM_SEPARATOR_ABOVE = 1,
FQ_MENU_ITEM_SEPARATOR_BELOW = 2,
FQ_MENU_ITEM_SEPARATOR_ABOVE_AND_BELOW = 3
};
Values:
FQ_MENU_ITEM_SEPARATOR_NONE
在添加的菜单项上下面都不添加分隔符。
FQ_MENU_ITEM_SEPARATOR_ABOVE
在添加的菜单项上面添加分隔符.
FQ_MENU_ITEM_SEPARATOR_BELOW
在添加的菜单项的下面添加分隔符.
FQ_MENU_ITEM_SEPARATOR_ABOVE_AND_BELOW
在添加的菜单项的上面下面都添加分隔符.
FQ_BEFORERECVMSG_RESULT
接收信息之前处理结果
enum FQ_BEFORERECVMSG_RESULT
{
FQ_BEFORERECVMSG_RESULT_NORMAL = 0,
FQ_BEFORERECVMSG_RESULT_BLOCK_ALL = -1,
FQ_BEFORERECVMSG_RESULT_BLOCK_SAVELOG = -2,
FQ_BEFORERECVMSG_RESULT_BLOCK_SHOWTIP = -3,
FQ_BEFORERECVMSG_RESULT_BLOCK_SAVELOG_SHOWTIP = -4
};
Values:
FQ_BEFORERECVMSG_RESULT_NORMAL
正常
FQ_BEFORERECVMSG_RESULT_BLOCK_ALL
阻止信息显示,不保存至日志,不消息框提示
FQ_BEFORERECVMSG_RESULT_BLOCK_SAVELOG
阻止信息显示,但保存至日志,不消息框提示
FQ_BEFORERECVMSG_RESULT_BLOCK_SHOWTIP
阻止信息显示,但消息框提示信息内容,不保存至日志
FQ_BEFORERECVMSG_RESULT_BLOCK_SAVELOG_SHOWTIP
阻止信息显示,但保存至日志,同时消息框提示信息内容
_IFQRootEvents
响应用户上线或下线及皮肤颜色改变的事件
OnUserEnter 用户上线事件
OnUserExit 用户下线事件
OnSkinChange 皮肤颜色改变事件
BeforeRecvMsg 接收到消息之前触发此事件
OnFolderBarChange 主对话框抽屉栏改变事件
_IFQRootEvents::OnUserEnter
当有用户上线时,激发此事件
Parameters:
userMemoName
[in] 用户的备注名 为 BSTR类型
userNickName
[in] 用户名 为 BSTR类型
userHostName
[in] 用户的主机名 为 BSTR类型
userGroupName
[in] 用户的主机名 为 BSTR类型
userIP
[in] 用户的 IP 为 BSTR类型
userMAC
[in] 用户的MAC 为 BSTR类型
Return Values
S_OK:方法调用成功
E_FAIL:方法调用失败
_IFQRootEvents::OnUserExit
当有用户下线时,激发此事件
Parameters:
userMemoName
[in] 用户的备注名 为 BSTR类型
userNickName
[in] 用户名 为 BSTR类型
userHostName
[in] 用户的主机名 为 BSTR类型
userLoginName
[in] 用户的登录名 为 BSTR类型
userMemoGroupName
[in] 用户的备注组名 为 BSTR类型
userGroupName
[in] 用户的主机名 为 BSTR类型
userIP
[in] 用户的 IP 为 BSTR类型
userMAC
[in] 用户的MAC 为 BSTR类型
Return Values
S_OK:方法调用成功
E_FAIL:方法调用失败
_IFQRootEvents::OnSkinChange
当皮肤颜色改变时,激发此事件
Parameters:
clrFrame
[in]边框的颜色,为 OLE_COLOR类型
clrFont
[in]字体的颜色,为 OLE_COLOR类型
clrLeftTop
[in]渐变左上角的颜色,为 OLE_COLOR类型
clrRightBtm
[in]渐变右下角的的颜色,为 OLE_COLOR类型
Return Values
S_OK:方法调用成功
E_FAIL:方法调用失败
_IFQRootEvents:: BeforeRecvMsg
当皮肤颜色改变时,激发此事件
Parameters:
userMemoName
[in] 发送信息用户的备注名 为 BSTR类型
userHostName
[in] 发送信息用户的主机名 为 BSTR类型
userLoginName
[in] 发送信息用户的登录名 为 BSTR类型
userMemoGroupName
[in] 发送信息用户的备注组名 为 BSTR类型
userGroupName
[in] 发送信息用户的主机名 为 BSTR类型
userIP
[in] 发送信息用户的 IP 为 BSTR类型
userMAC
[in] 发送信息用户的MAC 为 BSTR类型
sendMsgContent
[in] 发送信息的内容 为 BSTR类型
font
[in] 发送信息的字体格式,如没有,则为空。为 BSTR类型
pResult
[out,retval] 接收信息后的处理结果。为 FQ_BEFORERECVMSG_RESULT 枚举型。
Return Values
S_OK:方法调用成功
E_FAIL:方法调用失败
_IFQRootEvents:: OnFolderBarChange
主对话框抽屉栏改变事件
Parameters:
nBeforeBarIndex
[in] 改变前的抽屉栏索引 为 LONG类型
nNowBarIndex
[in] 现在的抽屉栏索引 为 LONG类型
Return Values
S_OK:方法调用成功
E_FAIL:方法调用失败
_IFQModuleSiteEvents
响应模块数据发送及接收事件
OnDataReceived 当接收到数据包的时候,激发此事件
OnViewData 当在 OnDataReceived 中,没有将 Key中的数据包从队列中删除的话,将弹出
一个提示框,用户点击提示框的按钮时,将触发 OnViewData事件
OnSendDataResult当发送数据后,有返回结果的时候,激发此事件
_IFQModuleSiteEvents::OnDataReceived
当接收到数据包的时候,激发此事件
Parameters:
Key
[in] 数据包的关键字,根据 Key可以从接收队列中,取得当前的数据包,为 BSTR类型
Return Values
S_OK:方法调用成功
E_FAIL:方法调用失败
_IFQModuleSiteEvents::OnViewData
当在 OnDataReceived 中,没有将 Key中的数据包从队列中删除的话,将弹出一个提示框,
用户点击提示框的按钮时,将触发 OnViewData事件
Parameters:
Key
[in] 数据包的关键字,根据 Key可以从接收队列中,取得当前的数据包,为 BSTR类型
Result
[in] 用户点击提示框中的结果,如用户点击了提示框中的“确定”按钮,将返加“确定”字
符串值。为 BSTR类型
Return Values
S_OK:方法调用成功
E_FAIL:方法调用失败
_IFQModuleSiteEvents::OnSendDataResult
当发送数据后,有返回结果的时候,激发此事件
Parameters:
Sender
[in] 发送者的 IP值,为 BSTR类型
Key
[in] 数据包的关键字,为 BSTR类型
nResult
[in] 发送数据的返回结果,可参考 FQ_SENDDATA_RESULT 类型.
Return Values
S_OK:方法调用成功
E_FAIL:方法调用失败
IFQRoot
接口相当于一把开启 FEIQ SDK大门的钥匙,其它的 SDK 对象接口大部分都经由 IFQRoot
对象接口获得。
Module 根据模块的标志符获取相应模块
Version 当前程序的版本号
OnlineBuddys 得到当前所有在线好友
GroupBuddys得到所在组的在线好友
UserBuddy 通过 IP地址得到好友的信息
UserCustomConfig 得到用户自定义配置数据
CurWorkDirectory 得到当前程序的工作路径
SendBuddyMessage 给好友发送信息及文件
UserSelector 选择用户
ShowBuddyChatDialog 弹出好友聊天对话框
RefreshBuddys 刷新好友
MainWndHandle 得到主窗口的对话框句柄
IFQRoot:: Module
根据模块的标志符获取相应模块
Parameters:
Identifier
[in] 模块的标志符,为 BSTR类型
pVal
[in] 返回模块的 IDispatch*值.
当 Identifier 的值为
FeiQ.ClientObjects时,返回 IClientObjectsModule 接口
FeiQ. Menu时,返回 IFQMenu 接口
FeiQ.Calendar时,返回 I FQCalendare 接口
FeiQ.Tools时,返回 I FQTools 接口
Return Values
S_OK:方法调用成功
E_FAIL:方法调用失败
IFQRoot:: SendBuddyMessage
给好友发送信息及文件
Parameters:
sendBuddyIPs
[in] 发送好友的 IP地址, 为 BSTR类型。如要发送给多个好友,多个好友之间的 IP地址用 “|”
隔开.如要给两个发送时,可为 192.168.0.1|192.168.0.2
sendContent
[in] 要发送的内容, 为 BSTR类型
sendFiles
[in] 要发送的文件名, 为 BSTR 类型。如要发送多个文件或文件夹时,名称之间用 “|” 隔开.
如 c:\1.txt|d:\feiq|d:\a.doc
Return Values
S_OK:方法调用成功
S_FALSE:方法调用失败
IFQRoot:: UserSelecto
选择用户
Parameters:
DlgCaption
[in] 设置选择用户对话框的标题,如为空,是默认为 “请选择用户”
InitSelBuddys
[in] 初始化要选择的用户,如为空,则默认情况上全部不选中。如为 “all”, 则默认情况下
全部都选中。如只选择部分好友,则格式如: 192.168.0.1|192.168.0.2
SelGroupName
[in] 只显示该组名称的用户,如为空,则显示全部组的用户
NeedSelNum
[in] 必须要选择的好友数
bMustUseFeiQ
[in] 如为 VARIANT_TRUE时,是只显示正在用飞秋的用户,相反,则显示全部用户包括用
飞鸽的用户。
pVal
[out,retval] 返回选择的好友 IP,如有多个好友,中间用 “|” 隔开。
Return Values
S_OK:方法调用成功
S_FALSE:方法调用失败
IFQModule
FEIQ模块的接口函数;FEIQ模块是插件的基础,插件接口就是从模块接口继承,所以在实
现插件的时候,必须先实现如下的接口。
Identifier获取模块的 Identifier标识
Name获取模块的名字
Description获取模块的描述
Author获取编写此模块的作者名称
ModuleSite获取模块相应的ModuleSite接口可以收发模块数据以及存储模块数据
OnLoad当内核开始加载模块的时候,内核会先调用此函数。
OnUnload当内核即将卸载模块的时候,内核会先调用此函数。
OnConfig当在插件管理面板中,用户选择此模块,进行设置时,会调用此函数。用户可在
这函数中实现对插件功能的设置,及设置参数的保存及读取。
IFQModuleSite
SendData向指定接收者发送模块数据
GetData根据 Key 获取相应的模块数据
FQRoot得到 FQRoot接口
IFQModuleSite::SendData
向指定接收者发送模块数据
Parameters:
ReceiversIP
[in] 接收者 IP地址(如发送给多人时,用 | 隔开)格式如: 192.168.0.1|192.168.0.2|192.168.0.3
pData
[in] 待发送的模块数据
Return Values
S_OK:方法调用成功
S_FALSE:方法调用失败
IFQModuleSite::GetData
根据 Key 获取相应的模块数据
Parameters:
Key
[in] 模块数据 Key
Remove
[in] 否将此模块数据从内核模块数据队列里取出并删除
ppData
[out,retval] 包含模块数据的 IFQData* 接口类型的指针
Return Values
S_OK:方法调用成功
S_FALSE:方法调用失败
IClientObjectsModule
提供给第三方开发者调用其内部包含的独立对象的接口.
Object 返回模块内的独立对象的接口
Parameters:
Identifier
[in] 模块的标志符,为 BSTR类型
pVal
[in] 返回模块的 IDispatch*值.
当 Identifier 的值为
FQCMenu时,返回 IFQMenu 接口
Return Values
S_OK:方法调用成功
E_FAIL:方法调用失败
IFQUICommand
相当于实现一个接收器,菜单弹出的时候 FEIQ就会调用传入的接收器的相应的函数
OnInvoke 在点击菜单某一个菜单项的时候,就会调用
OnQueryState 在菜单弹出前会被调用,用来修改菜单项状态
IFQUICommand:: OnInvoke
在点击菜单某一个菜单项的时候,就会调用
Parameters:
UIType
[in] 菜单项类型
Id
[in] 被点击的菜单项的 Id
Parameter
[in] 那么当这个菜单项被点击的时候,这个 Parameter参数会传递相关信息
[Parameter传递的参数注解]
UIType值为 FQ_UI_TYPE_TRAY_MENU时, Parameter为 VT_EMPTY
UIType值为 FQ_UI_TYPE_TREE_USERSEL时,Parameter为 FQDataCollection对象
如果选择的是组名称的时候,FQDataCollection集合中包含一个 FQData对象,FQData对象
中包含如下信息:
FQDK_SEL_ISGROUP 选择的是否为组 LONG型, TRUE 或 FALSE
FQDK_SEL_AUTOGROUP 是否为自动分组 LONG型, TRUE 或 FALSE
FQDK_SEL_GROUPNAME 组名称 String型
如果选择的是用户或多个用户的时候,FQDataCollection 集合中包含一个或多个 FQData 对
象,FQData对象中包含如下信息:
FQDK_SEL_ISGROUP 选择的是否为组 LONG型, TRUE 或 FALSE
FQDK_USER_MEMONAME 选择的用户的备注名 String型
FQDK_USER_HOSTNAME 选择的用户的主机名 String型
FQDK_USER_IP 选择的用户的 IP String型
FQDK_USER_MAC 选择的用户的MAC String型
FQDK_USER_LOGINNAME 选择的用户的登录名 String型
FQDK_USER_MEMOGROUP 选择的用户的备注组名 String型
FQDK_USER_GROUP 选择的用户的组名 String型
FQDK_USER_NAME 选择的用户的名称 String型
FQDK_USER_VERSION 选择的用户的版本 String型
IType 值 为 FQ_UI_TYPE_LIST_USERSEL 、 FQ_UI_TYPE_MULTICHAT_LIST 、
FQ_UI_TYPE_SEARCHUSER_RESULT 、 FQ_UI_TYPE_MULTICHAT_SENDOPT 、
FQ_UI_TYPE_CHAT_SENDOPT 、 FQ_UI_TYPE_CHAT_PLUGIN 、
FQ_UI_TYPE_MULTICHAT_SENDOPT、FQ_UI_TYPE_MULTICHAT_PLUGIN时,
Parameter为 FQDataCollection对象
FQDataCollection集合中包含一个或多个 FQData对象,FQData对象中包含如下信息:
FQDK_SEL_ISGROUP 选择的是否为组 LONG型, TRUE 或 FALSE
FQDK_USER_MEMONAME 选择的用户的备注名 String型
FQDK_USER_HOSTNAME 选择的用户的主机名 String型
FQDK_USER_IP 选择的用户的 IP String型
FQDK_USER_MAC 选择的用户的MAC String型
FQDK_USER_LOGINNAME 选择的用户的登录名 String型
FQDK_USER_MEMOGROUP 选择的用户的备注组名 String型
FQDK_USER_GROUP 选择的用户的组名 String型
FQDK_USER_NAME 选择的用户的名称 String型
IType 值为 FQ_UI_TYPE_DAYCLOCK_TIP 时,Parameter 为 FQDataCollection 对象 ,
FQDataCollection集合中包含一个 FQData对象,FQData对象中包含如下信息:
FQDK_CLOCK_DAYKEY 提醒的时间 KEY,如 2008-08-08##08:00:00 String型
IType 值为 FQ_UI_TYPE_DAYCALENDER_SEL 时,Parameter 为 FQDataCollection 对象,
FQDataCollection集合中包含一个 FQData对象,FQData对象中包含如下信息:
FQDK_DAY_SELDATE 选择的日期,如 2008-08-08 String型
IType 值为 FQ_UI_TYPE_CUSTOMFACE_SEL 时,Parameter 为 FQDataCollection 对象,
FQDataCollection集合中包含一个 FQData对象,FQData对象中包含如下信息:
FQDK_FACE_SELPATHNAME 选择的表情所在的路径 String型
Return Values
S_OK:方法调用成功
S_FALSE:方法调用失败
IFQUICommand:: OnQueryState
在菜单弹出前会被调用,用来修改菜单项状态等
Parameters:
UIType
[in] 菜单项类型
Id
[in] 被点击的菜单项的 Id
Parameter
[in] 那么当这个菜单项被点击的时候,这个 Parameter参数会传递相关信息
Text
[in] 在这里可以设置菜单项要显示的文字
State
[in] 可以设置菜单项的状态,具体可以参见 FQ_UI_ITEM_STATE
Return Values
S_OK:方法调用成功
S_FALSE:方法调用失败
IFQMenu
提供动态的注册、插入、删除自定义菜单项的功能。
AddItem 添加一个自定义菜单项
DelItem添加一个自定义菜单项
IFQMenu:: AddItem
添加一个自定义菜单项
Parameters:
Type
[in] 菜单项类型
menuPosName
[in] 要插入的位置的菜单名称。为空是插入菜单最后面
FQUICommand
[in] 实现对菜单项操作的响应,控制菜单项状态等
Text
[in] 菜单项上要显示的文字.
形式如 ||测试 Group||@@||测试 其中 || 和 @@ 可选。
|| 表示分隔符
在名称前加 || 表示在添加的菜单项上面添加分隔符.
在名称前后 || 表示在添加的菜单项下面添加分隔符.
@@ 是上下级菜单的关系。
上例中测试菜单的父菜单是测试 Group。当测试 Group不存在时,程序会自动创建这组菜单。
Level
[in] 菜单项的权值,权值越大,加载到菜单越下,如果权值相同,先加载就在上面
Id
[out, retval] 程序会自动给菜单分配一唯一的 ID,返回菜单唯一 ID值
Return Values
S_OK:方法调用成功
S_FALSE:方法调用失败
IFQMenu::DelItem
删除一个自定义菜单项
Parameters:
Type
[in] 菜单项类型
ID
[in] 菜单的 ID
FQUICommand
[in] 实现对菜单项操作的响应,控制菜单项状态等
Return Values
S_OK:方法调用成功
S_FALSE:方法调用失败
IFQData
设置或者获取某个 Key(任意字符串)对应的数据(数字、字符串、Buffer、IFQData、
IFQDataCollection),实现任意数据的容器。
SetLong保存整数型的数值
GetLong得到整数型的数值
SetString保存字符串的数值
GetString得到字符串的数值
SetDouble保存符点型的数值
GetDouble得到符点型的数值
SetBuffer保存二进制型的数值
GetBufferLength得到二进制型的长度
GetBuffer得到二进制型的数值
SetFQData保存 IFQData对象
GetFQData得到 IFQData对象值
SetObject保存 Object对象
GetObject得到 Object对象值
SetFQDataCollection保存 IFQDataCollection 对象
GetFQDataCollection得到 IFQDataCollection 对象值
XML与 XML的相互转换
Count得到 FQData此对象中所有的个数
GetItem枚举每一项的值
RemoveKey删除某一项的值
IFQDataCollection
作为 IFQData
集合对象,用于存放一个或多个 IFQData,此集合可增删 IFQData,并
提供方便的遍历操作.
Item 得到一个 IFQData对象
Count得到集合中对象的个数
Add向集合中添加一个 IFQData对象
Remove向集合中删除一个 IFQData对象
XML 与 XML的相互转换
IFQBuddyCollection
作为 IFQBuddy 标准集合对象,用于存放一个或多个 IFQBuddy,此集合可增删 IFQBuddy,
并提供方便的遍历操作.
Item 得到一个 IFQBuddy对象
Count得到集合中对象的个数
Add向集合中添加一个 IFQBuddy对象
Remove向集合中删除一个 IFQBuddy对象
IFQBuddy
好友对象,用来存放好友的用户名,IP,组等相关信息
MarkName 备注名
Name用户名
MarkGroupName备注组名
GroupName组名
HostName主机名
LoginName登录名
MacAddress MAC地址
nPortNo 端口地址
IPAddress IP地址(ULONG型)
IPValue IP地址(字符串型)
Sign个性签名
Version版本号
FaceImage 头像索引
IFQFolderBar
主界面上的抽屉栏目对象。
AddBar 增加一个抽屉栏目
IFQFolderBar:: AddBar
增加一个抽屉栏目
Parameters:
Name
[in] 栏目的名称
pWnd
[in] 要增加栏目的对话框的句柄
pVal
[out,retval] 返回增加的位置次序 ID
Return Values
S_OK:方法调用成功
S_FALSE:方法调用失败
IFQCalendar
日程安排与提示对象
IsLeapYear 是否为闰年
WeekDay计算对应是星期几,返回值 0代表周日,1-6分别代表周一至周六
MonthDays返回公历某年某月的天数
LunarMonthDays返回农历某年某月的天数
LunarYearDays返回农历某年的天数
GetLeapMonth返回农历某年的闰月月份,如没有返回 0
FormatLunarYear把农历某年格式化成天干记年法表示的字符串,如戊子 鼠年
FormatMonth把某月格式化成中文字符串,如公历为一月,农历为正月
FormatLunarDay把农历某日格式化成中文字符串,如初八
CalcDateDiff计算公历两个日期间相差的天数
GetLunarDate计算公历某年某月某日对应的农历日期,返回对应的农历节气 0-24 0不是节气
GetCalendarDate通过农历求公历
CalcSpansLunarDate计算从某日开始过几天后的农历日期
CalcLunarDateDiff计算农历两个日期间相差的天数
CalcSpansCalendarData计算从某日开始过几天后的公历日期
GetLunarHolDay计算公历某年某月某日对应的节气 0-24,0表不是节气
FormatDayInfo得到公历某日的格式化表达式,有节气时显示节气,没有时显示农历日期
GetDayPlan得到日程安排提醒中某日的记事内容
SetDayPlan设置日程安排提醒中某日的记事内容
DelDayPlan删除日程安排提醒中某日的记事内容
GetDayAllClockTimes得到日程安排提醒中某日的所有提醒时间字符串,格式如:
2008-08-08##08:00:00|2008-08-08##23:30:00 (多个之间用|分开)
GetDayClock通过年月日时分秒获取该提醒的信息
SetDayClock设置某年月日时分秒时要提醒的信息
DelDayClock删除某年月日时分秒时要提醒的信息
UpdateDay在界面上更新某日的信息内容
IFQCalendar:: SetDayClock
设置某年月日时分秒时要提醒的信息
Parameters:
nYear
[in]年
nMonth
[in]月
nDay
[in]日
nHour
[in]时
nMinute
[in]分
nSecond
[in]秒
bTip
[in]是否出现提示窗口
bstrTip
[in]提示内容
bRun
[in]是否提醒时直接运行程序
bstrRun
[in]程序名称或命令内容
bstrParam
[in]命令参数
bSaveImmediate
[in]是否立即保存设置
IFQTool
工具类
BuildGUID 产生一个随机的 GUID
RunCommand 运行一个命令或程序
MakeSpellCode 生成字符的拼音代码
Md5Encode md5加密
IFQCalendar:: MakeSpellCode
生成字符的拼音代码
Parameters:
bstrText
[in] 要生成拼音的中文字符
nMode
[in] 为 0时,只取各个汉字声母的第一个字母;为 1时,全取
bstrResult
[out, retval]返回的拼音
说明:
注:更多帮助可上飞秋论坛查看讨论。http://www.feiq18.com