Peer navigationAfter locating an au

Peer navigation

After locating an automation peer, a UI Automation client can navigate the peer structure of an app by calling the peer object's GetChildren and GetParent methods. Navigation among UI elements within a control is supported by the peer's implementation of the GetChildrenCore method. The UI Automation system calls this method to build up a tree of subelements contained within a control; for example, list items in a list box. The default GetChildrenCore method in FrameworkElementAutomationPeer traverses the visual tree of elements to build the tree of automation peers. Custom controls can override this method to expose a different representation of child elements to automation clients, returning the automation peers of elements that convey information or allow user interaction.


Native automation support for text patterns

Some of the default UWP app automation peers provide control pattern support for the text pattern (PatternInterface.Text). But they provide this support through native methods, and the peers involved won't note the ITextProvider interface in the (managed) inheritance. Still, if a managed or non-managed UI Automation client queries the peer for patterns, it will report support for the text pattern, and provide behavior for parts of the pattern when client APIs are called.

If you intend to derive from one of the UWP app text controls and also create a custom peer that derives from one of the text-related peers, check the Remarks sections for the peer to learn more about any native-level support for patterns. You can access the native base behavior in your custom peer if you call the base implementation from your managed provider interface implementations, but it's difficult to modify what the base implementation does because the native interfaces on both the peer and its owner control aren't exposed. Generally you should either use the base implementations as-is (call base only) or completely replace the functionality with your own managed code and don't call the base implementation. The latter is an advanced scenario, you'll need good familiarity with the text services framework being used by your control in order to support the accessibility requirements when using that framework.


AutomationProperties.AccessibilityView

In addition to providing a custom peer, you can also adjust the tree view representation for any control instance, by setting AutomationProperties.AccessibilityView in XAML. This isn't implemented as part of a peer class, but we'll mention it here because it's germane to overall accessibility support either for custom controls or for templates you customize.

The main scenario for using AutomationProperties.AccessibilityView is to deliberately omit certain controls in a template from the UI Automation views, because they don't meaningfully contribute to the accessibility view of the entire control. To prevent this, set AutomationProperties.AccessibilityView to "Raw". For more info, see AutomationProperties.AccessibilityView.


Throwing exceptions from automation peers

The APIs that you are implementing for your automation peer support are permitted to throw exceptions. It's expected any UI Automation clients that are listening are robust enough to continue on after most exceptions are thrown. In all likelihood that listener is looking at an all-up automation tree that includes apps other than your own, and it's an unacceptable client design to bring down the entire client just because one area of the tree threw a peer-based exception when the client called its APIs.

