LosingFocusEventArgs.CorrelationId プロパティ

リファレンス

定義

名前空間:: Windows.UI.Xaml.Input

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

フォーカス移動イベントが開始されたときに生成される一意の ID を取得します。

public:
 property Platform::Guid CorrelationId { Platform::Guid get(); };

winrt::guid CorrelationId();

public Guid CorrelationId { get; }

var guid = losingFocusEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Guid

プロパティ値

Guid

Platform::Guid

winrt::guid

一意の ID (存在する場合)。それ以外の場合は null。

既定値は null です。

Windows の要件

デバイスファミリ	Windows 10, version 1809 (10.0.17763.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v7.0 で導入)

注釈

フォーカスを移動すると、多数の直接および間接的なアクションが発生する可能性があります。

たとえば、LosingFocus で始まり、LostFocus (GettingFocus) を通って GotFocus に移動するイベントの標準的なシーケンスがあります。通常、これらのフォーカスイベントは、要素ツリー内の複数の要素 ( FocusManager を含む) を介してルーティングされます。

場合によっては、フォーカスイベントが再ルーティングされる場合もあります。たとえば、何らかの理由でターゲット要素が無効な場合は、LosingFocus イベントから TrySetNewFocusedElement を呼び出して、フォーカスを別の要素に再ターゲットすることができます。

それ以外の場合は、いずれかのフォーカスイベントハンドラーからフォーカスの変更を取り消す必要がある場合があります。

さらに、フォーカスイベントは非同期的に発生するため、以前のフォーカスイベントの実行が完了する前に、フォーカスが再び変更される可能性があります。

フォーカスイベントが開始されるたびに、これらのフォーカスアクション全体でフォーカスイベントを追跡するのに役立つ一意の CorrelationId が生成されます。

次の場合に新しい CorrelationId が生成されます。

ユーザーがフォーカスを移動します。
アプリは、Control.Focus や FocusManager.TryFocusAsync などのメソッドを使用してフォーカスを移動します。
ウィンドウのアクティブ化により、アプリのフォーカスが取得または失われます (「CoreWindow.Activated」を参照)。

適用対象

こちらもご覧ください

CorrelationId