revit二次开发API示例 基准面修改

应用程序：DatumsModification

Revit平台：所有版本

Revit版本：2015.0

首次发布时间：2015.0

编程语言：C#

技能水平：初学者

类别：元素

类型：外部命令和外部应用程序

主题：基准面修改
摘要：基准面修改

相关类:

Autodesk.Revit.UI.IExternalApplication

Autodesk.Revit.DB.DatumPlane

项目文件：

DatumsModificationApp.cs

这个文件包含了类 DatumsModificationApp，该类继承了接口 IExternalApplication 并实现了 Startup/Shutdown 方法。在 Startup 方法中，添加了三个 Push 按钮。

DatumsModificationCmd.cs

这个文件包含了三个类，用于完成样式修改、对齐和传播操作。

描述：

此示例提供以下功能。

- 允许用户修改网格/层的样式，如范围类型、气泡和弯头。

- 允许用户对齐网格/层

- 允许用户将选定的网格/层的范围应用于选定的视图。

指南：

1. 修改选定的网格/层的样式

I. 打开Revit应用程序并选择一个或多个网格/层。

II. 单击  按钮，弹出以下对话框：

III. 选择要更改样式的复选框，然后单击“确定”按钮。

2. 对齐选定的网格/层

I. 打开Revit应用程序并选择一个或多个网格/层。

II. 单击  按钮，弹出以下对话框：

III. 选择其他网格/层将对齐到的网格/层，然后单击“确定”按钮。

3. 传播所选的网格/层

I. 打开Revit应用程序并选择一个网格/层。

II. 单击   按钮，弹出以下对话框：

III. 选择样式将传播到的视图，然后单击“确定”按钮。

完整的源代码请加入QQ群649037449，在群文件中下载RevitSDK.exe，解压后在文件夹中搜索本文中应用程序名称即可获得完整源码

DatumsModificationApp.cs

//
// (C) Copyright 2003-2019 by Autodesk, Inc. All rights reserved.
//
// Permission to use, copy, modify, and distribute this software in
// object code form for any purpose and without fee is hereby granted
// provided that the above copyright notice appears in all copies and
// that both that copyright notice and the limited warranty and
// restricted rights notice below appear in all supporting
// documentation.

//
// AUTODESK PROVIDES THIS PROGRAM 'AS IS' AND WITH ALL ITS FAULTS.
// AUTODESK SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTY OF
// MERCHANTABILITY OR FITNESS FOR A PARTICULAR USE. AUTODESK, INC.
// DOES NOT WARRANT THAT THE OPERATION OF THE PROGRAM WILL BE
// UNINTERRUPTED OR ERROR FREE.
//
// Use, duplication, or disclosure by the U.S. Government is subject to
// restrictions set forth in FAR 52.227-19 (Commercial Computer
// Software - Restricted Rights) and DFAR 252.227-7013(c)(1)(ii)
// (Rights in Technical Data and Computer Software), as applicable. 

using System;
using System.Collections.Generic;
using System.Text;
using System.Windows.Forms;
using System.IO;
using System.Windows.Media.Imaging;

using Autodesk;
using Autodesk.Revit;
using Autodesk.Revit.DB;
using Autodesk.Revit.UI;
using Autodesk.Revit.ApplicationServices;

namespace Revit.SDK.Samples.DatumsModification.CS
{
    /// <summary>
    /// Implements the Revit add-in interface IExternalApplication
    /// </summary>
    [Autodesk.Revit.Attributes.Transaction(Autodesk.Revit.Attributes.TransactionMode.Manual)]
    [Autodesk.Revit.Attributes.Regeneration(Autodesk.Revit.Attributes.RegenerationOption.Manual)]
    public class DatumsModificationApp : IExternalApplication
    {
        static string AddInPath = typeof(DatumsModificationApp).Assembly.Location;
        // Button icons directory
        static string ButtonIconsFolder = Path.GetDirectoryName(AddInPath);
        #region IExternalApplication Members
        /// <summary>
        /// Implements the OnShutdown event
        /// </summary>
        /// <param name="application"></param>
        /// <returns></returns>
        public Result OnShutdown(UIControlledApplication application)
        {
            return Result.Succeeded;
        }

