Partilhar via


Chamando e substituindo seu tipo base com C++/WinRT

Importante

Para conceitos e termos essenciais que apoiam a sua compreensão de como consumir e criar classes de tempo de execução com C++/WinRT, consulte Consumir APIs com C++/WinRT e Criar APIs com C++/WinRT.

Implementando métodos substituíveis, como MeasureOverride e OnApplyTemplate

Há alguns pontos de extensão em XAML aos quais seu aplicativo pode se conectar, por exemplo:

Você deriva um controlo personalizado da classe de tempo de execução Control, a qual é derivada ainda mais de classes de tempo de execução base. E há overridable métodos de Control, FrameworkElemente UIElement que você pode substituir em sua classe derivada. Aqui está um exemplo de código mostrando como fazer isso.

struct BgLabelControl : BgLabelControlT<BgLabelControl>
{
...
    // Control overrides.
    void OnPointerPressed(Windows::UI::Xaml::Input::PointerRoutedEventArgs const& /* e */) const { ... };

    // FrameworkElement overrides.
    Windows::Foundation::Size MeasureOverride(Windows::Foundation::Size const& /* availableSize */) const { ... };
    void OnApplyTemplate() const { ... };

    // UIElement overrides.
    Windows::UI::Xaml::Automation::Peers::AutomationPeer OnCreateAutomationPeer() const { ... };
...
};

Métodos que podem ser substituídos manifestam-se de forma diferente em diferentes projeções linguísticas. Em C#, por exemplo, métodos substituíveis normalmente aparecem como métodos virtuais protegidos. Em C++/WinRT, eles não são virtuais nem protegidos, mas você ainda pode substituí-los e fornecer sua própria implementação, como mostrado acima.

Se você estiver substituindo um desses métodos substituíveis em C++/WinRT, seu runtimeclass IDL não deve declarar o método. Para obter mais informações sobre a base_type sintaxe mostrada, consulte a próxima seção neste tópico (Chamando seu tipo base).

IDL

namespace Example
{
    runtimeclass CustomVSM : Windows.UI.Xaml.VisualStateManager
    {
        CustomVSM();
        // note that we don't declare GoToStateCore here
    }
}

C++/WinRT

namespace winrt::Example::implementation
{
    struct CustomVSM : CustomVSMT<CustomVSM>
    {
        CustomVSM() {}

        bool GoToStateCore(winrt::Windows::UI::Xaml::Controls::Control const& control, winrt::Windows::UI::Xaml::FrameworkElement const& templateRoot, winrt::hstring const& stateName, winrt::Windows::UI::Xaml::VisualStateGroup const& group, winrt::Windows::UI::Xaml::VisualState const& state, bool useTransitions) {
            return base_type::GoToStateCore(control, templateRoot, stateName, group, state, useTransitions);
        }
    };
}

Chamando seu tipo base

Pode aceder ao seu tipo base e chamar métodos nele, usando o alias de tipo base_type. Vimos um exemplo disso na seção anterior; mas você pode usar base_type para acessar qualquer membro da classe base (não apenas métodos substituídos). Aqui está um exemplo:

struct MyDerivedRuntimeClass : MyDerivedRuntimeClassT<MyDerivedRuntimeClass>
{
    ...

    void Foo()
    {
        // Call my base type's Bar method.
        base_type::Bar();
    }
};

APIs importantes