本文简要介绍使用Windows WPF（C#）方式进行STK Engine的二次开发，如何添加AGI Global Control和AGI Map Control控件到用户软件界面，以及如何初始化STK场景。
WinForm与WPF方式
在使用STK Engine进行二次开发客户端软件的时候，通常使用的是Windows Form的形式，在这种开发模式下，我们使用STK 3D、2D控件的时候，是直接从控件栏将3D、2D控件直接拖到面板上实现的。这种方式简单，方便。
本文阐述使用Windows WPF方式使用STK Engine进行二次开发客户端软件的前期设置。使用WPF方式开发时，其软件GUI界面使用类似XML语言的方式，不清楚的可以自行搜索一下WPF，这里就不过多阐述了。相比WinForm方式，WPF开发方式有以下两个优点：
当STK Engine为64位时，在使用Visual Studio开发时，控件栏里是添加不了STK 3D/2D的控件的，也就是说无法使用鼠标直接拖拽的方式将控件添加到界面上，只能通过原始代码的方式自行添加，非常繁琐；
使用WPF方式，采用XML语言的方式，可以直接将3D、2D控件直接嵌入软件界面，同时可以使用WPF的样式等丰富自己的软件界面。
STK Engine API
对于.Net方式的STK Engine二次开发，本质是调用其提供的API，API以程序集（DLL）的方式存放在STK软件的安装目录下（STK安装目录\bin\Primary Interop Assemblies）。
既然是程序集DLL文件形式，那么我们使用它和任何其他第三方的DLL都是一样的过程。一是在工程中引用相关的DLL文件，二是通过Using命名空间的方式来使用相关类。
新建Visual Studio WPF工程
打开Visual Studio，新建Wpf工程项目（文件-新建-项目-Visual C#-WPF应用程序）。选择.Net FrameWork 4作为工程配置，项目名称（可任意设置）：TestEngineWpf。新创建的工程如下图。
添加引用文件
为项目添加STK Engine API引用。右键“引用”-添加引用打开引用管理器，分别按照以下操作，添加几个dll程序集。
点击“程序集”，选择(前面打√)“System.Windows.Forms”和“WindowsFormsIntegration”，这两个程序集是wpf程序里安装winform控件所需要的；
点击“COM”，选择“AGI STK Objects 11”、“AGI STK X 11”；
点击“浏览”，导航到文件路径（STK安装目录\bin\Primary Interop Assemblies），选择程序集“AxAGI.STKX.Interop.dll”，然后点击“确定”。
添加引用完成后，即可在引用栏里看到添加的引用，其中AGI.STKUtil和AGI.STKVgt两个程序是AGI.STKObjects所依赖的，系统自动帮我们添加了。
注意，由于此工程项目为示范项目，所以涉及到的程序集较少；如果STK Engine二次开发项目涉及较多程序集的话，应该添加其他相应的程序集（DLL），比如如果涉及到STK桌面软件相关操作，则应添加“AGI UI Application 11”等程序集。
主窗口添加控件
项目中，MainWindow.xaml为程序主窗口GUI，双击后，显示两个编辑界面：GUI窗口和XAML窗口。XAML窗口使用xml语言的方式添加控件，GUI窗口及时显示效果。
XAML窗口中，首先添加对STK程序集的命名空间引用，然后添加STK 3D、2D控件及三个按钮，整个XAML代码如下：
<Window x:Class="TestEngineWpf.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:stkEng="clr-namespace:AxAGI.STKX;assembly=AxAGI.STKX.Interop"
Title="MainWindow" Height="350" Width="525">
<Grid>
<StackPanel>
<!--此面板包含STK 3D/2D控件，高度、宽度可根据需要自行设置，或者自动适应-->
<StackPanel Orientation="Horizontal">
<WindowsFormsHost Height="280" Width="250">
<stkEng:AxAgUiAxVOCntrl></stkEng:AxAgUiAxVOCntrl>
</WindowsFormsHost>
<WindowsFormsHost Height="280" Width="250">
<stkEng:AxAgUiAx2DCntrl></stkEng:AxAgUiAx2DCntrl>
</WindowsFormsHost>
</StackPanel>
<!--此面板设置简单的功能按钮-->
<StackPanel Orientation="Horizontal">
<Button Name="NewScenario" Width="100" Click="NewScenario_Click">新建场景</Button>
<Button Name="NewSatellite" Width="100" Click="NewSatellite_Click">新建卫星</Button>
<Button Name="SaveScenario" Width="100" Click="SaveScenario_Click">保存场景</Button>
</StackPanel>
</StackPanel>
</Grid>
</Window>
注意，上述代码中，添加xml命名空间的引用时，写入"xmlns:stkEng="时，则会自动弹出命名空间，见下图，此时查找选择"AxAGI.STKX（AxAGI.STKX.Interop）"即可。
其中，stkEng是命名空间名称，可自己任意设定。
添加响应函数
上面创建了控件，我们没有使用一行代码。下面开始为按钮创建响应函数。
在解决方案资源管理器中，右键“MainWindow.xaml”，点击“查看代码”，则其代码窗口（MainWindow.xaml.cs）打开。在其中添加相应的响应函数代码，具体含义见其中注释。
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;
// 引用命名空间，目前此文件内相关类仅涉及到此命名空间，
// 如果需要，还需要添加对其他命名空间的应用。
using AGI.STKObjects;
namespace TestEngineWpf
{
/// <summary>
/// MainWindow.xaml 的交互逻辑
/// </summary>
public partial class MainWindow : Window
{
//*********
// 此为STK Engine的根，控制整个STK场景
AgStkObjectRoot stkRoot;
public MainWindow()
{
InitializeComponent();
// 初始化
stkRoot = new AgStkObjectRoot();
}
// 新建STK场景，场景名为Test
private void NewScenario_Click(object sender, RoutedEventArgs e)
{
stkRoot.NewScenario("Test");
}
// 新建卫星
private void NewSatellite_Click(object sender, RoutedEventArgs e)
{
// Create the Satellite
IAgSatellite satellite = stkRoot.CurrentScenario.Children.New(AgESTKObjectType.eSatellite, "MySatellite") as IAgSatellite;
// Set propagator to J2 Perturbation
satellite.SetPropagatorType(AgEVePropagatorType.ePropagatorJ2Perturbation);
// Get the J2 Perturbation propagator
IAgVePropagatorJ2Perturbation propagator = satellite.Propagator as IAgVePropagatorJ2Perturbation;
// 轨道积分(相当于STK软件中的Apply按钮)
propagator.Propagate();
}
// 保存场景
private void SaveScenario_Click(object sender, RoutedEventArgs e)
{
stkRoot.SaveAs(@"D:\Test");
// 也可保存在具体的文件内，如D:\MySTK\Test，但要确保MySTK文件夹存在。
// Test为场景名称，也可改为其他名称，则自动将之前设定的场景名称更改。
//stkRoot.SaveAs(@"D:\MySTK\Test");
}
}
}
总结
本文大部分内容可参考STK Component的Help文档Getting Started部分。
本文给出的例子仅仅是如何使用Wpf方式加载Insight3D控件，后面具体在此控件中添加更进一步的功能，如飞行器的轨迹显示、地面站显示、图标显示等等请参考Help文档中相关说明，也可参见其提供的例子（Example文件夹下的HowTo工程），见下图，里面针对每个功能都直接提供了相关代码，可直接照搬。
————————————————
版权声明：本文为CSDN博主「云上飞47636962」的原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/u011575168/article/details/53047597
