Solidwoks PDM Add-ins (C#) 创建Add-ins

本主题演示如何在Microsoft Visual Studio Enterprise 中使用Visual C#创建并调试add-in。

注意: 因为 SOLIDWORKS PDM Professional无法强制重新加载在 .NET 中编写的add-in程序,则必须重新启动所有客户端计算机,以确保使用最新版本的add-in程序。

  • 启动 Visual Studio 
  • File(文件) > New(新建) > Project(项目) > Visual C# > Windows > Class Library(类库)
  • 选择版本。更多信息见 Using .NET Framework for Add-in Applications 
  • 在“名称”中键入项目的名称。
  • 单击浏览并选择创建项目路径。
  • 单击确定(ok)。

  • 修改类名(可选)

  • 在“解决方案资源管理器”中右击项目名称,然后单击“添加引用”。 
    • 单击左侧面板中的 COM,选择PDMWorks Enterprise 2019 Type Library,确定。
    • 单击左侧面板中的程序集->框架,选择System.Windows.Forms(WF),或者选择Presentation-Framework(WPF),确定。
    • 关闭窗口。 
    • 需要把EdmLib嵌入互操作设置为False

  • 在“解决方案资源管理器”中右击项目名称,然后单击“属性”。
    • “应用程序>程序集信息”。
    • 取消勾选“使程序集 COM 可见(M)”。
    • 在“生成”选项卡上,勾选“为 COM 互操作注册(C)”。

  • 将此设置为调试加载项:
    • 选择调试选项卡。
    • 选择 启动外部程序(X) 选择 C:\Windows\System32\notepad.exe
  • 如果在64位计算机上创建Add-in,在记事本中编辑 project_path\project_name\project_name\project_name.csproj 
    • 在 <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' "> 下方
      和 <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' "> 下方插入以下行:
      
      <PlatformTarget>AnyCPU</PlatformTarget>
    • 保存文件并退出记事本。

  • 双击“解决方案资源管理器”中的 MyAddin.cs 以打开代码窗口。
  • 在窗口代码的顶部,键入:
    using System.Windows;//新增
    using System.Runtime.InteropServices;//新增
    using EdmLib;//新增
  • 替换
    public class MyAddin 更改为
    [Guid(""), ComVisible(true)]
    public class MyAddin : IEdmAddIn5
    {

    }
  • 填写上面的Guid(""
    • 工具->创建GUID
    • 选择GUID Format 5,单击复制,单击退出。用复制的字符串填充 [guid(“”), ...]。

   //范例:
    [Guid("192F935A-C45F-4591-8233-1B90BA534E82"), ComVisible(true)]
    public class MyAddin : IEdmAddIn5
    {

    }

  • 在代码中,右键 IEdmAddIn5,选择快速操作和重构 > 实现接口
    • 实现 IEdmAddIn 5::GetAddInInfo
          public class MyAddin : IEdmAddIn5
          {
              //添加
              public void GetAddInInfo(ref EdmAddInInfo poInfo, IEdmVault5 poVault, IEdmCmdMgr5 poCmdMgr)
              {
                  //指定要在Add-in程序的“属性”对话框中显示的信息
                  poInfo.mbsAddInName = "C# Add-in";
                  poInfo.mbsCompany = "My Company";
                  poInfo.mbsDescription = "Menu add-in that shows a message box.";
                  poInfo.mlAddInVersion = 1;
      
                  //指定 SolidWorks PDM Professional的最低要求版本 
                  poInfo.mlRequiredVersionMajor = 6;
                  poInfo.mlRequiredVersionMinor = 4;
      
                  //注册菜单命令
                  poCmdMgr.AddCmd(1, "C# Add-in", (int)EdmMenuFlags.EdmMenu_Nothing);
              }
          }
  • 实现 IEdmAddIn5::
        public class MyAddin : IEdmAddIn5
        {
            //添加
            public void OnCmd(ref EdmCmd poCmd, ref Array ppoData)
            {
                // 处理菜单命令(调用MyAddinUI)
                if (poCmd.meCmdType == EdmCmdType.EdmCmd_Menu)
                {
                    if (poCmd.mlCmdID == 1)
                    {
                        new MyAddinUI("C# Add-in").Show();
                        //MessageBox.Show("C# Add-in");
                    }
                }
            }
        }

  • 在“解决方案资源管理器”中右键单击项目名称,然后单击“添加现有项”>(我在其他项目复制的WPF窗体,WF可以选择添加类)。由于是类库,需要添加引用PresentationCore、PresentationFramework、System.Xaml、WindowsBase等。由于是复制的,需要修改名称空间、内容。
//.cs文件

using System;
using System.Windows;

namespace Add_in_Demo
{
    /// <summary>
    /// MainWindow.xaml 的交互逻辑
    /// </summary>
    public partial class MyAddinUI : Window
    {
        public MyAddinUI(string s)
        {
            InitializeComponent();
            myTextBlock.Text = s;
        }
    }
}
//.xaml 文件
<Window x:Class="Add_in_Demo.MyAddinUI"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:Add_in_Demo"
        mc:Ignorable="d"
        Title="SW PDM Add-in范例" Height="450" Width="800">
    <Grid>
        <TextBlock x:Name="myTextBlock"/>
    </Grid>
</Window>

Add-in程序使用菜单命令处理程序通过调用MyAddinUI.cs MyAddin.cs中的OnCmd去显示message box

  • 单击“生成”>“生成解决方案” ,生成Add-in。
  • 安装加载项,用 SOLIDWORKS PDM Professional 管理工具进行调试

        1.打开 SOLIDWORKS PDM Professional 专业管理工具(管理)。

        2.展开要安装此加载项的库,然后以管理员身份登录。

        3.右键单击“加载项”(Add-ins),然后选择“调试加载项”(Debug Add-ins)。

        4.单击“添加加载项”(Add Add-in),浏览到 project_path\project_name\project_name\bin\Debug,单击“project_name.dll”,然后单击“打开”(Open)。Add-in程序的名称、路径和类 ID 应显示在“安装在此计算机上进行调试的外接程序”(Add-ins installed for debugging on this machine)列表中。

        5.确定。

  • 在 Microsoft Visual Studio 中,单击“调试”>“开始调试”或按 F5。
  • 打开记事本,然后单击文件>打开。
  • 在“打开”对话框中,单击安装此加载项的库的名称。
  • 在库视图中单击鼠标右键,然后单击“C# 加载项”(# Add-in)。显示消息“C# Add-in”。
  • 单击“确定”关闭消息框。
  • 单击取消。
  • 关闭记事本  

完整的源代码

using System.Windows;//新增
using System.Runtime.InteropServices;//新增
using EdmLib;//新增
using System;

namespace Add_in_Demo
{
    [Guid("192F935A-C45F-4591-8233-1B90BA534E82"), ComVisible(true)]
    public class MyAddin : IEdmAddIn5
    {
        public void GetAddInInfo(ref EdmAddInInfo poInfo, IEdmVault5 poVault, IEdmCmdMgr5 poCmdMgr)
        {
            //指定要在Add-in程序的“属性”对话框中显示的信息
            poInfo.mbsAddInName = "C# Add-in";
            poInfo.mbsCompany = "My Company";
            poInfo.mbsDescription = "Menu add-in that shows a message box.";
            poInfo.mlAddInVersion = 1;

            //指定 SolidWorks PDM Professional的最低要求版本 
            poInfo.mlRequiredVersionMajor = 6;
            poInfo.mlRequiredVersionMinor = 4;

            //注册菜单命令
            poCmdMgr.AddCmd(1, "C# Add-in", (int)EdmMenuFlags.EdmMenu_Nothing);
        }

        public void OnCmd(ref EdmCmd poCmd, ref Array ppoData)
        {
            MessageBox.Show("C# Add-in 1");
            //处理菜单命令(调用MyAddinUI)
            if (poCmd.meCmdType == EdmCmdType.EdmCmd_Menu)
            {
                if (poCmd.mlCmdID == 1)
                {
                    MessageBox.Show("C# Add-in 1");
                    new MyAddinUI("C# Add-in 2").Show();
                }
            }
        }
    }
}

调试的时候,VS不能以管理员方式运行,不然加载不了DLL。

Demo完整资源打包

https://download.csdn.net/download/hd51cc/87878684