Hoshiizumiya

Appearance

命名空间报错 ​

  • “GetAppWindowForElement”: 找不到标识符
  • “Helpers”:“::”左侧的符号必须是一种类型
  • “WinUIWindowHelper”:“::”左侧的符号必须是一种类型
  • “WindowHelper”:“::”左侧的符号必须是一种类型
  • "GetAppWindowForElement": 不是 "winrt::MicrosoftDocsGallery" 的成员

错误结论原因：

  • 要正确指向你想要的那个命名空间树。

原因（命名空间嵌套/遮蔽）

  • 你的文件在 namespace winrt::MicrosoftDocsGallery::implementation 里。
  • C++ 名称查找是“相对当前作用域”的。你写 MicrosoftDocsGallery::Helpers，会被解析为 winrt::MicrosoftDocsGallery::Helpers（投影命名空间），而不是全局的 ::MicrosoftDocsGallery::Helpers（你自己的助手库）。
  • 投影树 winrt::MicrosoftDocsGallery 和你自己的 ::MicrosoftDocsGallery 是两个不同的命名空间树，名字相同但不相关。

正确用法（任选其一）

  • 全局限定名（最直接）:
    • auto appWindow = ::MicrosoftDocsGallery::Helpers::WinUIWindowHelper::WindowHelper::GetAppWindowForElement(*this);
  • 起一个别名（推荐，放在文件顶部、所有命名空间之外）:
    • namespace WDHH = ::MicrosoftDocsGallery::Helpers::WinUIWindowHelper;
    • 使用：auto appWindow = WDHH::WindowHelper::GetAppWindowForElement(*this);
  • 不要加 winrt:: 前缀去找你的 Helper；那是另一棵命名空间树。

必须注意

  • 传 *this（投影对象），不要传 this（实现指针）。
  • 事件里若想取触发控件，传 sender.aswinrt::Microsoft::UI::Xaml::UIElement()。
  • 避免在 winrt::… 命名空间块内写 using namespace MicrosoftDocsGallery; 容易混淆/污染作用域。使用别名或全局前缀更安全。
  • ::MicrosoftDocsGallery 和 MicrosoftDocsGallery 指向不同命名空间。你的场景下它们确实不一样。

原因（名称查找与遮蔽）

  • 你的文件在 namespace winrt::MicrosoftDocsGallery::implementation 里。
  • 写 MicrosoftDocsGallery::… 时，编译器按“相对路径”从当前作用域向外查找：
    • 先看 winrt::MicrosoftDocsGallery 是否存在（存在，C++/WinRT 投影命名空间）。
    • 找到后就用它，不再去看全局的 ::MicrosoftDocsGallery。
  • 写 ::MicrosoftDocsGallery::… 时，前导 :: 强制从全局命名空间开始（“绝对路径”），因此指向你自己的命名空间树。

类比

  • MicrosoftDocsGallery 像相对路径；::MicrosoftDocsGallery 像绝对路径。
  • 当当前“目录”里已经有同名目录（winrt::MicrosoftDocsGallery）时，相对路径会走到那个，不会走到根下的同名目录。

在你的文件中的正确写法

  • 直接用全局限定名：::MicrosoftDocsGallery::Helpers::WinUIWindowHelper::WindowHelper::GetAppWindowForElement(*this)
  • 或定义别名（推荐，放在文件顶部、任何命名空间之外）：namespace WDHH = ::MicrosoftDocsGallery::Helpers::WinUIWindowHelper; 然后用 WDHH::WindowHelper::GetAppWindowForElement(*this)

提示

  • 不要加 winrt:: 前缀去找你的 Helper，它属于全局 ::MicrosoftDocsGallery 树。
  • 传 *this（投影 UIElement），不要传 this（实现指针）。