Built-in automation peer classesIn

Built-in automation peer classes

In general, elements implement an automation peer class if they accept UI activity from the user, or if they contain information needed by users of assistive technologies that represent the interactive or meaningful UI of apps. Not all UWP visual elements have automation peers. Examples of classes that implement automation peers are Button and TextBox. Examples of classes that do not implement automation peers are Border and classes based on Panel, such as Grid and Canvas. A Panel has no peer because it is providing a layout behavior that is visual only. There is no accessibility-relevant way for the user to interact with a Panel. Whatever child elements a Panel contains are instead reported to UI Automation trees as child elements of the next available parent in the tree that has a peer or element representation.


UI Automation and UWP process boundaries

Typically, UI Automation client code that accesses a UWP app runs out-of-process. The UI Automation framework infrastructure enables information to get across the process boundary. This concept is explained in more detail in UI Automation Fundamentals.


OnCreateAutomationPeer

All classes that derive from UIElement contain the protected virtual method OnCreateAutomationPeer. The object initialization sequence for automation peers calls OnCreateAutomationPeer to get the automation peer object for each control and thus to construct a UI Automation tree for run-time use. UI Automation code can use the peer to get information about a control’s characteristics and features and to simulate interactive use by means of its control patterns. A custom control that supports automation must override OnCreateAutomationPeer and return an instance of a class that derives from AutomationPeer. For example, if a custom control derives from the ButtonBase class, the object returned by OnCreateAutomationPeer should derive from ButtonBaseAutomationPeer.

If you're writing a custom control class and intend to also supply a new automation peer, you should override the OnCreateAutomationPeer method for your custom control so that it returns a new instance of your peer. Your peer class must derive directly or indirectly from AutomationPeer.

For example, the following code declares that the custom control NumericUpDown should use the peer NumericUpDownPeer for UI Automation purposes.

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

เรียนเพียร์อัตโนมัติในตัวทั่วไป องค์ประกอบใช้คลาเพียร์อัตโนมัติ ถ้าเขายอมรับกิจกรรม UI จากผู้ใช้ หรือ ถ้าประกอบด้วยข้อมูลที่จำเป็นสำหรับผู้ใช้เทคโนโลยีเพื่อการช่วยเหลือที่มีความหมาย หรือแบบโต้ตอบ UI ของแอ องค์ประกอบภาพด้วยครับไม่มีเพื่อนทำงานอัตโนมัติ ตัวอย่างของคลาสที่ใช้เพื่อนอัตโนมัติมีปุ่มและกล่องข้อความ ตัวอย่างของไม่ใช้เพื่อนอัตโนมัติมีเส้นขอบและคลาสที่ตามแผง ตารางและผ้าใบ แผงมีเพียร์ไม่ เพราะมันคือการให้ลักษณะเค้าโครงที่แสดงเท่านั้น มีวิธีการเข้าถึงที่เกี่ยวข้องสำหรับผู้ใช้สามารถโต้ตอบกับแผง มีองค์ประกอบลูกใดประกอบด้วยแผงแทนรายงาน UI Automation ต้นไม้เป็นองค์ประกอบลูกของแม่มีต่อไปในแผนภูมิที่มีการแสดงเพียร์หรือองค์ประกอบขอบเขตของกระบวนการ UI Automation และด้วยครับโดยทั่วไป UI Automation ไคลเอนต์รหัสที่เข้าถึงการรันโปรแกรมรันออกกระบวนการ โครงสร้างกรอบการทำงานของ UI Automation ช่วยให้ข้อมูลได้ขอบเขตกระบวนการ แนวคิดนี้อธิบายรายละเอียดใน UI Automation พื้นฐานOnCreateAutomationPeerเรียนทั้งหมดที่สืบทอดมาจาก UIElement ประกอบด้วยวิธีการป้องกันเสมือน OnCreateAutomationPeer ลำดับการเตรียมใช้งานวัตถุสำหรับเพื่อนอัตโนมัติโทร OnCreateAutomationPeer เพื่อรับวัตถุเพียร์ระบบอัตโนมัติ สำหรับควบคุม และทำการสร้างต้นไม้ UI Automation สำหรับใช้ทำงาน รหัส UI Automation สามารถใช้เพียร์ เพื่อรับข้อมูลเกี่ยวกับลักษณะและคุณสมบัติของตัวควบคุม และ การจำลองการใช้โต้ตอบโดยใช้รูปแบบการควบคุม ตัวควบคุมแบบกำหนดเองที่สนับสนุนระบบอัตโนมัติต้องแทนที่ OnCreateAutomationPeer และส่งกลับอินสแตนซ์ของคลาสที่มาจาก AutomationPeer เช่น ถ้าตัวควบคุมแบบกำหนดเองมาจากคลาส ButtonBase วัตถุที่ส่งกลับ โดย OnCreateAutomationPeer ควรสืบทอดมาจาก ButtonBaseAutomationPeerถ้าคุณเขียนแบบควบคุมแบบกำหนดเอง และตั้งใจที่จะใส่ระบบอัตโนมัติเพียร์ใหม่ คุณควรแทนวิธีการ OnCreateAutomationPeer สำหรับตัวควบคุมแบบกำหนดเองของคุณเพื่อที่จะส่งกลับอินสแตนซ์ใหม่ของเพียร์ เรียนเพียร์ต้องสืบทอดมาโดยตรง หรือโดยอ้อมจาก AutomationPeerเช่น รหัสต่อไปนี้แสดงว่า ตัวเองควบคุม NumericUpDown ควรใช้เพียร์ NumericUpDownPeer ประสงค์ UI Automation

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