For parameters that are passed in to your peer, it's acceptable to validate the input, and for example throw ArgumentNullException if it was passed null and that's not a valid value for your implementation. However, if there are subsequent operations performed by your peer, remember that the peer's interactions with the hosting control have something of an asynchronous character to them. Anything a peer does won't necessarily block the UI thread in the control (and it probably shouldn't). So you could have situations where an object was available or had certain properties when the peer was created or when an automation peer method was first called, but in the meantime the control state has changed. For these cases, there are two dedicated exceptions that a provider can throw:

Throw ElementNotAvailableException if you're unable to access either the peer's owner or a related peer element based on the original info your API was passed. For example, you might have a peer that's trying to run its methods but the owner has since been removed from the UI, such as a modal dialog that's been closed. For a non-.NET client, this maps to UIA_E_ELEMENTNOTAVAILABLE.
Throw ElementNotEnabledException if there still is an owner, but that owner is in a mode such as IsEnabled=false that's blocking some of the specific programmatic changes that your peer is trying to accomplish. For a non-.NET client, this map

ผลลัพธ์ (ไทย) 1:

นำทางเพียร์หลังจากหาเพียร์อัตโนมัติ UI Automation ไคลเอนต์สามารถไปโครงสร้างเพียร์แอ โดยการเรียกวิธีของวัตถุ GetChildren และ GetParent เพียร์ นำทางระหว่างองค์ประกอบ UI ภายในตัวควบคุมได้รับการสนับสนุนจากการทำงานของเพียร์ของวิธี GetChildrenCore ระบบ UI Automation เรียกวิธีการนี้จะสร้างต้นไม้ขององค์ประกอบย่อยที่อยู่ภายในตัวควบคุม เช่น เลือกรายการในกล่องรายการ วิธี GetChildrenCore การเริ่มต้นใน FrameworkElementAutomationPeer ดใด ๆ ต้นไม้ภาพขององค์ประกอบในการสร้างต้นไม้ของเพื่อนอัตโนมัติ คอนโทรลแบบกำหนดเองสามารถแทนวิธีการนี้เพื่อให้การแสดงที่แตกต่างกันขององค์ประกอบลูกไปยังไคลเอนต์ทำงานอัตโนมัติ กลับเพื่อนทำงานอัตโนมัติขององค์ประกอบที่ถ่ายทอดข้อมูล หรืออนุญาตให้ผู้ใช้สนับสนุนท้องถิ่นทำงานอัตโนมัติสำหรับรูปแบบข้อความของเพื่อนทำงานอัตโนมัติของ app ด้วยครับเริ่มต้นสามารถให้การสนับสนุนรูปแบบควบคุมสำหรับรูปแบบข้อความ (PatternInterface.Text) แต่จะให้การสนับสนุนนี้ผ่านวิธีการดั้งเดิม และเพื่อนที่เกี่ยวข้องจะไม่ทราบติดต่อ ITextProvider ในการสืบทอด (จัดการ) ยังคง ถ้ามีการจัดการ หรือ จัดการไม่ใช่ UI Automation ไคลเอนต์แบบสอบถามเพียร์ลาย จะรายงานการสนับสนุนสำหรับรูปแบบข้อความ และมีลักษณะการทำงานสำหรับส่วนของรูปแบบเมื่อไคลเอ็นต์เรียก APIsถ้าคุณต้องการจากหนึ่งในตัวควบคุมข้อความ app ด้วยครับ และยัง สร้างแบบเพียร์กำหนดเองที่ได้จากเพื่อนเป็นข้อความอย่างใดอย่างหนึ่ง ตรวจสอบในส่วนหมายเหตุสำหรับเพียร์เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับการสนับสนุนระดับพื้นเมืองลาย คุณสามารถเข้าถึงลักษณะการทำงานพื้นฐานดั้งเดิมในเพียร์กำหนดเองของคุณหากคุณเรียกใช้งานฐานผู้ให้บริการจัดการใช้งานอินเทอร์เฟซ แต่ยากที่จะปรับเปลี่ยนการใช้งานพื้นฐานอะไรเนื่องจากอินเทอร์เฟซภาษาบนเพียร์และการควบคุมเจ้าไม่ได้สัมผัส โดยทั่วไปคุณควรใช้การใช้งานเป็นฐาน-จะเรียกฐานเท่านั้น) หรือทั้งหมดแทนการทำงานของคุณเองการจัดการรหัส และไม่เรียกการใช้งานพื้นฐาน หลังคือ สถานการณ์ขั้นสูง คุณจะต้องการส่งบริการข้อความถูกใช้ โดยตัวควบคุมของคุณเพื่อรองรับความต้องการการเข้าถึงเมื่อใช้ framework ที่คุ้นเคยดีAutomationProperties.AccessibilityViewนอกเหนือจากเพียร์กำหนดเอง คุณสามารถปรับการแสดงมุมมองต้นไม้สำหรับอินสแตนซ์ใด ๆ ของตัวควบคุม ตั้งค่า AutomationProperties.AccessibilityView ใน XAML นี้ไม่ได้นำมาใช้เป็นส่วนหนึ่งของแบบเพียร์ แต่เราจะพูดถึงมันนี่ เพราะมันเป็น germane โดยรวมการสนับสนุน สำหรับตัวควบคุมแบบกำหนดเอง หรือ สำหรับแม่แบบที่คุณกำหนดเองถึงหลักการใช้ AutomationProperties.AccessibilityView เป็นการ จงใจละเว้นบางตัวควบคุมในแม่แบบจากมุมมองที่ UI Automation เนื่องจากพวกเขาไม่มีได้นำมุมมองการเข้าถึงของตัวควบคุมทั้งหมด เพื่อป้องกันการ ตั้ง AutomationProperties.AccessibilityView การ "วัตถุดิบ" สำหรับข้อมูลเพิ่มเติม ดู AutomationProperties.AccessibilityViewข้อยกเว้นการขว้างปาจากระบบอัตโนมัติApi ที่คุณใช้สำหรับการทำงานอัตโนมัติสนับสนุนเพียร์ทิ้งยกเว้นได้ คาดว่า ไคลเอนต์ UI Automation ที่ฟังจะทนทานต่อเนื่องไปหลังจากข้อยกเว้นส่วนใหญ่จะถูกออก ในทุกโอกาส ที่ฟังที่ดูต้นไม้อัตโนมัติขึ้นทั้งหมดที่มีแอปพลิเคชันอื่นที่ไม่ใช่ของคุณเอง และมันเป็นแบบไคลเอ็นต์ไม่สามารถยอมรับการนำลงไคลเอ็นต์ทั้งหมดเนื่องจากพื้นที่หนึ่งของต้นไม้โยนแบบเพียร์ข้อยกเว้นเมื่อไคลเอ็นต์เรียก APIs ของสำหรับพารามิเตอร์ที่ผ่านในเพียร์ของคุณ การตรวจสอบการป้อนข้อมูล และโยนเข้าเมลล์ไม่ได้เช่น ถ้าถูกส่งผ่านเป็น null และที่ไม่ใช่ค่าที่ถูกต้องสำหรับการนำไปใช้ก่อนได้ อย่างไรก็ตาม ถ้ามีการ ดำเนินการ โดยคุณเพียร์ จำได้ว่า เพียร์โต้ตอบกับตัวควบคุมโฮสต์มีอักขระแบบอะซิงโครนัสให้บางสิ่งบางอย่าง อะไรแบบเพียร์ไม่จำเป็นจะไม่บล็อกเธรด UI ในการควบคุม (และมันอาจจะไม่ควร) ดังนั้น คุณอาจมีกรณีที่วัตถุมีอยู่ หรือมีคุณสมบัติบางอย่าง เมื่อสร้างเพียร์ หรือ เมื่อก่อนเรียกวิธีการเพียร์อัตโนมัติ แต่ในระหว่างนี้ มีการเปลี่ยนแปลงสถานะตัวควบคุม ในกรณีเหล่านี้ มีข้อยกเว้นเฉพาะสองที่สามารถโยนผู้ให้บริการ:ทิ้ง ElementNotAvailableException ถ้าคุณไม่สามารถเข้าถึงเจ้าของเพียร์หรือองค์ประกอบเกี่ยวข้องเพียร์ที่อิงข้อมูลเดิมผ่าน API ของคุณ เช่น คุณอาจมีเพียร์ที่กำลังพยายามเรียกใช้วิธีการ แต่เจ้าตั้งแต่ถูกเอาออกจาก UI เช่นกล่องโต้ตอบโมดอลถูกปิด สำหรับไคลเอนต์สุทธิ นี้แมปไปยัง UIA_E_ELEMENTNOTAVAILABLEทิ้ง ElementNotEnabledException ถ้ายังมีเจ้าของ แต่เจ้าของที่อยู่ในโหมดเช่นลับ =เท็จที่บล็อกการเปลี่ยนแปลงโดยทางโปรแกรมเฉพาะที่เพียร์ของคุณพยายามที่จะทำ สำหรับไคลเอนต์สุทธิ แผนที่นี้

