AutomationEventHandler 代理人

定義

名前空間:

System.Windows.Automation

アセンブリ:

UIAutomationTypes.dll

UI オートメーション プロバイダーで発生するイベントを処理する UI オートメーション クライアント アプリケーションによって実装されるメソッドを表します。

C#

public delegate void AutomationEventHandler(object sender, AutomationEventArgs e);

パラメーター

sender

Object

イベントを発生させたオブジェクト。

e

AutomationEventArgs

イベントに関する情報。

例

次の例は、イベントをサブスクライブして処理する方法を示しています。

C#

// Member variables.
AutomationElement ElementSubscribeButton;
AutomationEventHandler UIAeventHandler;

/// <summary>
/// Register an event handler for InvokedEvent on the specified element.
/// </summary>
/// <param name="elementButton">The automation element.</param>
public void SubscribeToInvoke(AutomationElement elementButton)
{
    if (elementButton != null)
    {
        Automation.AddAutomationEventHandler(InvokePattern.InvokedEvent,
             elementButton, TreeScope.Element,
             UIAeventHandler = new AutomationEventHandler(OnUIAutomationEvent));
        ElementSubscribeButton = elementButton;
    }
}

/// <summary>
/// AutomationEventHandler delegate.
/// </summary>
/// <param name="src">Object that raised the event.</param>
/// <param name="e">Event arguments.</param>
private void OnUIAutomationEvent(object src, AutomationEventArgs e)
{
    // Make sure the element still exists. Elements such as tooltips
    // can disappear before the event is processed.
    AutomationElement sourceElement;
    try
    {
        sourceElement = src as AutomationElement;
    }
    catch (ElementNotAvailableException)
    {
        return;
    }
    if (e.EventId == InvokePattern.InvokedEvent)
    {
        // TODO Add handling code.
    }
    else
    {
        // TODO Handle any other events that have been subscribed to.
    }
}

private void ShutdownUIA()
{
    if (UIAeventHandler != null)
    {
        Automation.RemoveAutomationEventHandler(InvokePattern.InvokedEvent,
            ElementSubscribeButton, UIAeventHandler);
    }
}

注釈

デリゲートをAutomationEventHandler使用して、UI オートメーション イベントを処理するためにクライアントによって呼び出されるメソッドを指定します。

によってsender表される にはAutomationElement、アプリケーションがアクティブな間CacheRequestにこのイベントをサブスクライブしたかどうかに応じて、キャッシュされたプロパティまたはパターンがない場合があります。

拡張メソッド

適用対象

こちらもご覧ください

• AddAutomationEventHandler(AutomationEvent, AutomationElement, TreeScope, AutomationEventHandler)
• RemoveAutomationEventHandler(AutomationEvent, AutomationElement, AutomationEventHandler)
• AutomationEventArgs
• UI オートメーション イベントのサブスクライブ
• UI オートメーション イベントの概要