AutomationPeer.GetPatternCore(PatternInterface) メソッド

定義

Microsoft UI オートメーション クライアントが GetPattern または同等の Microsoft UI オートメーション クライアント API を呼び出した場合のピアの動作を提供します。

protected:
 virtual Platform::Object ^ GetPatternCore(PatternInterface patternInterface) = GetPatternCore;
IInspectable GetPatternCore(PatternInterface const& patternInterface);
protected virtual object GetPatternCore(PatternInterface patternInterface);
function getPatternCore(patternInterface)
Protected Overridable Function GetPatternCore (patternInterface As PatternInterface) As Object

パラメーター

patternInterface
PatternInterface

PatternInterface 列挙の値。

戻り値

Object

Platform::Object

IInspectable

パターン インターフェイスを実装する オブジェクト。ピアがこのインターフェイスをサポートしていない場合は null

注釈

基本ピア クラスではパターンがサポートされていないため、 AutomationPeer レベルの標準実装では null が返されます。 既存のWindows ランタイム ピア クラスの大部分は、このメソッドをオーバーライドして、特定のピアがサポートするパターンを報告します。

ピア クラスでサポートされているパターンの実装を返すためにこのメソッドをオーバーライドすることは、オートメーション ピアを実装するための最も一般的なシナリオの 1 つです。 「カスタム オートメーション ピア」を参照してください。

OnCreateAutomationPeer によって返されるカスタム ピアを定義する OnCreateAutomationPeer の実装については、XAML アクセシビリティ サンプル (このサンプルは維持されておらず、コンパイルされない可能性があることに注意してください) を参照してください (ピアの実装はサンプルのシナリオ 3 にあります)。

Windows 8 の動作

Windows 8ピア選択の動作は、コントロールがデータをアイテムとして表示することを意図しているかどうかによって影響を受ける可能性があります。 Windows 8の自動化ロジックでは、コントロール全体に対してピアが示され、そのピアが GetPatternCore をオーバーライドした場合でも、専用のデータ ピアを選択してそのパターンを使用する場合があります。 たとえば、パターンに対して ListViewAutomationPeer オーバーライドがある場合がありますが、Windows 8では、データ項目の動作パターンが優先される場合があります。たとえば、ListViewItemDataAutomationPeer の既定の実装が使用され、アイテム内のパターンUI オートメーション検索するときにスクロール パターンが処理されます。 これは、Windows 8.1以降は異なります。コントロール全体の GetPatternCore 実装にパターン サポートが示されている場合、その実装は内部アイテム データ ピアの代わりに使用されます。

アプリ コードを Windows 8 から Windows 8.1 に移行する場合は、この動作の変更を考慮する必要がある場合があります。これは、アイテム コントロール パターンのサポートがデータ アイテムにも使用される可能性があり、たとえば、アイテムのスクロールに動作を追加する必要がある場合があるためです。

Windows 8 用にコンパイルしたアプリは、Windows 8.1 上で実行しても Windows 8 のときと同じ動作になります。

適用対象

こちらもご覧ください