ผลลัพธ์ (ไทย) 2:

นำทาง Peer หลังจากหาที่เพียร์อัตโนมัติลูกค้า UI อัตโนมัติสามารถนำทางโครงสร้างเพียร์ของแอปโดยการเรียกวัตถุของขุนนางและ GetChildren GetParent วิธี นำร่องในหมู่องค์ประกอบ UI อยู่ในการควบคุมได้รับการสนับสนุนโดยการดำเนินงานของขุนนางของวิธีการ GetChildrenCore ระบบการทำงานอัตโนมัติ UI เรียกวิธีการนี้จะสร้างขึ้นต้นไม้ขององค์ประกอบย่อยที่มีอยู่ภายในการควบคุมนั้น ตัวอย่างเช่นรายการในกล่องรายการ วิธีการเริ่มต้นใน GetChildrenCore FrameworkElementAutomationPeer ลัดเลาะภาพต้นไม้ขององค์ประกอบในการสร้างต้นไม้ของคนรอบข้างอัตโนมัติ ควบคุมที่กำหนดเองสามารถแทนที่วิธีการนี้จะเปิดเผยการแสดงที่แตกต่างกันขององค์ประกอบของเด็กให้กับลูกค้าอัตโนมัติกลับทำเนียบระบบอัตโนมัติขององค์ประกอบที่นำข้อมูลหรืออนุญาตให้ผู้ใช้โต้ตอบ. อัตโนมัติสนับสนุนพื้นเมืองสำหรับรูปแบบข้อความบางส่วนของเพื่อนร่วมงานแอปเริ่มต้น UWP อัตโนมัติให้การสนับสนุนรูปแบบการควบคุม สำหรับรูปแบบข้อความ (PatternInterface.Text) แต่พวกเขาให้การสนับสนุนนี้ผ่านวิธีพื้นเมืองและเพื่อนที่เกี่ยวข้องจะไม่ทราบอินเตอร์เฟซ ITextProvider ใน (จัดการ) มรดก ยังถ้ามีการจัดการหรือลูกค้าที่ไม่ได้รับการจัดการ UI อัตโนมัติ queries เพียร์สำหรับรูปแบบก็จะรายงานการสนับสนุนสำหรับรูปแบบข้อความและให้พฤติกรรมสำหรับชิ้นส่วนของรูปแบบเมื่อ APIs ลูกค้าจะเรียกว่า. ถ้าคุณตั้งใจที่จะได้รับจากหนึ่งใน การควบคุมแอปพลิเคข้อความ UWP และยังสร้างเพียร์ที่กำหนดเองที่มาจากหนึ่งในเพื่อนข้อความที่เกี่ยวข้องกับการตรวจสอบข้อสังเกตส่วนสำหรับเพียร์เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับการสนับสนุนระดับพื้นเมืองสำหรับรูปแบบ คุณสามารถเข้าถึงพฤติกรรมฐานพื้นเมืองในเพียร์กำหนดเองของคุณถ้าคุณโทรดำเนินการฐานจากการใช้งานอินเตอร์เฟซผู้ให้บริการการจัดการของคุณ แต่มันเป็นเรื่องยากที่จะปรับเปลี่ยนสิ่งที่ดำเนินการฐานไม่เพราะการเชื่อมต่อพื้นเมืองทั้งเพียร์และการควบคุมเจ้าของไม่ได้สัมผัส . โดยทั่วไปคุณก็ควรจะใช้การใช้งานฐานตามที่เป็นฐาน (โทรเท่านั้น) หรือแทนที่การทำงานที่มีการจัดการรหัสของคุณเองและไม่ได้เรียกฐานการดำเนินงาน หลังเป็นสถานการณ์ขั้นสูงคุณจะต้องคุ้นเคยดีกับกรอบการบริการข้อความที่ถูกใช้โดยการควบคุมของคุณในการสั่งซื้อเพื่อรองรับความต้องการการเข้าถึงเมื่อใช้กรอบที่. AutomationProperties.AccessibilityView นอกจากการให้เพียร์ที่กำหนดเองคุณยังสามารถปรับ การแสดงมุมมองแบบต้นไม้เช่นการควบคุมใด ๆ โดยการตั้งค่า AutomationProperties.AccessibilityView ใน XAML นี้ไม่ได้ถูกนำมาใช้เป็นส่วนหนึ่งของชั้นเพียร์ แต่เราจะพูดถึงมันที่นี่เพราะมันใกล้ชิดเพื่อสนับสนุนการเข้าถึงโดยรวมทั้งการควบคุมที่กำหนดเองหรือสำหรับแม่แบบคุณสามารถปรับแต่ง. สถานการณ์หลักสำหรับการใช้ AutomationProperties.AccessibilityView คือการจงใจละเว้นการควบคุมบางอย่าง ในแม่แบบจากมุมมอง UI อัตโนมัติเพราะพวกเขาไม่ได้มีความหมายนำไปสู่การเข้าถึงมุมมองของการควบคุมทั้งหมด เพื่อป้องกันการนี้ตั้ง AutomationProperties.AccessibilityView ที่ "ดิบ" สำหรับข้อมูลเพิ่มเติมโปรดดูที่ AutomationProperties.AccessibilityView. โยนข้อยกเว้นจากระบบอัตโนมัติทำเนียบAPIs ที่คุณมีการดำเนินการสำหรับการสนับสนุนระบบอัตโนมัติเพียร์ของคุณจะได้รับอนุญาตที่จะโยนข้อยกเว้น เป็นที่คาดหวังใด ๆ ลูกค้า UI ทำงานอัตโนมัติที่กำลังฟังเพลงที่มีประสิทธิภาพมากพอที่จะดำเนินการต่อไปหลังจากที่ยกเว้นส่วนใหญ่จะโยน ในทุกโอกาสที่ผู้ฟังที่กำลังมองหาต้นไม้อัตโนมัติทั้งหมดขึ้นที่มีปพลิเคชันอื่น ๆ กว่าของคุณเองและก็การออกแบบของลูกค้าที่ยอมรับไม่ได้ที่จะนำมาลงไคลเอ็นต์ทั้งหมดเพียงเพราะพื้นที่หนึ่งของต้นไม้โยนข้อยกเว้น peer-based เมื่อลูกค้า เรียกใช้ API ของ. สำหรับพารามิเตอร์ที่ส่งผ่านไปยังเพื่อนของคุณก็เป็นที่ยอมรับในการตรวจสอบการป้อนข้อมูลและตัวอย่างเช่นโยน ArgumentNullException ถ้ามันก็ผ่านไปโมฆะและที่ไม่ได้ค่าที่ถูกต้องสำหรับการดำเนินงานของคุณ อย่างไรก็ตามหากมีการดำเนินการภายหลังการดำเนินการโดยเพียร์ของคุณจำไว้ว่าการมีปฏิสัมพันธ์ของขุนนางที่มีการควบคุมโฮสติ้งมีบางสิ่งบางอย่างของตัวละครที่ไม่ตรงกันกับพวกเขา สิ่งใดไม่เพียร์จะไม่จำเป็นต้องปิดกั้นหัวข้อ UI ในการควบคุม (และมันอาจจะไม่ได้) ดังนั้นคุณอาจมีสถานการณ์ที่วัตถุที่มีอยู่หรือมีคุณสมบัติบางอย่างเมื่อเพียร์ที่ถูกสร้างขึ้นหรือเมื่อวิธีการอัตโนมัติเพียร์ถูกเรียกว่าเป็นครั้งแรก แต่ในขณะเดียวกันรัฐควบคุมที่มีการเปลี่ยนแปลง สำหรับกรณีนี้มีสองข้อยกเว้นเฉพาะที่ผู้ให้บริการสามารถโยน: โยน ElementNotAvailableException ถ้าคุณไม่สามารถเข้าถึงทั้งเจ้าของเพียร์หรือองค์ประกอบที่เกี่ยวข้องกับเพียร์ขึ้นอยู่กับข้อมูลเดิม API ของคุณก็ผ่านไปได้ ตัวอย่างเช่นคุณอาจมีเพียร์ที่พยายามที่จะใช้วิธีการของ แต่เจ้าของได้ถูกถอดออกจาก UI เช่นกิริยาโต้ตอบที่ถูกปิด สำหรับลูกค้า non-.NET นี้แมปไป UIA_E_ELEMENTNOTAVAILABLE. โยน ElementNotEnabledException ถ้ายังคงเป็นเจ้าของ แต่เจ้าของที่อยู่ในโหมดเช่น IsEnabled = false ที่บล็อกบางส่วนของการเปลี่ยนแปลงการเขียนโปรแกรมเฉพาะที่เพียร์ของคุณพยายามที่จะบรรลุ สำหรับลูกค้า non-.NET, แผนที่นี้

