Função winrt::get_class_name (C++/WinRT)

  • Artigo

Uma função auxiliar que recupera uma cadeia de caracteres que contém o nome de tipo totalmente qualificado da classe Windows Runtime representada por um objeto de um determinado tipo projetado. Esse é o mesmo valor retornado de uma chamada para IInspectable::GetRuntimeClassName.

Essa é uma função livre que recupera o nome da classe de runtime de qualquer IInspectable arbitrário. Para a função membro gerada automaticamente que está disponível apenas em tipos de implementação, consulte GetRuntimeClassName. Para obter uma explicação sobre o tipo de implementação e os conceitos de tipo projetado, consulte Consumir APIs com C++/WinRT e Criar APIs com C++/WinRT.

Sintaxe

inline winrt::hstring get_class_name(winrt::Windows::Foundation::IInspectable const& object);

Parâmetros

objectUma instância do tipo projetado para uma classe Windows Runtime (qualquer classe de runtime; seja um tipo do Windows ou um tipo de segundo ou de terceiros).

Valor retornado

Um winrt::hstring que contém o nome de tipo totalmente qualificado da classe Windows Runtime representada por object. Observe que o tipo da classe Windows Runtime é retornado, não o do tipo projetado. No exemplo a seguir, o tipo projetado C++/WinRT é winrt::Windows::Foundation::Uri, mas o valor retornado de winrt::get_class_name é "Windows.Foundation.Uri", que é o nome de tipo da classe de runtime.

Exemplo

winrt::Windows::Foundation::Uri contosoUri{ L"https://www.contoso.com" };
winrt::hstring name = winrt::get_class_name(contosoUri);
assert(name == L"Windows.Foundation.Uri");

Requisitos

SDK mínimo com suporte: SDK do Windows versão 10.0.17134.0 (Windows 10, versão 1803)

Namespace: winrt

Cabeçalho: %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (incluído por padrão)

Confira também