        /// <summary>
        /// Implements the OnStartup event
        /// </summary>
        /// <param name="application"></param>
        /// <returns></returns>
        public Result OnStartup(UIControlledApplication application)
        {
           RibbonPanel ribbonPanel = application.CreateRibbonPanel("DatumModification");
           PushButtonData styleSettingButton = new PushButtonData("DatumStyle", "Datum Style", AddInPath, "Revit.SDK.Samples.DatumsModification.CS.DatumStyleModification");
           styleSettingButton.LargeImage = new BitmapImage(new Uri(Path.Combine(ButtonIconsFolder, "Style.png"), UriKind.Absolute)); ;
           PushButtonData alignSettingButton = new PushButtonData("AlignDatum", "Align Datums", AddInPath, "Revit.SDK.Samples.DatumsModification.CS.DatumAlignment");
           alignSettingButton.LargeImage = new BitmapImage(new Uri(Path.Combine(ButtonIconsFolder, "Align.png"), UriKind.Absolute)); ;
           PushButtonData propagateButton = new PushButtonData("PropagateDatum", "Propagate Extents", AddInPath, "Revit.SDK.Samples.DatumsModification.CS.DatumPropagation");
           propagateButton.LargeImage = new BitmapImage(new Uri(Path.Combine(ButtonIconsFolder, "Propagate.png"), UriKind.Absolute)); ;         
           
           ribbonPanel.AddItem(styleSettingButton);
           ribbonPanel.AddItem(alignSettingButton);
           ribbonPanel.AddItem(propagateButton);
           return Result.Succeeded;
        }

        #endregion
    }
}

DatumsModificationCmd.cs

//
// (C) Copyright 2003-2019 by Autodesk, Inc.
//
// Permission to use, copy, modify, and distribute this software in
// object code form for any purpose and without fee is hereby granted,
// provided that the above copyright notice appears in all copies and
// that both that copyright notice and the limited warranty and
// restricted rights notice below appear in all supporting
// documentation.
//
// AUTODESK PROVIDES THIS PROGRAM "AS IS" AND WITH ALL FAULTS.
// AUTODESK SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTY OF
// MERCHANTABILITY OR FITNESS FOR A PARTICULAR USE. AUTODESK, INC.
// DOES NOT WARRANT THAT THE OPERATION OF THE PROGRAM WILL BE
// UNINTERRUPTED OR ERROR FREE.
//
// Use, duplication, or disclosure by the U.S. Government is subject to
// restrictions set forth in FAR 52.227-19 (Commercial Computer
// Software - Restricted Rights) and DFAR 252.227-7013(c)(1)(ii)
// (Rights in Technical Data and Computer Software), as applicable.
//

using System;
using System.Windows.Forms;
using System.Collections;
using System.Collections.Generic;
using System.Linq;

using Autodesk.Revit;
using Autodesk.Revit.DB;
using Autodesk.Revit.UI;

namespace Revit.SDK.Samples.DatumsModification.CS
{
    /// <summary>
    /// Implements the Revit add-in interface IExternalCommand
    /// </summary>
    [Autodesk.Revit.Attributes.Transaction(Autodesk.Revit.Attributes.TransactionMode.Manual)]
    [Autodesk.Revit.Attributes.Regeneration(Autodesk.Revit.Attributes.RegenerationOption.Manual)]
    public class DatumStyleModification : IExternalCommand
    {
        #region globle variable
       /// <summary>
       /// 
       /// </summary>
       public static bool showLeftBubble = false;
       /// <summary>
       /// 
       /// </summary>
       public static bool showRightBubble = false;
       /// <summary>
       /// 
       /// </summary>
       public static bool addLeftElbow = false;
       /// <summary>
       /// 
       /// </summary>
       public static bool addRightElbow = false;
       /// <summary>
       /// 
       /// </summary>
       public static bool changeLeftEnd2D = false;
       /// <summary>
       /// 
       /// </summary>
       public static bool changeRightEnd2D = false;
       #endregion

