AutomationEventHandler Delegate
.NET Framework 3.0
Represents the method implemented by the UI Automation client application to handle an event raised by a UI Automation provider.
Namespace: System.Windows.Automation
Assembly: UIAutomationTypes (in uiautomationtypes.dll)
Assembly: UIAutomationTypes (in uiautomationtypes.dll)
'Declaration Public Delegate Sub AutomationEventHandler ( _ sender As Object, _ e As AutomationEventArgs _ ) 'Usage Dim instance As New AutomationEventHandler(AddressOf HandlerMethod)
/** @delegate */ public delegate void AutomationEventHandler ( Object sender, AutomationEventArgs e )
Not applicable.
Parameters
- sender
The object that raised the event.
- e
Information about the event.
Use an AutomationEventHandler delegate to specify the method that is called by a client to handle UI Automation events.
The AutomationElement represented by sender might not have any cached properties or patterns, depending on whether the application subscribed to this event while a CacheRequest was active.
The following example shows how to subscribe to and handle an event.
' Member variables. Private ElementSubscribeButton As AutomationElement Private UIAeventHandler As AutomationEventHandler ''' <summary> ''' Register an event handler for InvokedEvent on the specified element. ''' </summary> ''' <param name="elementButton">The automation element.</param> Public Sub SubscribeToInvoke(ByVal elementButton As AutomationElement) If (elementButton IsNot Nothing) Then UIAeventHandler = New AutomationEventHandler(AddressOf OnUIAutomationEvent) Automation.AddAutomationEventHandler(InvokePattern.InvokedEvent, elementButton, _ TreeScope.Element, UIAeventHandler) ElementSubscribeButton = elementButton End If End Sub 'SubscribeToInvoke ''' <summary> ''' AutomationEventHandler delegate. ''' </summary> ''' <param name="src">Object that raised the event.</param> ''' <param name="e">Event arguments.</param> Private Sub OnUIAutomationEvent(ByVal src As Object, ByVal e As AutomationEventArgs) ' Make sure the element still exists. Elements such as tooltips can disappear ' before the event is processed. Dim sourceElement As AutomationElement Try sourceElement = DirectCast(src, AutomationElement) Catch ex As ElementNotAvailableException Exit Sub End Try If e.EventId Is InvokePattern.InvokedEvent Then ' TODO Add handling code. Else End If ' TODO Handle any other events that have been subscribed to. Console.WriteLine("Event: " & e.EventId.ProgrammaticName) End Sub 'OnUIAutomationEvent Private Sub ShutdownUIA() If (UIAeventHandler IsNot Nothing) Then Automation.RemoveAutomationEventHandler(InvokePattern.InvokedEvent, ElementSubscribeButton, UIAeventHandler) End If End Sub 'ShutdownUIA
Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.Community Additions
ADD
Show: