如何在Xceed PropertyGrid中程序化聚焦指定属性项？附加属性实现遇错

阿华AIGC实验室

2026-5-15

解决Xceed PropertyGrid程序化设置焦点到指定属性的问题

第一步：修复附加属性的类型不匹配异常

你遇到的ArgumentException核心原因是附加属性的默认值类型与属性定义类型不匹配：注册FocusId（string类型）时，你给的默认值是布尔值false，这直接触发了类型不匹配的错误。修改附加属性的注册代码，把默认值改为string类型的有效值：

public class Focuser
{
    // 修复：默认值改为string.Empty（或null），与属性类型一致
    public static readonly DependencyProperty FocusIdProperty = DependencyProperty
        .RegisterAttached("FocusId", typeof(string), typeof(Focuser), 
            new FrameworkPropertyMetadata(string.Empty, FrameworkPropertyMetadataOptions.AffectsRender));

    public static void SetFocusId(UIElement element, string value)
    {
        element.SetValue(FocusIdProperty, value);
    }

    public static string GetFocusId(UIElement element)
    {
        return (string)element.GetValue(FocusIdProperty);
    }

    public static void TrySetFocus(UIElement within, string focusId)
    {
        if (string.Equals(GetFocusId(within), focusId, StringComparison.Ordinal))
        {
            // 确保元素可聚焦，同时设置逻辑焦点和键盘焦点
            if (within.Focusable)
            {
                within.Focus();
                Keyboard.Focus(within);
            }
            return; // 找到目标后直接返回，避免无效遍历
        }

        for (int i = 0; i < VisualTreeHelper.GetChildrenCount(within); ++i)
        {
            var child = VisualTreeHelper.GetChild(within, i);
            if (child is UIElement uiChild)
            {
                TrySetFocus(uiChild, focusId);
            }
        }
    }
}

注：附加属性命名加上Property后缀是WPF的惯例，能避免潜在的绑定或识别问题。

第二步：适配Xceed PropertyGrid的焦点设置逻辑

Xceed PropertyGrid的属性项基于PropertyItem类型，编辑器模板绑定到PropertyItem的Value。针对它的结构，有两种更可靠的焦点实现方式：

方法1：通过SelectedProperty直接聚焦（推荐）

利用Xceed PropertyGrid自带的SelectedProperty属性，先定位目标属性项，再找到对应的编辑器控件并聚焦：

// 假设你的PropertyGrid实例是EmployeeInfoPG
private void FocusTargetProperty(string propertyName)
{
    // 找到目标属性对应的PropertyItem
    var targetProperty = EmployeeInfoPG.Properties.FirstOrDefault(p => p.Name == propertyName);
    if (targetProperty == null) return;

    // 设置选中属性
    EmployeeInfoPG.SelectedProperty = targetProperty;

    // 延迟到UI渲染完成后查找编辑器，避免控件尚未生成
    Dispatcher.BeginInvoke(new Action(() =>
    {
        var editor = FindPropertyEditor<TextBox>(EmployeeInfoPG, targetProperty);
        if (editor != null)
        {
            editor.Focus();
            Keyboard.Focus(editor);
        }
    }), DispatcherPriority.Render);
}

// 辅助方法：根据PropertyItem查找对应的编辑器控件
private T FindPropertyEditor<T>(DependencyObject parent, PropertyItem targetProperty) where T : UIElement
{
    for (int i = 0; i < VisualTreeHelper.GetChildrenCount(parent); i++)
    {
        var child = VisualTreeHelper.GetChild(parent, i);
        // 先找到属性项的容器
        if (child is PropertyItemContainer container && container.PropertyItem == targetProperty)
        {
            return FindVisualChild<T>(container);
        }
        else
        {
            var result = FindPropertyEditor<T>(child, targetProperty);
            if (result != null) return result;
        }
    }
    return null;
}

// 通用可视化树查找方法
private T FindVisualChild<T>(DependencyObject parent) where T : UIElement
{
    for (int i = 0; i < VisualTreeHelper.GetChildrenCount(parent); i++)
    {
        var child = VisualTreeHelper.GetChild(parent, i);
        if (child is T tControl) return tControl;
        
        var result = FindVisualChild<T>(child);
        if (result != null) return result;
    }
    return null;
}

调用时只需执行：FocusTargetProperty("BirthDateStr");

方法2：改进附加属性的使用方式

如果你坚持用附加属性标记编辑器，需要确保在PropertyGrid属性生成完成后再调用焦点逻辑：

简化XAML中的附加属性设置（无需嵌套Style）：

<xctk:EditorDefinition.EditorTemplate>
    <DataTemplate>
        <TextBox Text="{Binding Value}" local:Focuser.FocusId="BirthDateStr" />
    </DataTemplate>
</xctk:EditorDefinition.EditorTemplate>

在PropertyGrid加载完成或属性生成后调用焦点方法：

private void EmployeeInfoPG_Loaded(object sender, RoutedEventArgs e)
{
    // 延迟执行，确保属性项已生成
    Dispatcher.BeginInvoke(new Action(() => 
    {
        Focuser.TrySetFocus(EmployeeInfoPG, "BirthDateStr");
    }), DispatcherPriority.Render);
}