UIElement.OnCreateAutomationPeer メソッド

protected:
 virtual AutomationPeer ^ OnCreateAutomationPeer() = OnCreateAutomationPeer;

AutomationPeer OnCreateAutomationPeer();

protected virtual AutomationPeer OnCreateAutomationPeer();

function onCreateAutomationPeer()

Protected Overridable Function OnCreateAutomationPeer () As AutomationPeer

返品

返されるクラス固有 の AutomationPeer サブクラス。

例

OnCreateAutomationPeer実装全体は、カスタム オートメーション ピア クラスを構築して返す必要があります。

protected override AutomationPeer OnCreateAutomationPeer() 
{
    return new MediaContainerAP(this, mediaElement); 
}

#include "MediaContainerAP.h"
...
public:
    MyNamespace::MediaContainerAP OnCreateAutomationPeer()
    {
        return winrt::make<MyNamespace::implementation::MediaContainerAP>(*this, mediaElement());
    }

注釈

オートメーション ピアの目的と、クラス固有の AutomationPeer クラスを定義する必要がある理由の詳細については、「 カスタム オートメーション ピア」を参照してください。

このメソッドは、既定のOnCreateAutomationPeer実装によって参照される既定のピアではなく、Microsoft UI オートメーション用のカスタム オートメーション ピアを指定するカスタム クラスでオーバーライドする必要があります。 カスタム コントロールのカスタム ピアを定義する方法は、コントロールのアクセシビリティ要件、UI コントラクト、およびその動作によって異なります。 新しいピアを定義する理由の詳細については、「 カスタム オートメーション ピア」を参照してください。

OnCreateAutomationPeer実装では、カスタム オートメーション ピアの新しいインスタンスを初期化し、呼び出し元のコントロールを所有者として渡し、そのインスタンスを返す以外に何もしないことをお勧めします。 このメソッドで追加のロジックを試みないでください。 特に、同じ呼び出し内で AutomationPeer が破棄される可能性があるロジックは、予期しないランタイム動作を引き起こす可能性があります。

こちらもご覧ください

• AutomationPeer
• Windows デスクトップ アプリでのプログラムによるアクセシビリティに関する一般的な問題を解決するためのコード サンプル
• カスタム オートメーション ピア
• アクセシビリティ