如何通过Visual3D的AddVisual3DChild方法向UIElement3D添加Visual3D对象

你调用AddVisual3DChild后看不到元素的核心原因是：WPF的3D渲染引擎枚举视觉树时，依赖两个你没有重写的成员来识别子元素，只调用添加方法不会让框架感知到子元素的存在，自然不会渲染。

• 首先在自定义类中维护一个本地集合存储子Visual3D，用于框架枚举时读取
• 重写Visual3DChildrenCount属性，返回本地集合的元素总数
• 重写GetVisual3DChild(int index)方法，根据索引返回对应子元素
• 新增/删除子元素时，除了调用基类的AddVisual3DChild/RemoveVisual3DChild方法，还要同步更新本地集合，并通知WPF重绘

完整可运行代码示例 #

public class MyClass : UIElement3D
{
    // 本地存储子Visual3D的集合
    private readonly List<Visual3D> _childVisuals = new List<Visual3D>();

    public MyClass(Visual3D object3D)
    {
        AddChild(object3D);
    }

    // 公开的子元素添加方法
    public void AddChild(Visual3D child)
    {
        if (child == null)
            throw new ArgumentNullException(nameof(child));
        if (_childVisuals.Contains(child))
            return;
        
        _childVisuals.Add(child);
        // 建立父子视觉关联
        AddVisual3DChild(child);
        // 通知WPF视觉树变更，触发重绘
        InvalidateVisual();
    }

    // 重写属性返回子元素总数，供渲染框架读取
    protected override int Visual3DChildrenCount => _childVisuals.Count;

    // 重写方法返回指定索引的子元素，供渲染框架遍历
    protected override Visual3D GetVisual3DChild(int index)
    {
        if (index < 0 || index >= _childVisuals.Count)
            throw new ArgumentOutOfRangeException(nameof(index));
        return _childVisuals[index];
    }

    // 按需添加子元素删除方法
    public void RemoveChild(Visual3D child)
    {
        if (child == null || !_childVisuals.Contains(child))
            return;
        
        _childVisuals.Remove(child);
        RemoveVisual3DChild(child);
        InvalidateVisual();
    }
}

• 如果你不需要用到UIElement3D的输入响应、命中测试等UI相关特性，更推荐直接继承ModelVisual3D，它已经内置了子元素管理逻辑，直接操作Children集合即可，不需要自己重写上述方法
• 重写GetVisual3DChild时必须做好索引合法性校验，避免渲染过程中抛出未处理异常

内容的提问来源于stack exchange，提问作者Usman Mohammad Hussain