        /// <summary>
        /// Implement this method as an external command for Revit.
        /// </summary>
        /// <param name="commandData">An object that is passed to the external application 
        /// which contains data related to the command, 
        /// such as the application object and active view.</param>
        /// <param name="message">A message that can be set by the external application 
        /// which will be displayed if a failure or cancellation is returned by 
        /// the external command.</param>
        /// <param name="elements">A set of elements to which the external application 
        /// can add elements that are to be highlighted in case of failure or cancellation.</param>
        /// <returns>Return the status of the external command. 
        /// A result of Succeeded means that the API external method functioned as expected. 
        /// Cancelled can be used to signify that the user cancelled the external operation 
        /// at some point. Failure should be returned if the application is unable to proceed with 
        /// the operation.</returns>
        public virtual Result Execute(ExternalCommandData commandData
            , ref string message, ElementSet elements)
        {
            try
            {
                Document document = commandData.Application.ActiveUIDocument.Document;
                ICollection<ElementId> datums = commandData.Application.ActiveUIDocument.Selection.GetElementIds();
                Autodesk.Revit.DB.View view = commandData.Application.ActiveUIDocument.ActiveView;
                if (datums == null || datums.Count == 0)
                   return Result.Cancelled;
                //// Show UI                
                using (DatumStyleSetting settingForm = new DatumStyleSetting())
                {
                   if (settingForm.ShowDialog() == DialogResult.OK)
                   {
                      using (Transaction tran = new Transaction(document,"StyleModification"))
                      {
                         tran.Start();
                         foreach (ElementId datumRef in datums)
                         {
                            DatumPlane datum = document.GetElement(datumRef) as DatumPlane;
                            if (showLeftBubble)
                               datum.ShowBubbleInView(DatumEnds.End0, view);
                            else
                               datum.HideBubbleInView(DatumEnds.End0, view);
                            if (showRightBubble)
                               datum.ShowBubbleInView(DatumEnds.End1, view);
                            else
                               datum.HideBubbleInView(DatumEnds.End1, view);
                            if (changeLeftEnd2D)
                               datum.SetDatumExtentType(DatumEnds.End0, view, DatumExtentType.ViewSpecific);
                            else
                               datum.SetDatumExtentType(DatumEnds.End0, view, DatumExtentType.Model);
                            if (changeRightEnd2D)
                               datum.SetDatumExtentType(DatumEnds.End1, view, DatumExtentType.ViewSpecific);
                            else
                               datum.SetDatumExtentType(DatumEnds.End1, view, DatumExtentType.Model);
                            if (addLeftElbow && datum.GetLeader(DatumEnds.End0, view) == null)
                               datum.AddLeader(DatumEnds.End0, view);
                            else if(datum.GetLeader(DatumEnds.End0, view) != null)
                            {
                               Leader leader =  datum.GetLeader(DatumEnds.End0, view);
                               leader = CalculateLeader(leader, addLeftElbow);
                               datum.SetLeader(DatumEnds.End0, view, leader);
                            }
                                                       
                            if (addRightElbow && datum.GetLeader(DatumEnds.End1, view) == null)
                               datum.AddLeader(DatumEnds.End1, view);
                            else if (datum.GetLeader(DatumEnds.End1, view) != null)
                            {
                               Leader leader = datum.GetLeader(DatumEnds.End1, view);
                               leader = CalculateLeader(leader, addRightElbow);
                               datum.SetLeader(DatumEnds.End1, view, leader);
                            }
                            
                         }
                         tran.Commit();
                      }                      
                   }                   
                }
                return Result.Succeeded;
            }
            catch (Exception ex)
            {
                message = ex.Message;
                return Result.Failed;
            }
        }

        private Leader CalculateLeader(Leader leader,bool addLeader)
        {
           XYZ end = leader.End;
           XYZ anchor = leader.Anchor;
           XYZ elbow = null;
           if (addLeftElbow)
              elbow = new XYZ(leader.Anchor.X + (leader.End.X - leader.Anchor.X) / 2,
                 leader.Anchor.Y + (leader.End.Y - leader.Anchor.Y) / 2,
                 leader.Anchor.Z + (leader.End.Z - leader.Anchor.Z) / 2);
           else
              elbow = new XYZ(leader.Anchor.X, leader.Anchor.Y, leader.Anchor.Z);
 
           leader.Elbow = elbow;
           return leader;
        }
    }

