Revit API如何检查尺寸标注是否关联族参数

2021版Revit API未在Dimension类中提供直接判断是否关联族参数的公开属性，查阅FamilyManager、FamilyParameter、Dimension类未找到直接接口属于正常情况，可通过反向遍历参数关联关系实现，具体逻辑如下：

• 核心依赖接口：FamilyManager.GetAssociatedDimensions(FamilyParameter fp)
  该接口接收一个族参数对象，返回该参数直接驱动关联的所有尺寸标注的ElementId集合，是2021版本API已正式开放的可用接口。
• 实现逻辑：
  1. 进入族编辑环境的文档上下文，遍历当前族的所有族参数
  2. 对每个族参数调用上述接口，收集所有被族参数关联的尺寸标注ID，存入哈希集合做快速匹配
  3. 传入待判断的目标尺寸标注ID，检查是否存在于收集到的关联ID集合中，存在则代表该尺寸标注被族参数引用
• 可直接复用的代码示例：

/// <summary>
/// 判断族环境下的尺寸标注是否被族参数引用
/// </summary>
/// <param name="familyDoc">当前族文档</param>
/// <param name="targetDim">待判断的尺寸标注实例</param>
/// <returns>true=已被族参数引用，false=未被引用</returns>
public bool IsDimensionLinkedToFamilyParam(Document familyDoc, Dimension targetDim)
{
    if (!familyDoc.IsFamilyDocument)
        throw new InvalidOperationException("该逻辑仅支持在族文档环境下运行");
    
    HashSet<ElementId> linkedDimIds = new HashSet<ElementId>();
    FamilyManager familyManager = familyDoc.FamilyManager;
    
    // 遍历所有族参数收集关联的尺寸标注ID
    foreach (FamilyParameter param in familyManager.Parameters)
    {
        var associatedDims = familyManager.GetAssociatedDimensions(param);
        foreach (ElementId dimId in associatedDims)
        {
            linkedDimIds.Add(dimId);
        }
    }

    return linkedDimIds.Contains(targetDim.Id);
}

• 注意避坑：
  • 不要使用Dimension.IsLabeled属性做判断，该属性仅标识尺寸标注是否添加了自定义文字标签，和族参数关联无对应关系，会出现大量误判
  • 上述逻辑仅能识别直接被族参数驱动的尺寸标注，如果是嵌套族内部的标注、或者通过公式/全局参数间接关联的标注，需要递归遍历嵌套族文档、补充全局参数关联逻辑后再做判断
  • 项目文档环境下不存在族参数引用尺寸标注的场景，该逻辑无需在项目环境下调用

内容的提问来源于stack exchange，提问作者itono