做為一個摩登的工業軟體，提供可程式設計的腳本能力是必不可少的能力。腳本既可以友善使用者進行二次開發，也對友善對程式進行自動化測試。本文将結合AnyCAD對Python腳本支援的能力和WPF快速開發帶腳本編輯器的CAD軟體。
做為一個摩登的工業軟體，提供可程式設計的腳本能力是必不可少的能力。腳本既可以友善使用者進行二次開發，也對友善對程式進行自動化測試。本文将結合AnyCAD對Python腳本支援的能力和WPF快速開發帶腳本編輯器的CAD軟體。
1 增加腳本插件
建立一個WPF控件項目，名為Rapid.ScriptPy.Plugin。參照《開發基于WPF的摩登三維工業軟體 (6)》一文添加ScriptRibbonTab，并增加運作腳本按鈕。
<Fluent:RibbonTabItem xmlns:Fluent="urn:fluent-ribbon" x:Class="Rapid.ScriptPy.Plugin.UI.ScriptRibbonTab"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:local="clr-namespace:Rapid.ScriptPy.Plugin.UI"
mc:Ignorable="d"
Header="腳本"
d:DesignHeight="100" d:DesignWidth="400">
<Fluent:RibbonGroupBox Header="基本體" IsLauncherVisible="False" Margin="7,0,0,0">
<Fluent:Button Header="運作" Size="Large" Command="{x:Static local:ScriptRibbonTab.ExecuteCommand}"
CommandParameter="runPy" Margin="0,0,7,0"/>
</Fluent:RibbonGroupBox>
</Fluent:RibbonTabItem> namespace Rapid.ScriptPy.Plugin.UI
{
/// <summary>
/// ScriptRibbonTab.xaml 的互動邏輯
/// </summary>
public partial class ScriptRibbonTab
{
public static readonly RoutedCommand ExecuteCommand = new("Rapid.ScriptPy", typeof(ScriptRibbonTab));
public ScriptRibbonTab()
{
InitializeComponent();
CommandBindings.Add(new CommandBinding(ExecuteCommand, OnExecuteCommand));
}
private void OnExecuteCommand(object sender, ExecutedRoutedEventArgs e)
{
}
}
} 2 腳本編輯器
基于WPF的自帶文法高亮的代碼編輯器很多，本文使用AvalonEdit作為Python代碼編輯控件。
2.1 添加程式集
在nuget.org搜尋AvalonEdit, 為Rapid.CAX和Rapid.ScriptPy.Plugin增加程式集引用：
2.2 添加編輯器控件
在MainWindow.xaml中三維控件顯示視窗後增加腳本編輯器：
<ad:LayoutPanel Orientation="Vertical">
<ad:LayoutDocumentPane IsMaximized="True">
<ad:LayoutDocument Title="Python腳本" CanClose="False">
<!--Script Editor-->
<avalonEdit:TextEditor
xmlns:avalonEdit="http://icsharpcode.net/sharpdevelop/avalonedit"
Name="textEditor"
SyntaxHighlighting="Python"
FontFamily="Consolas"
FontSize="12pt" HorizontalScrollBarVisibility="Auto" VerticalScrollBarVisibility="Auto"/>
</ad:LayoutDocument>
</ad:LayoutDocumentPane>
</ad:LayoutPanel> 編譯并運作：
可以看到，我們的程式輕輕松松就具備了Python文法高亮的能力。
當然AvalonEdit也具備提示、代碼塊折疊等進階功能。
3 內建腳本
我們的目标是在Rapid.ScriptPy.Plugin中運作腳本，首先需要為MainWindow暴露擷取TextEditor的方法：
public partial class MainWindow
{
...
public ICSharpCode.AvalonEdit.TextEditor GetTextEditor()
{
return this.textEditor;
}
...
} 響應運作指令：
public partial class ScriptRibbonTab
{
//...
private void OnExecuteCommand(object sender, ExecutedRoutedEventArgs e)
{
switch (e.Parameter.ToString())
{
case "runPy":
{
var textEditor = MainWindow.Instance()?.GetTextEditor();
if(textEditor?.Text?.Length > 0)
{
AnyCAD.Py.PyScript.Instance().Run(textEditor?.Text);
}
}
break;
}
}
} 使用AnyCAD.Py.PyScript.Instance().Run(content)可以直接運作腳本内容。AnyCAD.Py.PyScript.Instance().RunFile(filePath)可以運作檔案内的腳本。
編譯運作，測試一下：
box = AnyCAD.ShapeBuilder.MakeBox(AnyCAD.GAx2(), 1,1,1)
theViewer.ShowTopoShape(box, None)
theViewer.RequestUpdate(AnyCAD.EnumUpdateFlags_Scene) 4 總結
從最近的程式設計語言排行榜來看，Python語言高居榜首。為程式增加Python腳本支援，可以大大降低二次開發的門檻。基于AnyCAD開放的Python API，可以友善地使用Python腳本來建立模型、分析模型。
AvalonEdit是一個非常棒的代碼編輯控件，我們後續可以進一步完善智能提示、代碼塊折疊等進階功能，提供使用者體驗。
本文相關代碼：https://gitee.com/anycad/RapidCAX/tree/new-ui/
5 相關連結
[1] AvalonEdit: http://avalonedit.net/documentation/
[2] .NET6: 開發基于WPF的摩登三維工業軟體 (6)
[3] .NET6: 開發基于WPF的摩登三維工業軟體 (5)
[4] .NET6: 開發基于WPF的摩登三維工業軟體 (4)
[5] .NET6: 開發基于WPF的摩登三維工業軟體 (3)
[6] .NET6: 開發基于WPF的摩登三維工業軟體 (2)