该接口类提供了修改 LPV 系统全局参数的功能和一些杂项帮助函数。更多...

类 ILSystem 继承关系图:

Public 成员函数
BOOL	CheckLib (LString libName)

BOOL	CheckLicense ()

BOOL	CheckVersion (long majorVersion, long minorVersion, long microVersion)

void	DrawCircle (double x, double y, double r, BOOL bFill, HDC hdc, double zoomX, double zoomY, double panX, double panY)

void	DrawLine (double x1, double y1, double x2, double y2, HDC hdc, double zoomX, double zoomY, double panX, double panY)

void	DrawPoint (double x, double y, LPVPointShape shape, HDC hdc, double zoomX, double zoomY, double panX, double panY)

void	DrawPolygon (LArray< double > xs, LArray< double > ys, BOOL bClosed, BOOL bFill, HDC hdc, double zoomX, double zoomY, double panX, double panY)

void	DrawRect (double x, double y, double w, double h, double a, BOOL bFill, HDC hdc, double zoomX, double zoomY, double panX, double panY)

void	DrawString (LString text, int tlx, int tly, HDC hdc, double zoomX, double zoomY, double panX, double panY)

COLORREF	GetColorRef (int red, int green, int blue)

void	GetRGBFromColorRef (COLORREF colorRef, int red, int green, int *blue)

LPVErrorCode	RefreshDefaults (LString filename)

void	SetDefault (LString settingName, LString val)

void	SetDrawPointSize (int size)

void	SetRegionHandleSize (int size)

详细描述

该接口类提供了修改 LPV 系统全局参数的功能和一些杂项帮助函数。

使用这个接口，需要创建一个 LSystem 对象。

示例代码

成员函数说明

◆ CheckLib()

BOOL CheckLib ( LString libName )

检查某个模块是否合法授权。授权后，可以正常使用该模块中的类和算法函数。
通常按照如下方式调用：

参数

[in] libName 输入模块的名称。该名称不区分大小写，且可省略 "lpv" 前缀，如 "lpvCore.dll", "lpvCore", "core", "CORE".

返回值

val	若检查成功，返回 True，否则返回 False

◆ CheckLicense()

BOOL CheckLicense ( )

检查是否存在任一合法授权。注意：此处并不检查功能ID。功能模块的授权检查需调用 CheckLib().
通常按照如下方式调用：

返回值

val	若检查成功，返回 True，否则返回 False

◆ CheckVersion()

BOOL CheckVersion	(	long	majorVersion,
		long	minorVersion,
		long	microVersion
	)

检查编译时和运行时所使用的 LPW 版本兼容性。通常按照如下方式调用：

若检查失败，用户需要重新安装正确的运行版本，或重新基于更新的版本编译。推荐在编译和运行时使用相同版本。

参数

[in]	majorVersion	编译时的版本号第一位
[in]	minorVersion	编译时的版本号第二位
[in]	microVersion	编译时的版本号第三位

返回值

val	若检查成功，返回 True，否则返回 False

◆ DrawCircle()

void DrawCircle	(	double	x,
		double	y,
		double	r,
		BOOL	bFill,
		HDC	hdc,
		double	zoomX,
		double	zoomY,
		double	panX,
		double	panY
	)

在给定的设备上绘制一个圆，使用该系统对象的当前描边笔和笔刷。

参数

[in]	x	圆心的 x 坐标。
[in]	y	圆心的 y 坐标。
[in]	r	圆的半径
[in]	bFill	是否使用当前笔刷填充图形。

参见: Use Draw Functions

备注: 该函数在 Linux / MacOS 平台暂不可用。

◆ DrawLine()

void DrawLine	(	double	x1,
		double	y1,
		double	x2,
		double	y2,
		HDC	hdc,
		double	zoomX,
		double	zoomY,
		double	panX,
		double	panY
	)

在给定的设备上绘制一条线，使用该系统对象的当前描边笔。

参数

[in]	x1	直线起点的 x 坐标。
[in]	y1	直线起点的 y 坐标。
[in]	x2	直线终点的 x 坐标。
[in]	y2	直线终点的 y 坐标。

参见: Use Draw Functions

备注: 该函数在 Linux / MacOS 平台暂不可用。

◆ DrawPoint()

void DrawPoint	(	double	x,
		double	y,
		LPVPointShape	shape,
		HDC	hdc,
		double	zoomX,
		double	zoomY,
		double	panX,
		double	panY
	)

在给定的设备上绘制一个点，使用该系统对象的当前描边笔。

参数

[in]	x	点的 x 坐标。
[in]	y	点的 y 坐标。
[in]	shape	点的形状

参见: Use Draw Functions

备注: 该函数在 Linux / MacOS 平台暂不可用。

◆ DrawPolygon()

void DrawPolygon	(	LArray< double >	xs,
		LArray< double >	ys,
		BOOL	bClosed,
		BOOL	bFill,
		HDC	hdc,
		double	zoomX,
		double	zoomY,
		double	panX,
		double	panY
	)

在给定的设备上绘制一个多边形，使用该系统对象的当前描边笔和笔刷。

