Code:
/ 4.0 / 4.0 / DEVDIV_TFS / Dev10 / Releases / RTMRel / wpf / src / UIAutomation / UIAutomationClient / System / Windows / Automation / Automation.cs / 1305600 / Automation.cs
//----------------------------------------------------------------------------
//
//
// Copyright (C) Microsoft Corporation. All rights reserved.
//
//
//
// Description: Facade class that groups together the main functionality that clients need to get started.
//
// History:
// 06/02/2003 : BrendanM Ported to WCP
// 07/23/2003 : MKarr removed start and includeStart from FindRawElement and FindLogicalElement
//
//---------------------------------------------------------------------------
// PRESHARP: In order to avoid generating warnings about unkown message numbers and unknown pragmas.
#pragma warning disable 1634, 1691
using System.Windows.Automation;
using System.Windows.Automation.Provider;
using System;
using System.Runtime.InteropServices;
using System.Security.Permissions;
using System.Reflection;
using System.Diagnostics;
using MS.Internal.Automation;
using MS.Win32;
namespace System.Windows.Automation
{
///
/// Class containing client Automation methods that are not specific to a particular element
///
#if (INTERNAL_COMPILE)
internal static class Automation
#else
public static class Automation
#endif
{
//-----------------------------------------------------
//
// Public Constants / Readonly Fields
//
//-----------------------------------------------------
#region Public Constants and Readonly Fields
/// Condition that describes the Raw view of the UIAutomation tree
public static readonly Condition RawViewCondition = Condition.TrueCondition;
/// Condition that describes the Control view of the UIAutomation tree
public static readonly Condition ControlViewCondition = new NotCondition(
new PropertyCondition( AutomationElement.IsControlElementProperty, false) );
//
/// Condition that describes the Content view of the UIAutomation tree
public static readonly Condition ContentViewCondition = new NotCondition( new OrCondition(
new PropertyCondition( AutomationElement.IsControlElementProperty, false),
new PropertyCondition( AutomationElement.IsContentElementProperty, false)));
#endregion Public Constants and Readonly Fields
//------------------------------------------------------
//
// Public Methods
//
//-----------------------------------------------------
#region Public Methods
#region Element Comparisons
///
/// Compares two elements, returning true if both refer to the same piece of UI.
///
/// element to compare
/// element to compare
/// true if el1 and el2 refer to the same underlying UI
/// Both el1 and el1 must be non-null
///
///
/// This API does not work inside the secure execution environment.
///
public static bool Compare(AutomationElement el1, AutomationElement el2)
{
return Misc.Compare(el1, el2);
}
///
/// Compares two integer arrays, returning true if they have the same contents
///
/// integer array to compare
/// integer array to compare
/// true if runtimeId1 and runtimeId2 refer to the same underlying UI
/// Both runtimeId1 and runtimeId2 must be non-null. Can be
/// used to compare RuntimeIds from elements.
///
///
/// This API does not work inside the secure execution environment.
///
public static bool Compare(int[] runtimeId1, int[] runtimeId2)
{
return Misc.Compare(runtimeId1, runtimeId2);
}
#endregion Element Comparisons
#region Misc: Find, Property Names
///
/// Get string describing specified property idenfier
///
/// property to get string for
/// Sting containing human-readable name of specified property
public static string PropertyName( AutomationProperty property )
{
Misc.ValidateArgumentNonNull(property, "property");
// Suppress PRESHARP Parameter to this public method must be validated; element is checked above.
#pragma warning suppress 56506
string full = property.ProgrammaticName.Split('.')[1]; // remove portion before the ".", leaving just "NameProperty" or similar
return full.Substring(0, full.Length - 8); // Slice away "Property" suffix
}
///
/// Get string describing specified pattern idenfier
///
/// pattern to get string for
/// Sting containing human-readable name of specified pattern
public static string PatternName( AutomationPattern pattern )
{
Misc.ValidateArgumentNonNull(pattern, "pattern");
// Suppress PRESHARP Parameter to this public method must be validated; element is checked above.
#pragma warning suppress 56506
string full = pattern.ProgrammaticName;
return full.Substring(0, full.Length - 26); // Slice away "InvokePatternIdentifiers.Pattern" to get just "Invoke"
}
#endregion Misc: Find, Property Names
#region Events
///
/// Called by a client to add a listener for pattern or custom events.
///
/// A control pattern or custom event identifier.
/// Element on which to listen for control pattern or custom events.
/// Specifies whether to listen to property changes events on the specified element, and/or its ancestors and children.
/// Delegate to call when the specified event occurs.
///
///
/// This API does not work inside the secure execution environment.
///
public static void AddAutomationEventHandler(
AutomationEvent eventId,
AutomationElement element,
TreeScope scope,
AutomationEventHandler eventHandler
)
{
Misc.ValidateArgumentNonNull(element, "element" );
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler" );
Misc.ValidateArgument( eventId != AutomationElement.AutomationFocusChangedEvent, SRID.EventIdMustNotBeAutomationFocusChanged );
Misc.ValidateArgument( eventId != AutomationElement.StructureChangedEvent,SRID.EventIdMustNotBeStructureChanged );
Misc.ValidateArgument( eventId != AutomationElement.AutomationPropertyChangedEvent, SRID.EventIdMustNotBeAutomationPropertyChanged );
if (eventId == WindowPattern.WindowClosedEvent)
{
// Once a window closes and the hwnd is destroyed we won't be able to determine where it was in the
// Automation tree; therefore only support WindowClosed events for all windows (eg. src==root and scope
// is descendants) or a specific WindowPattern element (src==root of a Window and scope is the element).
// Also handle odd combinations (eg. src==specific element and scope is subtree|ancestors).
bool paramsValidated = false;
if ( Misc.Compare( element, AutomationElement.RootElement ) )
{
// For root element need to have Descendants scope set (Note: Subtree includes Descendants)
if ( ( scope & TreeScope.Descendants ) == TreeScope.Descendants )
{
paramsValidated = true;
}
}
else
{
// otherwise non-root elements must have the entire tree (Anscestors, Element and Descendants)...
if ( ( scope & ( TreeScope.Ancestors | TreeScope.Element | TreeScope.Descendants ) ) == ( TreeScope.Ancestors | TreeScope.Element | TreeScope.Descendants ) )
{
paramsValidated = true;
}
else if ( ( scope & TreeScope.Element ) == TreeScope.Element )
{
// ...OR Element where the element implements WindowPattern
// PRESHARP will flag this as warning 56506/6506:Parameter 'element' to this public method must be validated: A null-dereference can occur here.
// False positive, element is checked, see above
#pragma warning suppress 6506
object val = element.GetCurrentPropertyValue(AutomationElement.NativeWindowHandleProperty);
if ( val != null && val is int && (int)val != 0 )
{
if ( HwndProxyElementProvider.IsWindowPatternWindow( NativeMethods.HWND.Cast( new IntPtr( (int)val ) ) ) )
{
paramsValidated = true;
}
}
}
}
if ( !paramsValidated )
{
throw new ArgumentException( SR.Get( SRID.ParamsNotApplicableToWindowClosedEvent ) );
}
}
// Add a client-side Handler for for this event request
EventListener l = new EventListener(eventId, scope, null, CacheRequest.CurrentUiaCacheRequest);
ClientEventManager.AddListener(element, eventHandler, l);
}
///
/// Called by a client to remove a listener for pattern or custom events.
///
/// a UIAccess or custom event identifier.
/// Element to remove listener for
/// The handler object that was passed to AddEventListener
///
///
/// This API does not work inside the secure execution environment.
///
public static void RemoveAutomationEventHandler(
AutomationEvent eventId,
AutomationElement element,
AutomationEventHandler eventHandler
)
{
Misc.ValidateArgumentNonNull(element, "element" );
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler" );
Misc.ValidateArgument( eventId != AutomationElement.AutomationFocusChangedEvent, SRID.EventIdMustNotBeAutomationFocusChanged );
Misc.ValidateArgument( eventId != AutomationElement.StructureChangedEvent, SRID.EventIdMustNotBeStructureChanged );
Misc.ValidateArgument( eventId != AutomationElement.AutomationPropertyChangedEvent, SRID.EventIdMustNotBeAutomationPropertyChanged );
//CASRemoval:AutomationPermission.Demand( AutomationPermissionFlag.Read );
// Remove the client-side listener for for this event
ClientEventManager.RemoveListener( eventId, element, eventHandler );
}
///
/// Called by a client to add a listener for property changed events.
///
/// Element on which to listen for property changed events.
/// Specifies whether to listen to property changes events on the specified element, and/or its ancestors and children.
/// Callback object to call when a specified property change occurs.
/// Params array of properties to listen for changes in.
///
///
/// This API does not work inside the secure execution environment.
///
public static void AddAutomationPropertyChangedEventHandler(
AutomationElement element, // reference element for listening to the event
TreeScope scope, // scope to listen to
AutomationPropertyChangedEventHandler eventHandler, // callback object
params AutomationProperty [] properties // listen for changes to these properties
)
{
Misc.ValidateArgumentNonNull(element, "element" );
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler" );
Misc.ValidateArgumentNonNull(properties, "properties" );
if (properties.Length == 0)
{
throw new ArgumentException( SR.Get(SRID.AtLeastOnePropertyMustBeSpecified) );
}
// Check that no properties are interpreted properties
//
foreach (AutomationProperty property in properties)
{
Misc.ValidateArgumentNonNull(property, "properties" );
}
// Add a client-side listener for for this event request
EventListener l = new EventListener(AutomationElement.AutomationPropertyChangedEvent, scope, properties, CacheRequest.CurrentUiaCacheRequest);
ClientEventManager.AddListener(element, eventHandler, l);
}
///
/// Called by a client to remove a listener for property changed events.
///
/// Element to remove listener for
/// The handler object that was passed to AutomationPropertyChangedEventHandler
///
///
/// This API does not work inside the secure execution environment.
///
public static void RemoveAutomationPropertyChangedEventHandler(
AutomationElement element, // reference element being listened to
AutomationPropertyChangedEventHandler eventHandler // callback object (used as cookie here)
)
{
Misc.ValidateArgumentNonNull(element, "element" );
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler" );
//CASRemoval:AutomationPermission.Demand( AutomationPermissionFlag.Read );
// Remove the client-side listener for for this event
ClientEventManager.RemoveListener(AutomationElement.AutomationPropertyChangedEvent, element, eventHandler);
}
///
/// Called by a client to add a listener for structure change events.
///
/// Element on which to listen for structure change events.
/// Specifies whether to listen to property changes events on the specified element, and/or its ancestors and children.
/// Delegate to call when a structure change event occurs.
///
///
/// This API does not work inside the secure execution environment.
///
public static void AddStructureChangedEventHandler(AutomationElement element, TreeScope scope, StructureChangedEventHandler eventHandler)
{
Misc.ValidateArgumentNonNull(element, "element");
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler");
// Add a client-side listener for for this event request
EventListener l = new EventListener(AutomationElement.StructureChangedEvent, scope, null, CacheRequest.CurrentUiaCacheRequest);
ClientEventManager.AddListener(element, eventHandler, l);
}
///
/// Called by a client to remove a listener for structure change events.
///
/// Element to remove listener for
/// The handler object that was passed to AddStructureChangedListener
///
///
/// This API does not work inside the secure execution environment.
///
public static void RemoveStructureChangedEventHandler(AutomationElement element, StructureChangedEventHandler eventHandler)
{
Misc.ValidateArgumentNonNull(element, "element");
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler");
//CASRemoval:AutomationPermission.Demand(AutomationPermissionFlag.Read);
// Remove the client-side listener for for this event
ClientEventManager.RemoveListener(AutomationElement.StructureChangedEvent, element, eventHandler);
}
///
/// Called by a client to add a listener for focus changed events.
///
/// Delegate to call when a focus change event occurs.
///
///
/// This API does not work inside the secure execution environment.
///
public static void AddAutomationFocusChangedEventHandler(
AutomationFocusChangedEventHandler eventHandler
)
{
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler" );
// Add a client-side listener for for this event request
EventListener l = new EventListener(AutomationElement.AutomationFocusChangedEvent,
TreeScope.Subtree | TreeScope.Ancestors,
null,
CacheRequest.CurrentUiaCacheRequest);
ClientEventManager.AddFocusListener(eventHandler, l);
}
///
/// Called by a client to remove a listener for focus changed events.
///
/// The handler object that was passed to AddAutomationFocusChangedListener
///
///
/// This API does not work inside the secure execution environment.
///
public static void RemoveAutomationFocusChangedEventHandler(
AutomationFocusChangedEventHandler eventHandler
)
{
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler" );
//CASRemoval:AutomationPermission.Demand( AutomationPermissionFlag.Read );
// Remove the client-side listener for for this event
ClientEventManager.RemoveFocusListener(eventHandler);
}
///
/// Called by a client to remove all listeners that the client has added.
///
///
///
/// This API does not work inside the secure execution environment.
///
public static void RemoveAllEventHandlers()
{
//CASRemoval:AutomationPermission.Demand( AutomationPermissionFlag.Read );
// Remove the client-side listener for for this event
ClientEventManager.RemoveAllListeners();
}
#endregion Events
#endregion Public Methods
}
}
// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
// Copyright (c) Microsoft Corporation. All rights reserved.
//----------------------------------------------------------------------------
//
//
// Copyright (C) Microsoft Corporation. All rights reserved.
//
//
//
// Description: Facade class that groups together the main functionality that clients need to get started.
//
// History:
// 06/02/2003 : BrendanM Ported to WCP
// 07/23/2003 : MKarr removed start and includeStart from FindRawElement and FindLogicalElement
//
//---------------------------------------------------------------------------
// PRESHARP: In order to avoid generating warnings about unkown message numbers and unknown pragmas.
#pragma warning disable 1634, 1691
using System.Windows.Automation;
using System.Windows.Automation.Provider;
using System;
using System.Runtime.InteropServices;
using System.Security.Permissions;
using System.Reflection;
using System.Diagnostics;
using MS.Internal.Automation;
using MS.Win32;
namespace System.Windows.Automation
{
///
/// Class containing client Automation methods that are not specific to a particular element
///
#if (INTERNAL_COMPILE)
internal static class Automation
#else
public static class Automation
#endif
{
//-----------------------------------------------------
//
// Public Constants / Readonly Fields
//
//-----------------------------------------------------
#region Public Constants and Readonly Fields
/// Condition that describes the Raw view of the UIAutomation tree
public static readonly Condition RawViewCondition = Condition.TrueCondition;
/// Condition that describes the Control view of the UIAutomation tree
public static readonly Condition ControlViewCondition = new NotCondition(
new PropertyCondition( AutomationElement.IsControlElementProperty, false) );
//
/// Condition that describes the Content view of the UIAutomation tree
public static readonly Condition ContentViewCondition = new NotCondition( new OrCondition(
new PropertyCondition( AutomationElement.IsControlElementProperty, false),
new PropertyCondition( AutomationElement.IsContentElementProperty, false)));
#endregion Public Constants and Readonly Fields
//------------------------------------------------------
//
// Public Methods
//
//-----------------------------------------------------
#region Public Methods
#region Element Comparisons
///
/// Compares two elements, returning true if both refer to the same piece of UI.
///
/// element to compare
/// element to compare
/// true if el1 and el2 refer to the same underlying UI
/// Both el1 and el1 must be non-null
///
///
/// This API does not work inside the secure execution environment.
///
public static bool Compare(AutomationElement el1, AutomationElement el2)
{
return Misc.Compare(el1, el2);
}
///
/// Compares two integer arrays, returning true if they have the same contents
///
/// integer array to compare
/// integer array to compare
/// true if runtimeId1 and runtimeId2 refer to the same underlying UI
/// Both runtimeId1 and runtimeId2 must be non-null. Can be
/// used to compare RuntimeIds from elements.
///
///
/// This API does not work inside the secure execution environment.
///
public static bool Compare(int[] runtimeId1, int[] runtimeId2)
{
return Misc.Compare(runtimeId1, runtimeId2);
}
#endregion Element Comparisons
#region Misc: Find, Property Names
///
/// Get string describing specified property idenfier
///
/// property to get string for
/// Sting containing human-readable name of specified property
public static string PropertyName( AutomationProperty property )
{
Misc.ValidateArgumentNonNull(property, "property");
// Suppress PRESHARP Parameter to this public method must be validated; element is checked above.
#pragma warning suppress 56506
string full = property.ProgrammaticName.Split('.')[1]; // remove portion before the ".", leaving just "NameProperty" or similar
return full.Substring(0, full.Length - 8); // Slice away "Property" suffix
}
///
/// Get string describing specified pattern idenfier
///
/// pattern to get string for
/// Sting containing human-readable name of specified pattern
public static string PatternName( AutomationPattern pattern )
{
Misc.ValidateArgumentNonNull(pattern, "pattern");
// Suppress PRESHARP Parameter to this public method must be validated; element is checked above.
#pragma warning suppress 56506
string full = pattern.ProgrammaticName;
return full.Substring(0, full.Length - 26); // Slice away "InvokePatternIdentifiers.Pattern" to get just "Invoke"
}
#endregion Misc: Find, Property Names
#region Events
///
/// Called by a client to add a listener for pattern or custom events.
///
/// A control pattern or custom event identifier.
/// Element on which to listen for control pattern or custom events.
/// Specifies whether to listen to property changes events on the specified element, and/or its ancestors and children.
/// Delegate to call when the specified event occurs.
///
///
/// This API does not work inside the secure execution environment.
///
public static void AddAutomationEventHandler(
AutomationEvent eventId,
AutomationElement element,
TreeScope scope,
AutomationEventHandler eventHandler
)
{
Misc.ValidateArgumentNonNull(element, "element" );
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler" );
Misc.ValidateArgument( eventId != AutomationElement.AutomationFocusChangedEvent, SRID.EventIdMustNotBeAutomationFocusChanged );
Misc.ValidateArgument( eventId != AutomationElement.StructureChangedEvent,SRID.EventIdMustNotBeStructureChanged );
Misc.ValidateArgument( eventId != AutomationElement.AutomationPropertyChangedEvent, SRID.EventIdMustNotBeAutomationPropertyChanged );
if (eventId == WindowPattern.WindowClosedEvent)
{
// Once a window closes and the hwnd is destroyed we won't be able to determine where it was in the
// Automation tree; therefore only support WindowClosed events for all windows (eg. src==root and scope
// is descendants) or a specific WindowPattern element (src==root of a Window and scope is the element).
// Also handle odd combinations (eg. src==specific element and scope is subtree|ancestors).
bool paramsValidated = false;
if ( Misc.Compare( element, AutomationElement.RootElement ) )
{
// For root element need to have Descendants scope set (Note: Subtree includes Descendants)
if ( ( scope & TreeScope.Descendants ) == TreeScope.Descendants )
{
paramsValidated = true;
}
}
else
{
// otherwise non-root elements must have the entire tree (Anscestors, Element and Descendants)...
if ( ( scope & ( TreeScope.Ancestors | TreeScope.Element | TreeScope.Descendants ) ) == ( TreeScope.Ancestors | TreeScope.Element | TreeScope.Descendants ) )
{
paramsValidated = true;
}
else if ( ( scope & TreeScope.Element ) == TreeScope.Element )
{
// ...OR Element where the element implements WindowPattern
// PRESHARP will flag this as warning 56506/6506:Parameter 'element' to this public method must be validated: A null-dereference can occur here.
// False positive, element is checked, see above
#pragma warning suppress 6506
object val = element.GetCurrentPropertyValue(AutomationElement.NativeWindowHandleProperty);
if ( val != null && val is int && (int)val != 0 )
{
if ( HwndProxyElementProvider.IsWindowPatternWindow( NativeMethods.HWND.Cast( new IntPtr( (int)val ) ) ) )
{
paramsValidated = true;
}
}
}
}
if ( !paramsValidated )
{
throw new ArgumentException( SR.Get( SRID.ParamsNotApplicableToWindowClosedEvent ) );
}
}
// Add a client-side Handler for for this event request
EventListener l = new EventListener(eventId, scope, null, CacheRequest.CurrentUiaCacheRequest);
ClientEventManager.AddListener(element, eventHandler, l);
}
///
/// Called by a client to remove a listener for pattern or custom events.
///
/// a UIAccess or custom event identifier.
/// Element to remove listener for
/// The handler object that was passed to AddEventListener
///
///
/// This API does not work inside the secure execution environment.
///
public static void RemoveAutomationEventHandler(
AutomationEvent eventId,
AutomationElement element,
AutomationEventHandler eventHandler
)
{
Misc.ValidateArgumentNonNull(element, "element" );
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler" );
Misc.ValidateArgument( eventId != AutomationElement.AutomationFocusChangedEvent, SRID.EventIdMustNotBeAutomationFocusChanged );
Misc.ValidateArgument( eventId != AutomationElement.StructureChangedEvent, SRID.EventIdMustNotBeStructureChanged );
Misc.ValidateArgument( eventId != AutomationElement.AutomationPropertyChangedEvent, SRID.EventIdMustNotBeAutomationPropertyChanged );
//CASRemoval:AutomationPermission.Demand( AutomationPermissionFlag.Read );
// Remove the client-side listener for for this event
ClientEventManager.RemoveListener( eventId, element, eventHandler );
}
///
/// Called by a client to add a listener for property changed events.
///
/// Element on which to listen for property changed events.
/// Specifies whether to listen to property changes events on the specified element, and/or its ancestors and children.
/// Callback object to call when a specified property change occurs.
/// Params array of properties to listen for changes in.
///
///
/// This API does not work inside the secure execution environment.
///
public static void AddAutomationPropertyChangedEventHandler(
AutomationElement element, // reference element for listening to the event
TreeScope scope, // scope to listen to
AutomationPropertyChangedEventHandler eventHandler, // callback object
params AutomationProperty [] properties // listen for changes to these properties
)
{
Misc.ValidateArgumentNonNull(element, "element" );
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler" );
Misc.ValidateArgumentNonNull(properties, "properties" );
if (properties.Length == 0)
{
throw new ArgumentException( SR.Get(SRID.AtLeastOnePropertyMustBeSpecified) );
}
// Check that no properties are interpreted properties
//
foreach (AutomationProperty property in properties)
{
Misc.ValidateArgumentNonNull(property, "properties" );
}
// Add a client-side listener for for this event request
EventListener l = new EventListener(AutomationElement.AutomationPropertyChangedEvent, scope, properties, CacheRequest.CurrentUiaCacheRequest);
ClientEventManager.AddListener(element, eventHandler, l);
}
///
/// Called by a client to remove a listener for property changed events.
///
/// Element to remove listener for
/// The handler object that was passed to AutomationPropertyChangedEventHandler
///
///
/// This API does not work inside the secure execution environment.
///
public static void RemoveAutomationPropertyChangedEventHandler(
AutomationElement element, // reference element being listened to
AutomationPropertyChangedEventHandler eventHandler // callback object (used as cookie here)
)
{
Misc.ValidateArgumentNonNull(element, "element" );
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler" );
//CASRemoval:AutomationPermission.Demand( AutomationPermissionFlag.Read );
// Remove the client-side listener for for this event
ClientEventManager.RemoveListener(AutomationElement.AutomationPropertyChangedEvent, element, eventHandler);
}
///
/// Called by a client to add a listener for structure change events.
///
/// Element on which to listen for structure change events.
/// Specifies whether to listen to property changes events on the specified element, and/or its ancestors and children.
/// Delegate to call when a structure change event occurs.
///
///
/// This API does not work inside the secure execution environment.
///
public static void AddStructureChangedEventHandler(AutomationElement element, TreeScope scope, StructureChangedEventHandler eventHandler)
{
Misc.ValidateArgumentNonNull(element, "element");
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler");
// Add a client-side listener for for this event request
EventListener l = new EventListener(AutomationElement.StructureChangedEvent, scope, null, CacheRequest.CurrentUiaCacheRequest);
ClientEventManager.AddListener(element, eventHandler, l);
}
///
/// Called by a client to remove a listener for structure change events.
///
/// Element to remove listener for
/// The handler object that was passed to AddStructureChangedListener
///
///
/// This API does not work inside the secure execution environment.
///
public static void RemoveStructureChangedEventHandler(AutomationElement element, StructureChangedEventHandler eventHandler)
{
Misc.ValidateArgumentNonNull(element, "element");
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler");
//CASRemoval:AutomationPermission.Demand(AutomationPermissionFlag.Read);
// Remove the client-side listener for for this event
ClientEventManager.RemoveListener(AutomationElement.StructureChangedEvent, element, eventHandler);
}
///
/// Called by a client to add a listener for focus changed events.
///
/// Delegate to call when a focus change event occurs.
///
///
/// This API does not work inside the secure execution environment.
///
public static void AddAutomationFocusChangedEventHandler(
AutomationFocusChangedEventHandler eventHandler
)
{
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler" );
// Add a client-side listener for for this event request
EventListener l = new EventListener(AutomationElement.AutomationFocusChangedEvent,
TreeScope.Subtree | TreeScope.Ancestors,
null,
CacheRequest.CurrentUiaCacheRequest);
ClientEventManager.AddFocusListener(eventHandler, l);
}
///
/// Called by a client to remove a listener for focus changed events.
///
/// The handler object that was passed to AddAutomationFocusChangedListener
///
///
/// This API does not work inside the secure execution environment.
///
public static void RemoveAutomationFocusChangedEventHandler(
AutomationFocusChangedEventHandler eventHandler
)
{
Misc.ValidateArgumentNonNull(eventHandler, "eventHandler" );
//CASRemoval:AutomationPermission.Demand( AutomationPermissionFlag.Read );
// Remove the client-side listener for for this event
ClientEventManager.RemoveFocusListener(eventHandler);
}
///
/// Called by a client to remove all listeners that the client has added.
///
///
///
/// This API does not work inside the secure execution environment.
///
public static void RemoveAllEventHandlers()
{
//CASRemoval:AutomationPermission.Demand( AutomationPermissionFlag.Read );
// Remove the client-side listener for for this event
ClientEventManager.RemoveAllListeners();
}
#endregion Events
#endregion Public Methods
}
}
// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
// Copyright (c) Microsoft Corporation. All rights reserved.
Link Menu
This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- XPathNavigatorKeyComparer.cs
- RoutedEventValueSerializer.cs
- OdbcConnectionPoolProviderInfo.cs
- DesignTimeSiteMapProvider.cs
- FacetEnabledSchemaElement.cs
- ExtendedPropertyDescriptor.cs
- TreeNodeStyle.cs
- MaskedTextProvider.cs
- SmiRequestExecutor.cs
- BatchStream.cs
- RsaSecurityTokenAuthenticator.cs
- WaitHandle.cs
- __ComObject.cs
- TriggerAction.cs
- PlainXmlSerializer.cs
- ModifyActivitiesPropertyDescriptor.cs
- TextDecorationUnitValidation.cs
- Parallel.cs
- IntermediatePolicyValidator.cs
- TextHintingModeValidation.cs
- BindStream.cs
- CapabilitiesSection.cs
- HttpHandlersInstallComponent.cs
- ZipArchive.cs
- AutomationElementCollection.cs
- Dynamic.cs
- XPathSelfQuery.cs
- CustomSignedXml.cs
- ValidationErrorCollection.cs
- StyleTypedPropertyAttribute.cs
- ExtensionSimplifierMarkupObject.cs
- BinaryCommonClasses.cs
- DocumentOrderQuery.cs
- DynamicRendererThreadManager.cs
- ClassGenerator.cs
- HttpFileCollection.cs
- DiagnosticEventProvider.cs
- UserCancellationException.cs
- ParameterCollection.cs
- HtmlInputButton.cs
- Authorization.cs
- PaginationProgressEventArgs.cs
- PageHandlerFactory.cs
- StylusDownEventArgs.cs
- TemplatePagerField.cs
- LoginView.cs
- FragmentQueryKB.cs
- TypedTableBaseExtensions.cs
- CustomLineCap.cs
- RequestCacheManager.cs
- DependencyPropertyKey.cs
- AppSettingsSection.cs
- IdentityValidationException.cs
- CreateUserWizardStep.cs
- PixelFormats.cs
- WebPartConnectionsConfigureVerb.cs
- WriteTimeStream.cs
- TextRangeSerialization.cs
- CompilerTypeWithParams.cs
- CodeSubDirectoriesCollection.cs
- SubpageParagraph.cs
- XamlPointCollectionSerializer.cs
- SqlConnectionHelper.cs
- NamespaceCollection.cs
- SqlReferenceCollection.cs
- SecurityState.cs
- UnlockInstanceAsyncResult.cs
- TextRange.cs
- ObjectItemCachedAssemblyLoader.cs
- CharAnimationBase.cs
- MembershipPasswordException.cs
- IgnoreSection.cs
- XmlWriterDelegator.cs
- KeyTime.cs
- DbExpressionBuilder.cs
- TransportDefaults.cs
- HtmlInputFile.cs
- TrustLevelCollection.cs
- IssuedTokenServiceElement.cs
- AmbientProperties.cs
- ReadOnlyPermissionSet.cs
- HMACMD5.cs
- SvcMapFile.cs
- ConfigXmlDocument.cs
- EmbeddedObject.cs
- PermissionListSet.cs
- DictionaryBase.cs
- webclient.cs
- HashSet.cs
- HMACSHA512.cs
- PageThemeCodeDomTreeGenerator.cs
- _SSPISessionCache.cs
- IPCCacheManager.cs
- DetailsViewModeEventArgs.cs
- KeyInterop.cs
- XmlSerializationWriter.cs
- ErrorTolerantObjectWriter.cs
- WebPartConnectionsCancelVerb.cs
- PersistenceProviderDirectory.cs
- EventLogPermissionHolder.cs