Hoshiizumiya

Appearance

WinUI 3 页面初始化之 InitializeComponent ​

引言 ​

在 WinUI 3/C++/WinRT 项目中，InitializeComponent() 是一个重要的函数，用于加载 XAML 文件并初始化页面或控件。它通常在构造函数中调用，以确保页面的 UI 元素被正确创建和配置。

1. InitializeComponent() 的作用 ​

在 WinUI 3/C++/WinRT 项目中，InitializeComponent() 通常只需要在构造函数里调用一次，用于加载 XAML 并初始化控件。

InitializeComponent() 函数解析 ​

C++/WinRT InitializeComponent 官方解释InitializeComponent() 是 WinUI 应用程序中的一个关键函数，用于初始化 XAML 界面组件。这个函数的主要作用包括：

功能概述 ​

  1. XAML 解析与加载：该函数负责解析和加载在 XAML 文件中定义的 UI 元素

  2. 控件实例化：将 XAML 中声明的所有控件（按钮、文本框、列表等）实例化为实际的 C++ 对象

  3. 建立事件连接：将 XAML 中定义的事件处理程序与 C++ 代码中的函数进行关联

  4. 应用样式和资源：加载并应用在 XAML 中定义的样式、主题和资源

在代码中的位置和作用 ​

在你的 MainWindow 构造函数中，InitializeComponent() 是构造过程中的第一个调用：

cpp
MainWindow::MainWindow()
{
    InitializeComponent();
}

这保证了在构造函数中进行任何其他操作前，UI 组件已经被正确初始化和准备就绪。在这个例子中，只有在调用 InitializeComponent() 之后，才能对 sourceList() 进行操作。

工作原理 ​

InitializeComponent() 函数通常是由页面构造后自动调用，不需要手动编写。它在幕后完成以下工作：

  • 将 XAML 标记转换为实际的 UI 元素
  • 将这些元素添加到视觉树中
  • 设置在 XAML 中定义的属性
  • 连接事件处理程序

总结 ​

InitializeComponent() 是连接 XAML 声明式 UI 和 C++ 代码的桥梁，确保在应用程序启动时正确设置用户界面。它是 XAML 基础设施的核心部分，在所有 WinUI 窗口和页面的构造函数中都必须调用。

在 Page_Loaded 事件处理函数里再次调用 InitializeComponent() 是多余的，甚至可能导致异常或重复初始化。

一般流程：

cpp
UserMainPage::UserMainPage()
{
    InitializeComponent(); // 只在这里调用一次
    // 其他初始化逻辑
}

void UserMainPage::Page_Loaded(IInspectable const& sender, RoutedEventArgs const& e)
{
    // 这里不需要 InitializeComponent()
    // 可以放置页面加载后的逻辑
}

小结：
InitializeComponent() 只需在构造函数中调用一次，Page_Loaded 里不需要。

2. InitializeComponent() 的必要性 ​

1. 构造函数里没写 InitializeComponent() 页面会隐式初始化吗？ ​

不会在构造前调用隐式初始化，只会在构造后隐式初始化。
在 C++/WinRT（WinUI 3）中，如果你要在构造里实现部分和页面的内容有关的方法控件、InitializeComponent() 必须在页面类的构造函数里手动调用。
如果你没调用，XAML 里的控件不会被实例化，成员变量（如 Button、Frame 等）也不会被绑定，访问这些控件会导致空指针异常。

C# 里会自动生成并调用，但 C++/WinRT 需要你自己写！！

2. InitializeComponent() 都做了什么？ ​

  • 解析并加载对应的 XAML 文件（如 UserMainPage.xaml）。
  • 创建并实例化 XAML 里声明的所有控件对象。
  • 将 XAML 里 x:Name 标记的控件，绑定到 C++ 类的同名成员变量。
  • 连接 XAML 里声明的事件（如 Click="OnClick"）到 C++ 的事件处理函数。

简言之：它让你的 C++ 代码和 XAML UI 关联起来。

3. 页面加载顺序和函数执行流程 ​

以 UserMainPage 为例，典型流程如下：

  1. 构造函数

    • 你手动调用 InitializeComponent()，XAML 被加载，控件被实例化。
    • 可以在这里做成员变量初始化、注册事件等。

  2. Loaded 事件

    • 页面元素已加载到可视树，控件都可用。
    • 适合做依赖控件的初始化、数据绑定等。

  3. OnNavigatedTo（如果有）

    • 页面被导航到时触发，适合处理导航参数。

常见顺序：

  • 构造函数 → InitializeComponent → Loaded 事件 → OnNavigatedTo

4. 小结与建议 ​

  • C++/WinRT 必须手动调用 InitializeComponent()，否则 XAML 不会生效。
  • 它负责加载 XAML、实例化控件、事件绑定等。
  • 推荐在构造函数里第一行调用。
  • 页面加载顺序：构造函数 → InitializeComponent → Loaded → OnNavigatedTo

3.C++/WinRT XAML 控件访问与 InitializeComponent 详解 ​

C++/WinRT 下 XAML 控件的生成与访问机制

  • InitializeComponent() 的作用
    它负责加载 XAML 文件，实例化界面控件，并把带有 x:Name 的控件和 C++ 类的同名方法（通常是自动生成的 getter）关联起来。
  • 如果不调用 InitializeComponent()
    XAML 文件不会被加载，控件不会被实例化。你访问 x:Name 相关的控件 getter 时，返回的是未初始化的对象（通常为 nullptr），访问其成员会崩溃。 如图所示：
  • InitializeComponent

小贴士 ​

你可以试着注释掉 InitializeComponent()，然后访问 x:Name 控件，调试时会发现控件是空的。