UWP Pivot控件：首次显示PivotItem时如何自动聚焦内部首个控件？

嘿，这个需求我之前做UWP项目时刚好遇到过，给你分享两个实用的解决方案，都能实现首次切换到PivotItem时自动把焦点定位到页面的首个输入控件上！

方法一：通过Pivot的SelectionChanged事件统一处理 #

这个方法适合所有PivotItem都遵循相同焦点规则的场景，在Pivot的切换事件里统一查找并设置焦点。

首先给你的Pivot添加SelectionChanged事件绑定：

<Pivot ItemsSource="{x:Bind ViewModels}" 
       ItemTemplateSelector="{StaticResource ViewModelSelector}" 
       SelectedItem="{x:Bind SelectedViewModel, Mode=TwoWay}"
       SelectionChanged="Pivot_SelectionChanged"/>

然后在后台代码中实现事件逻辑，核心是找到当前选中PivotItem里的首个可聚焦控件，并设置焦点：

private void Pivot_SelectionChanged(object sender, SelectionChangedEventArgs e)
{
    if (sender is not Pivot pivot || pivot.SelectedItem == null) return;

    // 获取当前选中的PivotItem容器
    var pivotItem = pivot.ContainerFromItem(pivot.SelectedItem) as PivotItem;
    if (pivotItem == null) return;

    // 延迟执行确保UI渲染完成（PivotItem切换时内容可能还没加载完毕）
    _ = DispatcherQueue.TryEnqueue(async () =>
    {
        await Task.Delay(100); // 可根据实际情况调整延迟时间
        var firstFocusableElement = FindFirstFocusableElement(pivotItem.Content as FrameworkElement);
        firstFocusableElement?.Focus(FocusState.Programmatic);
    });
}

// 递归遍历视觉树，找到第一个可聚焦的控件
private FrameworkElement FindFirstFocusableElement(FrameworkElement parent)
{
    if (parent == null) return null;

    // 检查当前控件是否满足可聚焦条件
    if (parent.Focusable && parent.IsEnabled && parent.Visibility == Visibility.Visible)
    {
        return parent;
    }

    // 遍历所有子元素递归查找
    for (int i = 0; i < VisualTreeHelper.GetChildrenCount(parent); i++)
    {
        if (VisualTreeHelper.GetChild(parent, i) is FrameworkElement child)
        {
            var result = FindFirstFocusableElement(child);
            if (result != null) return result;
        }
    }

    return null;
}

注意点： #

• 加入Task.Delay是因为PivotItem切换时，其内容控件可能还没完成渲染，直接查找会找不到目标元素，延迟时间可以根据你的UI复杂度调整。
• 使用FocusState.Programmatic来设置焦点，避免干扰用户的手动操作逻辑。

方法二：在对应UserControl的Loaded事件中单独处理 #

如果不同的PivotItem页面有不同的焦点需求（比如某些页面需要聚焦到第二个输入框），这个方法更灵活，每个页面自己控制焦点逻辑。

假设你的DataTemplate对应的是一个自定义InputFormUserControl，在这个控件的后台代码中添加Loaded事件处理：

public InputFormUserControl()
{
    InitializeComponent();
    Loaded += InputFormUserControl_Loaded;
}

private void InputFormUserControl_Loaded(object sender, RoutedEventArgs e)
{
    // 方式1：直接指定目标控件（适合明确知道要聚焦的控件）
    // txtFirstName.Focus(FocusState.Programmatic);

    // 方式2：通用查找（和方法一的递归逻辑一样，可封装成工具类复用）
    var firstFocusable = FindFirstFocusableElement(this);
    firstFocusable?.Focus(FocusState.Programmatic);
}

// 通用的可聚焦控件查找方法，可提取到静态工具类中
private static FrameworkElement FindFirstFocusableElement(FrameworkElement parent)
{
    if (parent == null) return null;

    if (parent.Focusable && parent.IsEnabled && parent.Visibility == Visibility.Visible)
    {
        return parent;
    }

    for (int i = 0; i < VisualTreeHelper.GetChildrenCount(parent); i++)
    {
        if (VisualTreeHelper.GetChild(parent, i) is FrameworkElement child)
        {
            var result = FindFirstFocusableElement(child);
            if (result != null) return result;
        }
    }

    return null;
}

优势： #

• 每个页面的焦点逻辑独立，不需要在Pivot层面统一管理，扩展性更强。
• 不需要额外处理延迟，因为Loaded事件触发时控件已经完全渲染完成。

两种方法都能完美解决你的需求，你可以根据自己的项目场景选择合适的方案~

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