SystemBackdrop.OnTargetConnected メソッド

定義

名前空間:

Microsoft.UI.Xaml.Media

このオブジェクトが有効なコンテナーにアタッチされている場合に呼び出されます。たとえば、 を に Window.SystemBackdrop設定した場合などです。

protected:
 virtual void OnTargetConnected(ICompositionSupportsSystemBackdrop ^ connectedTarget, XamlRoot ^ xamlRoot) = OnTargetConnected;

void OnTargetConnected(ICompositionSupportsSystemBackdrop const& connectedTarget, XamlRoot const& xamlRoot);

protected virtual void OnTargetConnected(ICompositionSupportsSystemBackdrop connectedTarget, XamlRoot xamlRoot);

function onTargetConnected(connectedTarget, xamlRoot)

Protected Overridable Sub OnTargetConnected (connectedTarget As ICompositionSupportsSystemBackdrop, xamlRoot As XamlRoot)

パラメーター

connectedTarget

ICompositionSupportsSystemBackdrop

背景のターゲット。

xamlRoot

XamlRoot

背景ターゲットの XAML ルート。

例

完全な例については、「 SystemBackdrop 」を参照してください。

protected override void OnTargetConnected(ICompositionSupportsSystemBackdrop connectedTarget, XamlRoot xamlRoot)
{
    // Call the base method to initialize the default configuration object.
    base.OnTargetConnected(connectedTarget, xamlRoot);

    // This example does not support sharing MicaSystemBackdrop instances.
    if (micaController is not null)
    {
        throw new Exception("This controller cannot be shared");
    }

    micaController = new MicaController();
    // Set configuration.
    SystemBackdropConfiguration defaultConfig = GetDefaultSystemBackdropConfiguration(connectedTarget, xamlRoot);
    micaController.SetSystemBackdropConfiguration(defaultConfig);
    // Add target.
    micaController.AddSystemBackdropTarget(connectedTarget);
}

注釈

このメソッドは、この SystemBackdrop が有効なコンテナーにアタッチされている場合に呼び出されます。つまり、 Window.SystemBackdrop など、 ICompositionSupportsSystemBackdrop を実装するオブジェクトの SystemBackdrop プロパティに割り当てられる場合です。

基になる ISystemBackdropController とその SystemBackdropConfiguration を作成して構成するには、このメソッドをオーバーライド します。

こちらもご覧ください

• OnTargetDisconnected(ICompositionSupportsSystemBackdrop)