2024年4月18日 (四) 06:10 Artheru

2024-04-18T06:10:46Z

←上一版本		2024年4月18日 (四) 14:10的版本
第72行：		第72行：
	=== 更复杂的鼠标事件 ===		=== 更复杂的鼠标事件 ===
	如果获取位置/路段等方法不够用，也可以使用全功能的鼠标注册事件（较为繁琐）：registerDownevent：<syntaxhighlight lang="c#" line="1">		如果获取位置/路段等方法不够用，也可以使用全功能的鼠标注册事件（较为繁琐）：registerDownevent：<syntaxhighlight lang="c#" line="1">
	[MethodMember(name = "精确移动", desc = "~~选择一个方向，以~~")]		[MethodMember(name = "精确移动", desc = "选择一个方向，然后输入移动距离")]
	public async void PreciseMove()		public async void PreciseMove()
	{		{

Artheru：创建页面，内容为“SimpleComposer支持自定义CAD工具。开发者可以设计CAD工具来自动写入标签、调整站点姿态等，从而方便现场人员使用系统。开发者只需要在插件里声明一个公共类，继承CADTool，并增加CADToolDescriptor即可在界面中添加该工具。添加的CAD工具位置如下图所示： CADTool放置位置相关的接口如下： pub…”

2024-04-18T06:08:58Z

创建页面，内容为“SimpleComposer支持自定义CAD工具。开发者可以设计CAD工具来自动写入标签、调整站点姿态等，从而方便现场人员使用系统。开发者只需要在插件里声明一个公共类，继承CADTool，并增加CADToolDescriptor即可在界面中添加该工具。添加的CAD工具位置如下图所示：无|缩略图|CADTool放置位置相关的接口如下：<syntaxhighlight lang="c#" line="1"> pub…”

新页面

SimpleComposer支持自定义CAD工具。开发者可以设计CAD工具来自动写入标签、调整站点姿态等，从而方便现场人员使用系统。开发者只需要在插件里声明一个公共类，继承CADTool，并增加CADToolDescriptor即可在界面中添加该工具。添加的CAD工具位置如下图所示：
[[文件:Cad tool place.png|无|缩略图|CADTool放置位置]]
相关的接口如下：<syntaxhighlight lang="c#" line="1">
public abstract class CADEventHandler
{
public virtual void OnSelect() //当选中某个元素的时候触发

public virtual void OnDelete(Prop props) //当某个元素删除时触发

public virtual void OnAdd(Prop prop) //当某个元素新建的时候触发
}

public abstract class CADTool
{
public abstract void Invoke();
}
public class CADToolDescriptor : Attribute
{
public enum Place
{
SceneTool, //场景工具，显示在场景面板-工具下拉菜单中
CarTool, //车辆工具，显示在车辆面板-工具下拉菜单中
ProjectTool //工程工具，显示在“插件”按钮中
}
public string name;
public string shortcut;
public Place place = Place.SceneTool;
}
</syntaxhighlight>以下是一个例子<syntaxhighlight lang="c#" line="1">
[CADToolDescriptor(name = "批量增删改字段", shortcut = "Ctrl+Alt+M")]
public class BatchFields:CADTool
{
public override void Invoke()
{
if (InputBox.ShowDialog("输入要增加或修改的字段名称和值，格式为\r\n[字段]:[值]，若要删除只需要写字段名", "参数增删改", "name:val") ==
DialogResult.OK)
{
foreach (var sel in SimpleMonitor.selected)
{
var obj = sel;
var dict = (Dictionary<string, string>)obj.GetType().GetField("fields").GetValue(obj);
var idx = InputBox.ResultValue.IndexOf(':');
if (idx == -1)
{
// remove.
dict.Remove(InputBox.ResultValue);
continue;
}

var key = InputBox.ResultValue.Substring(0, idx);
var val = InputBox.ResultValue.Substring(idx + 1);
var fi = obj.GetType().GetField(key);
if (fi != null)
{
fi.SetValue(obj, TypeDescriptor.GetConverter(fi.FieldType).ConvertFromString(val));
}
else
dict[key] = val;
}
}
}
}
</syntaxhighlight>注：以上例子第9行处使用了SimpleMonitor.selected来访问选择的元素。SimpleMonitor.selected也可以用来写入应该选择哪些元素。

CADTool中可以使用所有SimpleMonitor支持的UI操作类型。比如：<syntaxhighlight lang="c#" line="1">
var target = await Program.UI.getPoint(); //用于获取一个位置。
var site = await Program.UI.getPoint(new getPointOptions() { site = true }); //获取一个位置，这个位置必须是站点
var shelfLane = await Program.UI.GetTrack(true); //获取一个路段。参数true表示要将这个路段放入选择

</syntaxhighlight>

=== 更复杂的鼠标事件 ===
如果获取位置/路段等方法不够用，也可以使用全功能的鼠标注册事件（较为繁琐）：registerDownevent：<syntaxhighlight lang="c#" line="1">
[MethodMember(name = "精确移动", desc = "选择一个方向，以")]
public async void PreciseMove()
{
var pp = getPainter("cad");
SimpleMonitor.registerDownevent((_,_) =>
{
if (InputBox.ShowDialog("输入位移距离，单位mm", "位移", "0") != DialogResult.OK) return;
var str = InputBox.ResultValue;
if (str == null || !float.TryParse(str, out var d)) return;
var dx = mouseX - x;
var dy = mouseY - y;
var dd = Math.Sqrt(dx * dx + dy * dy);
dx /= (float)dd;
dy /= (float)dd;
x += dx * d;
y += dy * d;
clearDownevent();
Task.Delay(1000).ContinueWith(p => pp.clear());
}, cancelEvent: () => { pp.clear(); }, preselect: (sender, args) =>
{
pp.clear();
pp.drawLine(Pens.Red, x, y, mouseX, mouseY);
});
}
</syntaxhighlight>registerDownevent的说明如下：<syntaxhighlight lang="c#" line="1">
public static void registerDownevent(
UIMouseEvent start=null, //鼠标点击时触发。
Action cancelEvent = null, //动作取消时触发（点击右键为取消），一般还要调用clearDownevent()来清除鼠标事件。
UIMouseEvent drag = null, //拖动时触发
UIMouseEvent release = null, //动作结束时触发
UIMouseEvent preselect = null //刚开始拖动时触发
)
//可以使用SimpleMonitor.mouseX/mouseY来获取鼠标在地图上的坐标，
</syntaxhighlight>

开发手册 - SimpleComposer界面开发 - CAD工具 - 版本历史

2024年4月18日 (四) 06:10 Artheru