ผลลัพธ์ (ไทย) 3:

เพื่อนนำทางหลังจากติดตั้งอัตโนมัติ UI Automation ( ลูกค้าสามารถนำทางเพื่อน โครงสร้างของ app โดยการเรียก getchildren เพื่อนของวัตถุและวิธีการ getparent . นำร่องของ UI องค์ประกอบภายในควบคุมได้รับการสนับสนุนโดยการเป็นเพื่อนของ getchildrencore วิธี อัตโนมัติระบบ UI สายวิธีนี้จะสร้างต้นไม้ของ subelements ที่มีอยู่ภายในการควบคุม ตัวอย่างเช่นในรายการในกล่องรายการ เริ่มต้น getchildrencore วิธีใน frameworkelementautomationpeer ลัดเลาะต้นไม้ภาพขององค์ประกอบที่จะสร้างต้นไม้ของอัตโนมัติให้เพื่อน ควบคุมที่กำหนดเองสามารถแทนที่วิธีการนี้เพื่อแสดงการเป็นตัวแทนขององค์ประกอบที่แตกต่างกันเด็กให้ลูกค้าอัตโนมัติกลับอัตโนมัติเพื่อนขององค์ประกอบที่แสดงข้อมูลหรืออนุญาตให้มีการโต้ตอบผู้ใช้สนับสนุนพื้นเมืองสำหรับรูปแบบข้อความอัตโนมัติบางส่วนของการเริ่มต้น uwp app อัตโนมัติเพื่อนให้การควบคุมรูปแบบการสนับสนุนสำหรับข้อความลวดลาย ( patterninterface ข้อความ ) แต่พวกเขาให้การสนับสนุนนี้ด้วยวิธีการดั้งเดิม และเพื่อน ๆ ที่เกี่ยวข้องจะไม่ทราบ itextprovider อินเตอร์เฟซใน ( จัดการ ) มรดก แต่ถ้าไม่จัดการหรือการจัดการลูกค้า UI Automation สอบถามเพื่อนสำหรับรูปแบบ มันจะรายงานการสนับสนุนสำหรับข้อความลวดลาย และมีพฤติกรรมเป็นส่วนหนึ่งของรูปแบบ เมื่อลูกค้า APIs จะเรียกว่าถ้าคุณตั้งใจที่จะได้รับจากหนึ่งใน uwp app ข้อความการควบคุม และยัง สร้าง เอง เพื่อนที่มาจากหนึ่งในข้อความที่เกี่ยวข้องช่วยตรวจสอบหมายเหตุส่วนเพื่อนเพื่อเรียนรู้เพิ่มเติมเกี่ยวกับการสนับสนุนพื้นเมืองสำหรับรูปแบบใด ๆ . คุณสามารถเข้าถึงพฤติกรรมพื้นฐานพื้นเมืองในเพื่อนของคุณเอง ถ้าคุณเรียกใช้จากผู้ให้บริการของคุณจัดการฐานอินเตอร์เฟซการใช้งาน แต่ก็ยากที่จะแก้ไขอะไรไม่ได้เพราะฐานการอินเตอร์เฟซพื้นเมืองทั้งในกลุ่มเพื่อน และยังควบคุมเจ้าของของมันไม่เปิดเผย โดยทั่วไปแล้วคุณควรใช้ฐานการใช้งานเป็นโทรศัพท์พื้นฐานเท่านั้น ) หรือแทนที่ฟังก์ชันของคุณเองการจัดการรหัสและอย่าเรียกฐานปฏิบัติการ หลังสถานการณ์ขั้นสูงคุณจะต้องดีคุ้นเคยกับบริการข้อความกรอบถูกใช้โดยการควบคุมของคุณเพื่อสนับสนุนการเข้าถึงความต้องการเมื่อใช้กรอบautomationproperties.accessibilityviewนอกจากการให้เพื่อนที่กำหนดเอง คุณยังสามารถปรับมุมมองต้นไม้แทนการควบคุมใด ๆเช่น การ automationproperties.accessibilityview ใน XAML . นี่ไม่ใช่การเป็นส่วนหนึ่งของเพื่อนเรียน แต่เราจะพูดถึงมันเพราะมันเกี่ยวกับการสนับสนุนการเข้าถึงโดยรวมให้เอง การควบคุมหรือแม่แบบที่คุณปรับแต่งสถานการณ์หลักสำหรับการใช้ automationproperties.accessibilityview คือการจงใจละเว้นการควบคุมบางอย่างในแม่แบบจาก UI Automation มุมมองเพราะพวกเขาไม่ได้มีความหมายมีส่วนร่วมในการเข้าถึงมุมมองของการควบคุมทั้งหมด เพื่อป้องกันการ ตั้งค่า automationproperties.accessibilityview " ดิบ " สำหรับข้อมูลเพิ่มเติม ดู automationproperties.accessibilityview .โยนข้อยกเว้นจากเครื่องเพื่อนAPIs ที่คุณจะใช้สำหรับอัตโนมัติเพื่อนสนับสนุนได้รับอนุญาตให้โยนข้อยกเว้น ก็คาดหวังใด ๆที่ฟังลูกค้า UI Automation ที่แข็งแกร่งพอที่จะดำเนินการต่อหลังจากข้อยกเว้นส่วนใหญ่จะโยน ในโอกาสทั้งหมดที่ผู้ฟังจะมองทั้งหมดขึ้นอัตโนมัติต้นไม้ที่มีปพลิเคชันอื่นที่ไม่ใช่ของคุณเอง และเป็นที่ยอมรับไม่ได้ลูกค้าออกแบบทำให้ไคลเอ็นต์ทั้งหมด เพราะพื้นที่หนึ่งของต้นไม้โยนข้อยกเว้นตามเพื่อน เมื่อลูกค้าเรียกของ APIsสำหรับพารามิเตอร์ที่ส่งผ่านไปยังเพื่อนของคุณ มันได้รับการยอมรับการตรวจสอบข้อมูลและตัวอย่างโยน argumentnullexception ถ้ามันผ่านเป็นโมฆะ และนั่นไม่ใช่ค่าที่ถูกต้องสำหรับการใช้งานของคุณ อย่างไรก็ตาม หากมีการกระทำตามมาด้วยเพื่อน จำได้ว่าเพื่อนของการสื่อสารกับตัวควบคุมโฮสต์มีบางอย่างของตัวละครแบบอะซิงโครนัส กับพวกเขา เรื่องเพื่อนก็ไม่จำเป็นต้องปิดกั้น UI Thread ในการควบคุม ( และไม่ควร ) ดังนั้นคุณอาจมีสถานการณ์ที่วัตถุที่มีอยู่หรือที่มีคุณสมบัติบางอย่าง เมื่อเพื่อนถูกสร้างขึ้น หรือเมื่อมีวิธีการอัตโนมัติเพื่อนโทรมา แต่ในขณะเดียวกันรัฐควบคุม มีการเปลี่ยนแปลง สำหรับคดีนี้ มี สอง เฉพาะ ยกเว้นที่ผู้ให้บริการสามารถโยน :โยน elementnotavailableexception ถ้าคุณไม่สามารถเข้าถึงอย่างใดอย่างหนึ่งของเจ้าของหรือเพื่อนเพื่อนที่เกี่ยวข้ององค์ประกอบตามข้อมูลต้นฉบับ API ของคุณผ่าน ตัวอย่างเช่น คุณอาจจะมีเพื่อนที่พยายามจะใช้วิธีนั้น แต่เจ้าของได้ตั้งแต่ออกจาก UI เช่นกล่องโต้ตอบกิริยาที่ถูกปิด ที่ไม่ใช่ - ไคลเอ็นต์สุทธิ , แผนที่ uia_e_elementnotavailable .โยน elementnotenabledexception ถ้ายังมีเจ้าของ แต่เจ้าของอยู่ในโหมดเช่น isenabled = เท็จที่บล็อกบางส่วนของการเขียนโปรแกรมเฉพาะการเปลี่ยนแปลงที่เพื่อนของคุณพยายามที่จะบรรลุ ที่ไม่ใช่ - ไคลเอ็นต์สุทธิ , แผนที่นี้