参数

[in]	xs	多边形顶点的所有 x 坐标。
[in]	ys	多边形顶点的所有 y 坐标。
[in]	bClosed	多边形是否封闭。
[in]	bFill	是否使用当前笔刷填充图形。

参见: Use Draw Functions

备注: 该函数在 Linux / MacOS 平台暂不可用。

◆ DrawRect()

void DrawRect	(	double	x,
		double	y,
		double	w,
		double	h,
		double	a,
		BOOL	bFill,
		HDC	hdc,
		double	zoomX,
		double	zoomY,
		double	panX,
		double	panY
	)

在给定的设备上绘制一个可旋转的矩形，使用该系统对象的当前描边笔和笔刷。

参数

[in]	x	矩形中心的 x 坐标。
[in]	y	矩形中心的 y 坐标。
[in]	w	矩形的宽度。
[in]	h	矩形的高度。
[in]	a	矩形的旋转角度。
[in]	bFill	是否使用当前笔刷填充图形。

参见: Use Draw Functions

备注: 该函数在 Linux / MacOS 平台暂不可用。

◆ DrawString()

void DrawString	(	LString	text,
		int	tlx,
		int	tly,
		HDC	hdc,
		double	zoomX,
		double	zoomY,
		double	panX,
		double	panY
	)

在给定的设备上绘制字符串，使用该系统对象的当前描边笔。

参数

[in]	text	输入字符串
[in]	tlx	绘制区域的左上角点 x 坐标。
[in]	tly	绘制区域的左上角点 y 坐标。

参见: Use Draw Functions

备注: 该函数在 Linux / MacOS 平台暂不可用。

◆ GetColorRef()

COLORREF GetColorRef	(	int	red,
		int	green,
		int	blue
	)

将 RGB(red, green, blue) 值转为 32 位的数值用于表示该颜色，按照 RRGGBB 的格式。你可以在 C# 使用系统库提供的 ColorTranslator.ToWin32() 函数，在 C++ 中使用 GDI 提供的 RGB() 宏。

参见: GetRGBFromColorRef()

◆ GetRGBFromColorRef()

void GetRGBFromColorRef	(	COLORREF	colorRef,
		int *	red,
		int *	green,
		int *	blue
	)

将 RGB(red, green, blue) 值转为 32 位的数值用于表示该颜色。该 32 位的数值按照 RRGGBB 的格式。你可以在 C# 使用系统库提供的 ColorTranslator.FromWin32() 函数，在 C++ 中使用 GDI 提供的 GetRValue()/GetGValue()/GetBValue() 宏。

参数

[in]	colorRef	输入颜色值
[out]	red	输出红色值
[out]	green	输出绿色值
[out]	blue	输出蓝色值

参见: GetColorRef()

◆ RefreshDefaults()

LPVErrorCode RefreshDefaults ( LString filename )

从指定的 .default 文件更新系统默认配置。该文件为 yml 格式，如下所示：

%YAML:1.0
defaultLogLevel: 0
silent: true

参数

[in] filename 文件路径，可为绝对或相对路径，包含文件夹、文件名和扩展名

返回值

error 返回错误码

自从: 2.1.0

◆ SetDefault()

void SetDefault	(	LString	settingName,
		LString	val
	)

修改系统默认配置。支持的配置参数如表格所示：

配置	用途	默认值
pointSize	点绘制的尺寸（像素）	5
roiHandleSize	Region拖拽句柄的尺寸（像素）	7
paragraphSpace	多行文本绘制时的行间距（像素）	6
doublePrecision	绘制分数图表时数值的小数点精度	3
defaultLogLevel	日志等级（0 所有，10000 调试，20000 信息，30000 警告，40000 错误，50000 致命，60000 关闭）	30000（警告）
noLicenseRetryMsgBox	是否不弹出授权失败重试的窗口	false（弹出）
silent	是否不弹出任何提示窗口	false（弹出）
genCrashDump	是否在程序崩溃时生成 dump 文件	false（否）
useFullDump	是否生成带有内存的 dump 文件	false（否）

通常按照如下方式调用：

参数

[in]	settingName	配置名称
[in]	val	配置值

自从: 2.1.0

◆ SetDrawPointSize()

void SetDrawPointSize ( int size )

全局修改绘制点的尺寸，默认设置为 5 个像素。

◆ SetRegionHandleSize()

void SetRegionHandleSize ( int size )

全局修改区域对象操作句柄的绘制尺寸（以及可交互范围），默认设置为 7 个像素。

参数

[in] size 所需的区域对象局部尺寸，像素单位

Public 成员函数

详细描述

示例代码

成员函数说明

◆ CheckLib()

◆ CheckLicense()

◆ CheckVersion()

◆ DrawCircle()

◆ DrawLine()

◆ DrawPoint()

◆ DrawPolygon()

◆ DrawRect()

◆ DrawString()

◆ GetColorRef()

◆ GetRGBFromColorRef()

◆ RefreshDefaults()

◆ SetDefault()

◆ SetDrawPointSize()

◆ SetRegionHandleSize()