次の方法で共有


GettingFocusEventArgs.CorrelationId プロパティ

定義

フォーカス移動イベントが開始されたときに生成される一意の 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 の要件

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

注釈

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

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

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

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

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

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

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

適用対象

こちらもご覧ください