    /// <summary>
    /// Implements the Revit add-in interface IExternalCommand
    /// </summary>
    [Autodesk.Revit.Attributes.Transaction(Autodesk.Revit.Attributes.TransactionMode.Manual)]
    [Autodesk.Revit.Attributes.Regeneration(Autodesk.Revit.Attributes.RegenerationOption.Manual)]
    public class DatumAlignment : IExternalCommand
    {
       #region globle variable
       /// <summary>
       /// 
       /// </summary>
       public static Dictionary<string, DatumPlane> datumDic = new Dictionary<string, DatumPlane>();
       #endregion

       /// <summary>
       /// Implement this method as an external command for Revit.
       /// </summary>
       /// <param name="commandData">An object that is passed to the external application 
       /// which contains data related to the command, 
       /// such as the application object and active view.</param>
       /// <param name="message">A message that can be set by the external application 
       /// which will be displayed if a failure or cancellation is returned by 
       /// the external command.</param>
       /// <param name="elements">A set of elements to which the external application 
       /// can add elements that are to be highlighted in case of failure or cancellation.</param>
       /// <returns>Return the status of the external command. 
       /// A result of Succeeded means that the API external method functioned as expected. 
       /// Cancelled can be used to signify that the user cancelled the external operation 
       /// at some point. Failure should be returned if the application is unable to proceed with 
       /// the operation.</returns>
       public virtual Result Execute(ExternalCommandData commandData
           , ref string message, ElementSet elements)
       {
          try
          {
             Document document = commandData.Application.ActiveUIDocument.Document;
             Autodesk.Revit.DB.View view = commandData.Application.ActiveUIDocument.ActiveView;
             datumDic.Clear();
             ICollection<ElementId> datums = commandData.Application.ActiveUIDocument.Selection.GetElementIds();
             if (datums == null || datums.Count == 0)
                return Result.Cancelled;

             foreach (ElementId datumRef in datums)
             {
                DatumPlane datum = document.GetElement(datumRef) as DatumPlane;
                if (!datumDic.Keys.Contains(datum.Name))
                {
                   datumDic.Add(datum.Name, datum);
                }
                
             }

             //// Show UI                
             using (AlignmentSetting settingForm = new AlignmentSetting())
             {
                if (settingForm.ShowDialog() == DialogResult.OK)
                {
                   DatumPlane selectedDatum = datumDic[settingForm.datumList.SelectedItem.ToString()];
                   Curve baseCurve = selectedDatum.GetCurvesInView(DatumExtentType.ViewSpecific, view).ElementAt(0);
                   Line baseLine = baseCurve as Line;
                   XYZ baseDirect = baseLine.Direction;

                   using (Transaction tran = new Transaction(document, "DatumAlignment"))
                   {
                      tran.Start();

                      foreach (DatumPlane datum in datumDic.Values)
                      {
                         Curve curve = datum.GetCurvesInView(datum.GetDatumExtentTypeInView(DatumEnds.End0, view),view).ElementAt(0);
                         XYZ direct = (curve as Line).Direction;
                         Curve newCurve = CalculateCurve(curve,baseLine,baseDirect);
                         datum.SetCurveInView(datum.GetDatumExtentTypeInView(DatumEnds.End0, view), view, newCurve);                         
                      }
                      tran.Commit();
                   }
                }
             }
             return Result.Succeeded;
          }
          catch (Exception ex)
          {
             message = ex.Message;
             return Result.Failed;
          }
       }

