Share via


XamlControlsResources.EnsureRevealLights(UIElement) メソッド

定義

重要

EnsureRevealLights は、要件セクションで指定されたオペレーティング システムで使用できます。 ただし、以降のバージョンでは変更されたり使用できなくなったりする可能性があるため、その使用はお勧めしません。

表示効果に必要なアンビエント ライトとボーダー ライトが、指定した要素に設定されていることを確認します。

このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKWinUI については、Windows アプリ SDK名前空間を参照してください)。

public:
 static void EnsureRevealLights(UIElement ^ element);
 static void EnsureRevealLights(UIElement const& element);
public static void EnsureRevealLights(UIElement element);
Public Shared Sub EnsureRevealLights (element As UIElement)

パラメーター

element
UIElement

表示効果の照明を必要とする要素。

注釈

通常、表示効果に必要なライトは自動的にアタッチされますが、場合によってはライトが失われたり、接続されたりすることはありません。 接続されていることを確認するには、このメソッドを呼び出します。

ライトは 1 回だけアタッチされるため、このメソッドは複数回呼び出すことができます。

このメソッドを呼び出す必要がある場合の例を次に示します。

  1. フル ウィンドウ メディア コントロールで表示されます (MediaTransportControls インスタンスを渡します)。
  2. アプリは Window.Content を設定します。これは RootScrolLViewer ライトを破棄します (メイン ツリー内の任意の要素を渡します)。

適用対象