Built-in อัตโนมัติเรียนเพียร์โดยทั่วไปองค์ประกอบดำเนินการระดับอัตโนมัติเพียร์ถ้าพวกเขายอมรับกิจกรรม UI จากผู้ใช้หรือถ้าพวกเขามีข้อมูลที่จำเป็นโดยผู้ใช้ของเทคโนโลยีช่วยเหลือที่เป็นตัวแทนของ UI แบบโต้ตอบหรือความหมายของปพลิเคชัน ไม่ทุกองค์ประกอบภาพ UWP มีเพื่อนอัตโนมัติ ตัวอย่างของการเรียนที่ใช้คนรอบข้างมีปุ่มอัตโนมัติและกล่องข้อความ ตัวอย่างของชั้นเรียนที่ไม่ใช้เพื่อนร่วมงานอัตโนมัติที่มีชายแดนและการเรียนขึ้นอยู่กับแผงเช่นตารางและผ้าใบ แผงไม่มีเพื่อนเพราะมันจะให้รูปแบบพฤติกรรมที่เป็นภาพเท่านั้น ไม่มีวิธีการเข้าถึงที่เกี่ยวข้องเพื่อให้ผู้ใช้โต้ตอบกับแผงเป็น สิ่งที่องค์ประกอบแผงมีจะมีการรายงานแทนต้นไม้ UI อัตโนมัติเป็นองค์ประกอบของเด็กของผู้ปกครองที่มีอยู่ต่อไปในต้นไม้ที่มีเพื่อนหรือองค์ประกอบตัวแทน. เด็กอัตโนมัติ UI และ UWP ขอบเขตของกระบวนการโดยปกติ UI อัตโนมัติรหัสลูกค้าที่เข้าใช้แอพพลิเค UWP วิ่ง ออกจากกระบวนการ โครงสร้างพื้นฐานกรอบ UI อัตโนมัติช่วยให้ข้อมูลที่จะได้รับข้ามขอบเขตของกระบวนการ แนวคิดนี้จะมีการอธิบายในรายละเอียดในการทำงานอัตโนมัติ UI ความรู้พื้นฐาน. OnCreateAutomationPeer ทุกชั้นเรียนที่เป็นผลมาจาก UIElement มีวิธีการป้องกันเสมือน OnCreateAutomationPeer ลำดับวัตถุเริ่มต้นสำหรับคนรอบข้างอัตโนมัติเรียก OnCreateAutomationPeer ที่จะได้รับวัตถุอัตโนมัติเพียร์สำหรับแต่ละการควบคุมและทำให้การสร้างต้นไม้ UI อัตโนมัติสำหรับการใช้เวลาทำงาน รหัส UI อัตโนมัติสามารถใช้เพียร์จะได้รับข้อมูลเกี่ยวกับลักษณะของตัวควบคุมและคุณสมบัติและการจำลองการใช้งานแบบโต้ตอบโดยใช้วิธีการรูปแบบการควบคุมของตน การควบคุมที่กำหนดเองที่สนับสนุนระบบอัตโนมัติต้องแทนที่ OnCreateAutomationPeer และกลับไปอินสแตนซ์ของคลาสที่มาจาก AutomationPeer ตัวอย่างเช่นถ้ามีการควบคุมที่กำหนดเองมาจากระดับ ButtonBase วัตถุที่ส่งกลับโดย OnCreateAutomationPeer ควรมาจาก ButtonBaseAutomationPeer. หากคุณกำลังเขียนระดับควบคุมที่กำหนดเองและตั้งใจที่จะยังจัดหาเพียร์อัตโนมัติใหม่คุณควรแทนที่วิธี OnCreateAutomationPeer ของคุณ ควบคุมที่กำหนดเองเพื่อที่จะส่งกลับตัวอย่างใหม่ของเพียร์ของคุณ ระดับเพียร์ของคุณจะต้องได้รับมาโดยตรงหรือโดยอ้อมจาก AutomationPeer. ตัวอย่างเช่นรหัสต่อไปนี้ขอประกาศว่า NumericUpDown ควบคุมที่กำหนดเองควรใช้ NumericUpDownPeer เพียร์เพื่อวัตถุประสงค์ UI อัตโนมัติ