Autodesk.Revit.UI.Selection

合集 - Revit API(3)

1.Autodesk.Revit.DB Opening类2024-11-172.Autodesk.Revit.DB ReferenceIntersector2024-12-10

3.Autodesk.Revit.UI.Selection2024-12-19

收起

Autodesk.Revit.UI.Selection

Classes

PickedBox

包含两个 XYZ 点的类，表示屏幕上的选取框。

• Properties

  • Max

    最大坐标数（拾取框的右上角）。

  • Min

    最小坐标（拾取框的左下角）。

SelectableInViewFilter

一个过滤器，用于传递在给定视图中可选的元素。

• Constructors

  • SelectableInViewFilter (Document, ElementId)

    构造 SelectableInViewFilter 的新实例。

  • SelectableInViewFilter (Document, ElementId, Boolean)

    构造 SelectableInViewFilter 的新实例，并可选择传递所有不可选择的元素。

• Methods

  • PassesFilter(Element)

    将筛选器应用于给定元素。

  • PassesFilter(Document, ElementId)

    将筛选器应用于给定元素。

Selection

包含项目中当前用户选择的元素。

• Methods

  • Dispose

    释放 Selection 使用的所有资源

  • GetElementIds

    返回当前选定元素的 ID。

  • PickBox×2

    • PickBox(PickBoxStyle)

      调用一个通用的双击编辑器，该编辑器允许用户在屏幕上指定一个矩形区域。

    • PickBox(PickBoxStyle, String)

      调用一个通用的双击编辑器，该编辑器允许用户在屏幕上指定一个矩形区域。string为状态栏上显示的消息。

  • PickElementsByRectangle×4

    • PickElementsByRectangle

      通过绘制矩形来提示用户选择多个元素。

    • PickElementsByRectangle(String)

      通过绘制矩形来提示用户选择多个元素，同时显示自定义状态提示字符串。

    • PickElementsByRectangle(ISelectionFilter)

      通过绘制一个矩形来提示用户选择多个元素，该矩形通过用户过滤器。

    • PickElementsByRectangle(ISelectionFilter, String)

      通过绘制一个矩形来提示用户选择多个元素，该矩形通过客户过滤器，同时显示自定义状态提示字符串。

  • PickObject×4

    • PickObject(ObjectType)

      提示用户选择一个对象。

    • PickObject(ObjectType, ISelectionFilter)

      提示用户选择一个通过自定义过滤器的对象。

    • PickObject(ObjectType, String)

      提示用户选择一个对象，同时显示自定义状态提示字符串。

    • PickObject(ObjectType, ISelectionFilter, String)

      提示用户选择一个对象，该对象通过自定义筛选器，同时显示自定义状态提示字符串。

  • PickObjects×5

    • PickObjects(ObjectType)

      提示用户选择多个对象。

    • PickObjects(ObjectType, ISelectionFilter)

      提示用户选择多个对象，这些对象通过客户筛选器。

    • PickObjects(ObjectType, String)

      提示用户选择多个对象，同时显示自定义状态提示字符串。

    • PickObjects(ObjectType, ISelectionFilter, String)

      提示用户选择多个对象，这些对象通过自定义筛选器，同时显示自定义状态提示字符串。

    • PickObjects(ObjectType, ISelectionFilter, String, IList Reference )

      提示用户选择多个对象，这些对象通过自定义筛选器，同时显示自定义状态提示字符串。可以提供一组预选对象，并将在选择开始时选择。

  • PickPoint×4

    • PickPoint

      提示用户在活动工作平面上选取一个点。

    • PickPoint(String)

      提示用户在活动工作平面上选取一个点，同时显示自定义状态提示字符串。

    • PickPoint(ObjectSnapTypes)

      提示用户使用指定的捕捉设置在活动工作平面上选取一个点。

    • PickPoint(ObjectSnapTypes, String)

Interfaces

ISelectionFilter

一个接口，提供在选择操作期间筛选对象的功能。

• Examples

  - - public static IList<Element> GetManyRefByRectangle(UIDocument doc)
      {
      ReferenceArray ra = new ReferenceArray();
      ISelectionFilter selFilter = new MassSelectionFilter();
      IList<Element> eList = doc.Selection.PickElementsByRectangle(selFilter, 
          "Select multiple faces") as IList<Element>;
      return eList;
      }
  
  public class MassSelectionFilter : ISelectionFilter
  {
      public bool AllowElement(Element element)
      {
          if (element.Category.Name == "Mass")
          {
              return true;
          }
          return false;
      }
  
      public bool AllowReference(Reference refer, XYZ point)
      {
          return false;
      }
  
  }
  

• Methods

  • AllowElement

    重写此预筛选方法以指定是否应允许选择该元素。

  • AllowReference

    重写此后过滤方法以指定是否允许选择对几何图形的引用。

Enumerations

ObjectSnapTypes

此枚举类型包含在 PickPoint 操作期间允许设置的对象捕捉类型。

ObjectType

此枚举类型包含在选择操作期间允许选择的对象类型。

PickBoxStyle

控制选取框样式的枚举。

注：翻译自Revit API Docs 2018