mirror of
https://github.com/zhongyang219/TrafficMonitor.git
synced 2026-10-17 05:07:21 +08:00
zhongyang219
617 lines
23 KiB
C++
617 lines
23 KiB
C++
/*********************************************************
|
||
* TrafficMonitor 插件接口
|
||
* Copyright (C) by Zhong Yang 2021
|
||
* zhongyang219@hotmail.com
|
||
**********************************************************/
|
||
#pragma once
|
||
|
||
class IPluginDrawer;
|
||
|
||
//插件显示项目的接口
|
||
class IPluginItem
|
||
{
|
||
public:
|
||
/**
|
||
* @brief 获取显示项目的名称
|
||
* @return const wchar_t*
|
||
*/
|
||
virtual const wchar_t* GetItemName() const = 0;
|
||
|
||
/**
|
||
* @brief 获取显示项目的唯一ID
|
||
* @return const wchar_t*
|
||
*/
|
||
virtual const wchar_t* GetItemId() const = 0;
|
||
|
||
/**
|
||
* @brief 获取项目标签的文本
|
||
* @return const wchar_t*
|
||
*/
|
||
virtual const wchar_t* GetItemLableText() const = 0;
|
||
|
||
/**
|
||
* @brief 获取项目数值的文本
|
||
* @detail 由于此函数可能会被频繁调用，因此不要在这里获取监控数据，
|
||
* 而是在ITMPlugin::DataRequired函数中获取数据后保存起来，然后在这里返回获取的数值
|
||
* @return const wchar_t*
|
||
*/
|
||
virtual const wchar_t* GetItemValueText() const = 0;
|
||
|
||
/**
|
||
* @brief 获取项目数值的示例文本
|
||
* @detail 此函数返回的字符串的长度会用于计算显示区域的宽度
|
||
* @return const wchar_t*
|
||
*/
|
||
virtual const wchar_t* GetItemValueSampleText() const = 0;
|
||
|
||
/**
|
||
* @brief 显示区域是否由插件自行绘制
|
||
* @detail
|
||
* 如果返回false，则根据GetItemLableText和GetItemValueText返回的文本由主程序绘制显示区域，重写DrawItem函数将不起作用。
|
||
* 如果重写此函数并返回true，则必须重写DrawItem函数并在里面添加绘制显示区域的代码，
|
||
* 此时GetItemLableText、GetItemValueText和GetItemValueSampleText的返回值将被主程序忽略
|
||
* @return bool
|
||
*/
|
||
virtual bool IsCustomDraw() const { return false; }
|
||
|
||
/**
|
||
* @brief 获取显示区域的宽度
|
||
* @detail
|
||
* 只有当CustomDraw()函数返回true时重写此函数才有效。
|
||
* 返回的值为DPI为96（100%）时的宽度，主程序会根据当前系统DPI的设置自动按比例放大，
|
||
* 因此你不需要为不同的DPI设置返回不同的值。
|
||
* 需要注意的是，这里的返回值代表了自绘区域所需要的最小宽度，DrawItem函数中的参数w的值可能会大于这个值
|
||
* @return int
|
||
*/
|
||
virtual int GetItemWidth() const { return 0; }
|
||
|
||
/**
|
||
* @brief 自定义绘制显示区域的函数，只有当CustomDraw()函数返回true时重写此函数才有效
|
||
* @param void * hDC 绘图的上下文句柄
|
||
* @param int x 绘图的矩形区域
|
||
* @param int y
|
||
* @param int w
|
||
* @param int h
|
||
* @param bool dark_mode 深色模式为true，浅色模式为false
|
||
* @return void
|
||
*/
|
||
virtual void DrawItem(void* hDC, int x, int y, int w, int h, bool dark_mode) {}
|
||
|
||
/**
|
||
* @brief 获取显示区域的宽度
|
||
* @detail
|
||
* 只有当CustomDraw()函数返回true时重写此函数才有效。
|
||
* 此函数和GetItemWidth不同，插件可以根据参数hDC来计算需要的宽度，
|
||
* 它返回的是实际的宽度，主程序不会根据当前系统的DPI对返回值进行放大。
|
||
* 需要注意的是，这里的返回值代表了自绘区域所需要的最小宽度，DrawItem函数中的参数w的值可能会大于这个值
|
||
* @param void * hDC 绘图的上下文句柄
|
||
* @return int
|
||
*/
|
||
virtual int GetItemWidthEx(void* hDC) const { return 0; }
|
||
|
||
/** 鼠标事件的类型 */
|
||
enum MouseEventType
|
||
{
|
||
MT_LCLICKED, /**< 点击了鼠标左键 */
|
||
MT_RCLICKED, /**< 点击了鼠标右键 */
|
||
MT_DBCLICKED, /**< 双击了鼠标左键 */
|
||
MT_WHEEL_UP, /**< 向上滚动了鼠标滚轮 */
|
||
MT_WHEEL_DOWN, /**< 向下滚动了鼠标滚轮 */
|
||
};
|
||
|
||
enum MouseEventFlag
|
||
{
|
||
MF_TASKBAR_WND = 1 << 0, /**< 是否为任务栏窗口的鼠标事件 */
|
||
};
|
||
|
||
/**
|
||
* @brief 当插件显示区域有鼠标事件时由主程序调用
|
||
* @param MouseEventType type 鼠标事件的类型
|
||
* @param int x 鼠标指针所在的x坐标
|
||
* @param int y 鼠标指针所在的y坐标
|
||
* @param void* hWnd 产生此鼠标事件的窗口的句柄（主窗口或任务栏窗口）
|
||
* @param int flag 为若干MouseEventFlag枚举常量的组合
|
||
* @return int 如果返回非0，则主程序认为插件已经对此鼠标事件作出了全部的响应，主程序将不会再对此鼠标事件做额外的响应。
|
||
* 例如当type为MT_RCLICKED时，如果程序返回0，则会弹出主程序提供的右键菜单；而返回非0时，主程序不会再做任何处理。
|
||
*/
|
||
virtual int OnMouseEvent(MouseEventType type, int x, int y, void* hWnd, int flag) { return 0; }
|
||
|
||
enum KeyboardEventFlag
|
||
{
|
||
KF_TASKBAR_WND = 1 << 0, /**< 是否为任务栏窗口的键盘事件 */
|
||
};
|
||
|
||
/**
|
||
* @brief 当插件显示区域有键盘事件时由主程序调用
|
||
* @param int key 按下的键
|
||
* @param bool ctrl 是否按下了Ctrl键
|
||
* @param bool shift 是否按下了Shift键
|
||
* @param bool alt 是否按下了Alt键
|
||
* @param void* hWnd 产生此键盘事件的窗口的句柄（主窗口或任务栏窗口）
|
||
* @param int flag 为若干KeyboardEventFlag枚举常量的组合
|
||
* @return int 如果返回非0，则主程序认为插件已经对此键盘事件作出了全部的响应，主程序将不会再对此键盘事件做额外的响应。
|
||
*/
|
||
virtual int OnKeboardEvent(int key, bool ctrl, bool shift, bool alt, void* hWnd, int flag) { return 0; }
|
||
|
||
enum ItemInfoType
|
||
{
|
||
|
||
};
|
||
//预留的接口
|
||
virtual void* OnItemInfo(ItemInfoType, void* para1, void* para2) { return 0; }
|
||
|
||
/**
|
||
* @brief 是否在在任务栏中显示此项目的资源占用图
|
||
* @return 1：显示，0：不显示
|
||
*/
|
||
virtual int IsDrawResourceUsageGraph() const { return 0; }
|
||
|
||
/**
|
||
* @brief 获取资源占用图的值。当IsDrawResourceUsageGraphType返回值不为0时有效
|
||
* @return float 资源占用图的值，范围为0.0~1.0。
|
||
*/
|
||
virtual float GetResourceUsageGraphValue() const { return 0.0; }
|
||
|
||
/**
|
||
* @brief 自定义绘制显示区域的函数，只有当CustomDraw()函数返回true时重写此函数才有效
|
||
* @param IPluginDrawer* pDrawer 用于插件绘图接口的的指针
|
||
* @param int x 绘图的矩形区域
|
||
* @param int y
|
||
* @param int w
|
||
* @param int h
|
||
* @param bool dark_mode 深色模式为true，浅色模式为false
|
||
* @return bool
|
||
*/
|
||
virtual bool DrawItemEx(IPluginDrawer* pDrawer, int x, int y, int w, int h, bool dark_mode) { return false; }
|
||
|
||
/**
|
||
* @brief 是否在任务中独占双行
|
||
* @return 1：是，0：否
|
||
*/
|
||
virtual int IsDoubleLineExclusive() const { return 0; }
|
||
};
|
||
|
||
class ITrafficMonitor;
|
||
|
||
///////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
//插件接口
|
||
class ITMPlugin
|
||
{
|
||
public:
|
||
/**
|
||
* @brief 插件接口的版本，仅当修改了插件接口时才会修改这里的返回值。
|
||
* @attention 插件开发者不应该修改这里的返回值，也不应该重写此虚函数。
|
||
* @return int
|
||
*/
|
||
virtual int GetAPIVersion() const { return 8; }
|
||
|
||
/**
|
||
* @brief 获取插件显示项目的对象
|
||
* @detail 一个插件dll可以提供多个实现IPluginItem接口的对象，对应多个显示项目。
|
||
* 当index的值大于或等于0且小于IPluginItem接口的对象的个数时，返回对象的IPluginItem接口的指针，其他情况应该返回空指针。
|
||
* 例如插件提供两个显示项目，则当index等于0或1时返回对应IPluginItem接口的对象，其他值时必须返回空指针。
|
||
* @param int index 对象的索引
|
||
* @return IPluginItem* 插件显示项目的对象
|
||
*/
|
||
virtual IPluginItem* GetItem(int index) = 0;
|
||
|
||
/**
|
||
* @brief 主程序会每隔一定时间调用此函数，插件需要在函数里获取一次监控的数据
|
||
*/
|
||
virtual void DataRequired() = 0;
|
||
|
||
/** 选项设置对话框的返回值 */
|
||
enum OptionReturn
|
||
{
|
||
OR_OPTION_CHANGED, /**< 选项设置对话框中更改了选项设置 */
|
||
OR_OPTION_UNCHANGED, /**< 选项设置对话框中未更改选项设置 */
|
||
OR_OPTION_NOT_PROVIDED /**< 未提供选项设置对话框 */
|
||
};
|
||
|
||
/**
|
||
* @brief 主程序调用此函数以打开插件的选项设置对话框
|
||
* @detail 此函数不一定要重写。如果插件提供了选项设置界面，则应该重写此函数，并在最后返回OR_OPTION_CHANGED或OR_OPTION_UNCHANGED。
|
||
* @param void * hParent 父窗口的句柄
|
||
* 返回值为OR_OPTION_NOT_PRVIDED则认为插件不提供选项设置对话框。
|
||
* @return ITMPlugin::OptionReturn
|
||
*/
|
||
virtual OptionReturn ShowOptionsDialog(void* hParent) { return OR_OPTION_NOT_PROVIDED; }
|
||
|
||
/** 插件信息的索引 */
|
||
enum PluginInfoIndex
|
||
{
|
||
TMI_NAME, /**< 名称 */
|
||
TMI_DESCRIPTION, /**< 描述 */
|
||
TMI_AUTHOR, /**< 作者 */
|
||
TMI_COPYRIGHT, /**< 版权 */
|
||
TMI_VERSION, /**< 版本 */
|
||
TMI_URL, /**< 主页 */
|
||
TMI_MAX /**< 插件信息的最大值 */
|
||
};
|
||
|
||
/**
|
||
* @brief 获取此插件的信息，根据index的值返回对应的信息
|
||
*/
|
||
virtual const wchar_t* GetInfo(PluginInfoIndex index) = 0;
|
||
|
||
/** 主程序的监控信息 */
|
||
struct MonitorInfo
|
||
{
|
||
unsigned long long up_speed{};
|
||
unsigned long long down_speed{};
|
||
int cpu_usage{};
|
||
int memory_usage{};
|
||
int gpu_usage{};
|
||
int hdd_usage{};
|
||
int cpu_temperature{};
|
||
int gpu_temperature{};
|
||
int hdd_temperature{};
|
||
int main_board_temperature{};
|
||
int cpu_freq{};
|
||
};
|
||
|
||
/**
|
||
* @brief 主程序调用此函数以向插件传递所有获取到的监控信息
|
||
*/
|
||
virtual void OnMonitorInfo(const MonitorInfo& monitor_info) {}
|
||
|
||
/**
|
||
* @brief 获取插件要在鼠标提示中显示的文本
|
||
*/
|
||
virtual const wchar_t* GetTooltipInfo() { return L""; }
|
||
|
||
enum ExtendedInfoIndex
|
||
{
|
||
EI_LABEL_TEXT_COLOR, //绘图的标签文本颜色
|
||
EI_VALUE_TEXT_COLOR, //绘图的数值文本颜色
|
||
EI_DRAW_TASKBAR_WND, //是否绘制任务栏窗口
|
||
|
||
//主窗口选项设置
|
||
EI_NAIN_WND_NET_SPEED_SHORT_MODE, //网速显示简洁模式
|
||
EI_MAIN_WND_SPERATE_WITH_SPACE, //数值和单位使用空格分隔
|
||
EI_MAIN_WND_UNIT_BYTE, //网速单位是否使用B（字节）
|
||
EI_MAIN_WND_UNIT_SELECT, //网速单位选择（0：自动，1：固定为KB/s，2：固定为MB/s）
|
||
EI_MAIN_WND_NOT_SHOW_UNIT, //不显示网速单位
|
||
EI_MAIN_WND_NOT_SHOW_PERCENT, //不显示百分号
|
||
|
||
//任务栏窗口设置
|
||
EI_TASKBAR_WND_NET_SPEED_SHORT_MODE, //网速显示简洁模式
|
||
EI_TASKBAR_WND_SPERATE_WITH_SPACE, //数值和单位使用空格分隔
|
||
EI_TASKBAR_WND_VALUE_RIGHT_ALIGN, //数值右对齐
|
||
EI_TASKBAR_WND_NET_SPEED_WIDTH, //网速数据宽度
|
||
EI_TASKBAR_WND_UNIT_BYTE, //网速单位是否使用B（字节）
|
||
EI_TASKBAR_WND_UNIT_SELECT, //网速单位选择（0：自动，1：固定为KB/s，2：固定为MB/s）
|
||
EI_TASKBAR_WND_NOT_SHOW_UNIT, //不显示网速单位
|
||
EI_TASKBAR_WND_NOT_SHOW_PERCENT, //不显示百分号
|
||
|
||
EI_CONFIG_DIR, //配置文件的目录
|
||
};
|
||
|
||
/**
|
||
* @brief 主程序调用此函数以向插件传递更多信息
|
||
* @param ExtendedInfoIndex index 信息的索引，用于区分向插件传递的信息
|
||
* @param const wchar_t* data 传递的数据
|
||
* @return void
|
||
*/
|
||
virtual void OnExtenedInfo(ExtendedInfoIndex index, const wchar_t* data) {}
|
||
|
||
/**
|
||
* @brief 获取插件的图标，HICON格式
|
||
*/
|
||
virtual void* GetPluginIcon() { return nullptr; }
|
||
|
||
/**
|
||
* @brief 获取插件的命令的数量
|
||
* @return int 插件的命令的数量
|
||
*/
|
||
virtual int GetCommandCount() { return 0; }
|
||
|
||
/**
|
||
* @brief 获取插件的命令名称
|
||
* @param int command_index 插件命令的索引（从0开始，小于GetCommandCount()的返回值）
|
||
* @return wchar_t* 插件命令的名称
|
||
*/
|
||
virtual const wchar_t* GetCommandName(int command_index) { return nullptr; }
|
||
|
||
/**
|
||
* @brief 获取插件的命令图标
|
||
* @param int command_index 插件命令的索引（从0开始，小于GetCommandCount()的返回值）
|
||
* @return void* 插件命令的图标，HICON格式
|
||
*/
|
||
virtual void* GetCommandIcon(int command_index) { return nullptr; }
|
||
|
||
/**
|
||
* @brief 执行一个插件命令时由框架调用
|
||
* @param int command_index 插件命令的索引（从0开始，小于GetCommandCount()的返回值）
|
||
* @param void* hWnd 发送此命令的窗口句柄
|
||
* @param void* para 预留参数
|
||
*/
|
||
virtual void OnPluginCommand(int command_index, void* hWnd, void* para) {}
|
||
|
||
/**
|
||
* @brief 获取插件命令是否处于勾选状态
|
||
* @param int command_index 插件命令的索引（从0开始，小于GetCommandCount()的返回值）
|
||
* @return 1：已勾选；0：未勾选
|
||
*/
|
||
virtual int IsCommandChecked(int command_index) { return false; }
|
||
|
||
/**
|
||
* @brief 插件初始化
|
||
* @detail 当插件被加载时被调用，传递ITrafficMonitor接口的指针。插件可以保存此指针以调用ITrafficMonitor接口中的函数
|
||
* @param pApp
|
||
*/
|
||
virtual void OnInitialize(ITrafficMonitor* pApp) {}
|
||
};
|
||
|
||
|
||
///////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
//主程序接口
|
||
class ITrafficMonitor
|
||
{
|
||
public:
|
||
/**
|
||
* @brief 获取此接口的版本。
|
||
* @attention 插件在调用ITrafficMonitor中的函数时需要先判断接口的版本
|
||
* @return int
|
||
*/
|
||
virtual int GetAPIVersion() = 0;
|
||
|
||
/**
|
||
* @brief 获取TrafficMonitor的版本。
|
||
* @return const wchar_t*
|
||
*/
|
||
virtual const wchar_t* GetVersion() = 0;
|
||
|
||
/** 主程序的所有监控信息 */
|
||
enum MonitorItem
|
||
{
|
||
MI_UP, /**< 上传速度 */
|
||
MI_DOWN, /**< 下载速度 */
|
||
MI_CPU, /**< CPU利用率 */
|
||
MI_MEMORY, /**< 内存利用率 */
|
||
MI_GPU_USAGE, /**< 显卡利用率 */
|
||
MI_CPU_TEMP, /**< CPU温度 */
|
||
MI_GPU_TEMP, /**< 显卡温度 */
|
||
MI_HDD_TEMP, /**< 硬盘温度 */
|
||
MI_MAIN_BOARD_TEMP, /**< 主板温度 */
|
||
MI_HDD_USAGE, /**< 硬盘利用率 */
|
||
MI_CPU_FREQ, /**< CPU频率 */
|
||
MI_TODAY_UP_TRAFFIC, /**< 今日上传流量 */
|
||
MI_TODAY_DOWN_TRAFFIC /**< 今日下载流量 */
|
||
};
|
||
|
||
/**
|
||
* @brief 获取一个主程序的监控信息的数值
|
||
* （ITMPlugin::OnMonitorInfo将被弃用）
|
||
* @param item 要获取监控信息的项目
|
||
* @return 获取到监控信息
|
||
*/
|
||
virtual double GetMonitorValue(MonitorItem item) = 0;
|
||
|
||
/**
|
||
* @brief 以字符串的形式获取一个主程序监控信息的数值
|
||
* @param item 要获取监控信息的项目
|
||
* @param is_main_window 是否为主窗口的数值
|
||
* @return 获取到监控信息
|
||
*/
|
||
virtual const wchar_t* GetMonitorValueString(MonitorItem item, int is_main_window = false) = 0;
|
||
|
||
/**
|
||
* @brief 显示一个通知消息
|
||
* @param strMsg 要显示的通知消息
|
||
*/
|
||
virtual void ShowNotifyMessage(const wchar_t* strMsg) = 0;
|
||
|
||
/**
|
||
* @brief 获取当前语言id
|
||
* @return 当前主程序的语言id
|
||
*/
|
||
virtual unsigned short GetLanguageId() const = 0;
|
||
|
||
/**
|
||
* @brief 获取配置文件目录
|
||
* @return 配置文件目录
|
||
*/
|
||
virtual const wchar_t* GetPluginConfigDir() const = 0;
|
||
|
||
/** 主程序DPI类型 */
|
||
enum DPIType
|
||
{
|
||
DPI_MAIN_WND, /**< 主窗口的DPI */
|
||
DPI_TASKBAR /**< 任务栏窗口的DPI */
|
||
};
|
||
|
||
/**
|
||
* @brief 获取主程序DPI
|
||
* @return 主程序DPI
|
||
*/
|
||
virtual int GetDPI(DPIType type) const = 0;
|
||
|
||
/**
|
||
* @brief 获取当前系统主题颜色
|
||
* @return COLORREF格式的颜色值
|
||
*/
|
||
virtual unsigned int GetThemeColor() const = 0;
|
||
|
||
/**
|
||
* @brief 获取当前语言的字符串资源
|
||
* @param str_id 字符串资源id
|
||
* @param str_section 字符串资源在ini文件中的段名称
|
||
* @return
|
||
*/
|
||
virtual const wchar_t* GetStringRes(const wchar_t* key, const wchar_t* section) = 0;
|
||
|
||
/**
|
||
* @brief 获取主窗口的句柄
|
||
* @return
|
||
*/
|
||
virtual void* GetMainWindowHwnd() = 0;
|
||
|
||
/**
|
||
* @brief 获取任务栏窗口的句柄。不显示任务栏窗口时，返回值为空
|
||
* @return
|
||
*/
|
||
virtual void* GetTaskbarWindowHwnd() = 0;
|
||
|
||
/**
|
||
* API Version
|
||
* 1 新增GetMainWindowHwnd、GetTaskbarWindowHwnd函数
|
||
*/
|
||
};
|
||
|
||
|
||
//插件绘图接口
|
||
class IPluginDrawer
|
||
{
|
||
public:
|
||
/**
|
||
* @brief 获取此接口的版本。
|
||
* @return int
|
||
*/
|
||
virtual int GetAPIVersion() = 0;
|
||
|
||
// 拉伸模式
|
||
enum StretchMode
|
||
{
|
||
STRETCH, /**< 拉伸，会改变比例 */
|
||
FILL, /**< 填充，不改变比例，会裁剪长边 */
|
||
FIT /**< 适应，不会改变比例，不裁剪 */
|
||
};
|
||
|
||
//对齐方式
|
||
enum Alignment
|
||
{
|
||
LEFT, /**< 左对齐 */
|
||
RIGHT, /**< 右对齐 */
|
||
CENTER, /**< 居中 */
|
||
};
|
||
|
||
/**
|
||
* @brief 在指定的矩形区域内绘制文本
|
||
* @param x 矩形区域的左侧坐标
|
||
* @param y 矩形区域的顶部坐标
|
||
* @param w 矩形区域的宽
|
||
* @param h 矩形区域的高
|
||
* @param lpszString 绘制的文本
|
||
* @param color 文本的颜色，格式为0xBBGGRR
|
||
* @param align 文本对齐方式
|
||
* @param multi_line 是否多行显示
|
||
* @param alpha 不透明度，0~255
|
||
*/
|
||
virtual void DrawWindowText(int x, int y, int w, int h, const wchar_t* lpszString, unsigned long color, Alignment align = Alignment::LEFT, bool multi_line = false, unsigned char alpha = 255) = 0;
|
||
|
||
/**
|
||
* @brief 设置绘图剪辑区域
|
||
* @param x 矩形区域的左侧坐标
|
||
* @param y 矩形区域的顶部坐标
|
||
* @param w 矩形区域的宽
|
||
* @param h 矩形区域的高
|
||
*/
|
||
virtual void SetDrawRect(int x, int y, int w, int h) = 0;
|
||
|
||
/**
|
||
* @brief 用纯色填充矩形
|
||
* @param x 矩形区域的左侧坐标
|
||
* @param y 矩形区域的顶部坐标
|
||
* @param w 矩形区域的宽
|
||
* @param h 矩形区域的高
|
||
* @param color 填充的颜色，格式为0xBBGGRR
|
||
* @param alpha 不透明度，0~255
|
||
*/
|
||
virtual void FillRect(int x, int y, int w, int h, unsigned long color, unsigned char alpha = 255) = 0;
|
||
|
||
/**
|
||
* @brief 绘制矩形边框
|
||
* @param x 矩形区域的左侧坐标
|
||
* @param y 矩形区域的顶部坐标
|
||
* @param w 矩形区域的宽
|
||
* @param h 矩形区域的高
|
||
* @param color 边框的颜色，格式为0xBBGGRR
|
||
* @param width 边框的线宽
|
||
* @param dot_line 是否为虚线
|
||
* @param alpha 不透明度，0~255
|
||
* @param radius 圆角半径，如果为0则为直角矩形
|
||
*/
|
||
virtual void DrawRectOutLine(int x, int y, int w, int h, unsigned long color, int width = 1, bool dot_line = false, unsigned char alpha = 255, int radius = 0) = 0;
|
||
|
||
/**
|
||
* @brief 绘制一个位图
|
||
* @param hbitmap 位图的句柄
|
||
* @param x 矩形区域的左侧坐标
|
||
* @param y 矩形区域的顶部坐标
|
||
* @param w 矩形区域的宽
|
||
* @param h 矩形区域的高
|
||
* @param stretch_mode 绘图的拉伸模式
|
||
* @param alpha 不透明度，0~255
|
||
*/
|
||
virtual void DrawBitmap(void* hbitmap, int x, int y, int w, int h, StretchMode stretch_mode = StretchMode::STRETCH, unsigned char alpha = 255) = 0;
|
||
|
||
/**
|
||
* @brief 绘制一个图标
|
||
* @param hIcon 图标的句柄
|
||
* @param x 矩形区域的左侧坐标
|
||
* @param y 矩形区域的顶部坐标
|
||
* @param w 矩形区域的宽
|
||
* @param h 矩形区域的高
|
||
*/
|
||
virtual void DrawIcon(void* hIcon, int x, int y, int w, int h) = 0;
|
||
|
||
/**
|
||
* @brief 计算一个字符串的的宽度和高度
|
||
* @param lpszString 字符串
|
||
* @param[out] w 字符串的宽度
|
||
* @param[out] h 字符串的高度
|
||
*/
|
||
virtual void GetTextExtent(const wchar_t* lpszString, int& w, int& h) = 0;
|
||
|
||
/**
|
||
* @brief 绘制一个线段
|
||
* @param x1 第1个点的x坐标
|
||
* @param y1 第1个点的y坐标
|
||
* @param x2 第2个点的x坐标
|
||
* @param y2 第2个点的7坐标
|
||
* @param color 颜色
|
||
* @param alpha 不透明度
|
||
*/
|
||
virtual void DrawLine(int x1, int y1, int x2, int y2, unsigned long color, int width = 1, bool dot_line = false, unsigned char alpha = 255) = 0;
|
||
|
||
/**
|
||
* @brief 获取GDI绘图的句柄
|
||
* @return HDC格式句柄
|
||
*/
|
||
virtual void* GetHDC() = 0;
|
||
};
|
||
|
||
|
||
/*
|
||
* 注意：插件dll需导出以下函数
|
||
* ITMPlugin* TMPluginGetInstance();
|
||
* 函数返回一个ITMPlugin接口的对象的指针。
|
||
* 此对象通常应该为一个全局或静态的对象，在程序运行结束前，它都不应该被释放。
|
||
*/
|
||
|
||
|
||
/*
|
||
* 更新记录：
|
||
* ITMPlugin
|
||
* -------------------------------------------------------------------------
|
||
* API version | 更新内容
|
||
* -------------------------------------------------------------------------
|
||
* 1 | 第一个版本
|
||
* -------------------------------------------------------------------------
|
||
* 2 | 新增 ITMPlugin::GetTooltipInfo 函数
|
||
* -------------------------------------------------------------------------
|
||
* 3 | 新增 IPluginItem::GetItemWidthEx, IPluginItem::OnMouseEvent 函数
|
||
* -------------------------------------------------------------------------
|
||
* 4 | 新增 IPluginItem::OnKeboardEvent IPluginItem::OnItemInfo 函数
|
||
* -------------------------------------------------------------------------
|
||
* 5 | 新增 ITMPlugin::GetCommandName ITMPlugin::GetCommandIcon ITMPlugin::OnPluginCommand 函数
|
||
* -------------------------------------------------------------------------
|
||
* 6 | 新增 IPluginItem::GetResourceUsageGraphType IPluginItem::GetResourceUsageGraphValue 函数
|
||
* -------------------------------------------------------------------------
|
||
* 7 | 新增 ITMPlugin::OnInitialize 函数
|
||
* -------------------------------------------------------------------------
|
||
* 8 | 新增 IPluginItem::DrawItemEx, IPluginItem::IsDoubleLineExclusive 函数
|
||
* -------------------------------------------------------------------------
|
||
*/
|