GettingFocusEventArgs.CorrelationId プロパティ

定義

重要

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

編集

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

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

winrt::guid CorrelationId();

public Guid CorrelationId { get; }

var guid = gettingFocusEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Guid

Guid

Platform::Guid

winrt::guid

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

既定値は null です。

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

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

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

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

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

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

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

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