       private Curve CalculateCurve(Curve curve,Curve baseCurve, XYZ baseDirect)
       {
          XYZ direct = (curve as Line).Direction;
          Line newCurve = null;
          if (Math.Round(direct.X) == Math.Round(baseDirect.X) && Math.Round(direct.X) == 1)
          {
             newCurve = Line.CreateBound(new XYZ(baseCurve.GetEndPoint(0).X, curve.GetEndPoint(0).Y, curve.GetEndPoint(0).Z)
                , new XYZ(baseCurve.GetEndPoint(1).X, curve.GetEndPoint(1).Y, curve.GetEndPoint(1).Z));
             
          }
          else if (Math.Round(direct.Y) == Math.Round(baseDirect.Y) && Math.Round(direct.Y) == 1)
          {
             newCurve = Line.CreateBound(new XYZ(curve.GetEndPoint(0).X, baseCurve.GetEndPoint(0).Y, curve.GetEndPoint(0).Z)
                , new XYZ(curve.GetEndPoint(1).X, baseCurve.GetEndPoint(1).Y, curve.GetEndPoint(1).Z));            
          }
          else
          {
             newCurve = Line.CreateBound(new XYZ(curve.GetEndPoint(0).X, curve.GetEndPoint(0).Y, baseCurve.GetEndPoint(0).Z)
                , new XYZ(curve.GetEndPoint(1).X, curve.GetEndPoint(1).Y, baseCurve.GetEndPoint(1).Z));
          }
          return newCurve;
       }
    }

    /// <summary>
    /// Implements the Revit add-in interface IExternalCommand
    /// </summary>
    [Autodesk.Revit.Attributes.Transaction(Autodesk.Revit.Attributes.TransactionMode.Manual)]
    [Autodesk.Revit.Attributes.Regeneration(Autodesk.Revit.Attributes.RegenerationOption.Manual)]
    public class DatumPropagation : IExternalCommand
    {
       #region globle variable
       /// <summary>
       /// 
       /// </summary>
       public static Dictionary<string, ElementId> viewDic = new Dictionary<string, ElementId>();
       #endregion

       /// <summary>
       /// Implement this method as an external command for Revit.
       /// </summary>
       /// <param name="commandData">An object that is passed to the external application 
       /// which contains data related to the command, 
       /// such as the application object and active view.</param>
       /// <param name="message">A message that can be set by the external application 
       /// which will be displayed if a failure or cancellation is returned by 
       /// the external command.</param>
       /// <param name="elements">A set of elements to which the external application 
       /// can add elements that are to be highlighted in case of failure or cancellation.</param>
       /// <returns>Return the status of the external command. 
       /// A result of Succeeded means that the API external method functioned as expected. 
       /// Cancelled can be used to signify that the user cancelled the external operation 
       /// at some point. Failure should be returned if the application is unable to proceed with 
       /// the operation.</returns>
       public virtual Result Execute(ExternalCommandData commandData
           , ref string message, ElementSet elements)
       {
          try
          {
             Document document = commandData.Application.ActiveUIDocument.Document;
             Autodesk.Revit.DB.View view = commandData.Application.ActiveUIDocument.ActiveView;
             viewDic.Clear();
             ElementId datumRef = commandData.Application.ActiveUIDocument.Selection.GetElementIds().First();
             if (datumRef == null)
                return Result.Cancelled;

             DatumPlane datum = document.GetElement(datumRef) as DatumPlane;
             ISet<ElementId> viewList = datum.GetPropagationViews(view);
             foreach (ElementId id in viewList)
             {
                Autodesk.Revit.DB.View pView = document.GetElement(id) as Autodesk.Revit.DB.View;
                if (!viewDic.Keys.Contains(pView.ViewType + " : " + pView.Name))
                {
                   viewDic.Add(pView.ViewType + " : " + pView.Name, id);
                }
             }

             //// Show UI                
             using (PropogateSetting settingForm = new PropogateSetting())
             {
                if (settingForm.ShowDialog() == DialogResult.OK)
                {
                   ISet<ElementId> pViewList = new List<ElementId>() as ISet<ElementId>;
                   foreach (var item in settingForm.propagationViewList.CheckedItems)
                   {
                      ElementId selectedView = viewDic[item.ToString()];
                      pViewList.Add(selectedView);
                   }
                   using (Transaction tran = new Transaction(document, "propagation"))
                   {
                      tran.Start();
                      datum.PropagateToViews(view, pViewList);
                      tran.Commit();
                   }
                   
                }
             }
             return Result.Succeeded;
          }
          catch (Exception ex)
          {
             message = ex.Message;
             return Result.Failed;
          }
       }
    }
}