Code:
/ DotNET / DotNET / 8.0 / untmp / WIN_WINDOWS / lh_tools_devdiv_wpf / Windows / AccessibleTech / longhorn / Automation / UIAutomationClient / System / Windows / Automation / Automation.cs / 1 / 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 : [....] Ported to WCP // 07/23/2003 : [....] 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
- UnionExpr.cs
- ClientSession.cs
- DataGridRowHeader.cs
- EmptyStringExpandableObjectConverter.cs
- ConfigurationElementCollection.cs
- WorkflowRuntimeSection.cs
- SqlFormatter.cs
- RichTextBox.cs
- DiagnosticsElement.cs
- XmlCharCheckingWriter.cs
- DataGridViewCellLinkedList.cs
- Tile.cs
- AxDesigner.cs
- ImageIndexConverter.cs
- MULTI_QI.cs
- PageSettings.cs
- Timer.cs
- WebPartZoneCollection.cs
- ExtendedProtectionPolicyTypeConverter.cs
- DefaultEventAttribute.cs
- SmtpNegotiateAuthenticationModule.cs
- CleanUpVirtualizedItemEventArgs.cs
- SaveFileDialog.cs
- FormViewCommandEventArgs.cs
- BreakSafeBase.cs
- XmlHelper.cs
- Icon.cs
- contentDescriptor.cs
- WindowsImpersonationContext.cs
- RankException.cs
- WebChannelFactory.cs
- SettingsProviderCollection.cs
- ButtonFlatAdapter.cs
- DataGridViewCellStyleChangedEventArgs.cs
- DocumentSchemaValidator.cs
- LinqDataSourceDisposeEventArgs.cs
- OneOfElement.cs
- AtlasWeb.Designer.cs
- PropVariant.cs
- SiteOfOriginPart.cs
- Int16.cs
- CacheVirtualItemsEvent.cs
- OdbcParameter.cs
- MetricEntry.cs
- DataGridViewIntLinkedList.cs
- DataSourceView.cs
- _ReceiveMessageOverlappedAsyncResult.cs
- MediaTimeline.cs
- NodeLabelEditEvent.cs
- FullTextBreakpoint.cs
- TailCallAnalyzer.cs
- WindowsContainer.cs
- Tablet.cs
- HttpDigestClientElement.cs
- ListSortDescription.cs
- VirtualDirectoryMapping.cs
- NativeObjectSecurity.cs
- Italic.cs
- Oid.cs
- CodeThrowExceptionStatement.cs
- PageParserFilter.cs
- HtmlInputFile.cs
- TreeNodeSelectionProcessor.cs
- InvalidComObjectException.cs
- HtmlEncodedRawTextWriter.cs
- Select.cs
- MatrixCamera.cs
- FactoryMaker.cs
- MenuEventArgs.cs
- Point3DIndependentAnimationStorage.cs
- ISAPIRuntime.cs
- TdsParserStateObject.cs
- GridItemCollection.cs
- Int16Converter.cs
- CounterSetInstance.cs
- PackWebResponse.cs
- BitHelper.cs
- HtmlEncodedRawTextWriter.cs
- SignedPkcs7.cs
- MemberHolder.cs
- Debug.cs
- CaretElement.cs
- PostBackOptions.cs
- CookieHandler.cs
- MultiBindingExpression.cs
- DummyDataSource.cs
- FixedSOMLineRanges.cs
- DesignOnlyAttribute.cs
- BitmapEffectGeneralTransform.cs
- DuplexClientBase.cs
- Page.cs
- MemberRelationshipService.cs
- XmlNamespaceMapping.cs
- PropertyMapper.cs
- PreApplicationStartMethodAttribute.cs
- CodeConstructor.cs
- MetaModel.cs
- ThousandthOfEmRealPoints.cs
- SerializerDescriptor.cs
- OrthographicCamera.cs