AutomationEvents identifiersUI Auto

AutomationEvents identifiers

UI Automation events are identified by AutomationEvents values. The values of the enumeration uniquely identify the kind of event.


Raising events

UI Automation clients can subscribe to automation events. In the automation peer model, peers for custom controls must report changes to control state that are relevant to accessibility by calling the RaiseAutomationEvent method. Similarly, when a key UI Automation property value changes, custom control peers should call the RaisePropertyChangedEvent method.

The next code example shows how to get the peer object from within the control definition code and call a method to fire an event from that peer. As an optimization, the code determines whether there are any listeners for this event type. Firing the event and creating the peer object only when there are listeners avoids unnecessary overhead and helps the control remain responsive.

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

รหัส AutomationEventsกิจกรรม UI Automation ที่ระบุ โดย AutomationEvents ค่า ค่าการแจงนับตัวระบุชนิดของเหตุการณ์เพิ่มเหตุการณ์UI Automation ลูกค้าสามารถสมัครสมาชิกเพื่อกิจกรรมอัตโนมัติ ในรูปแบบเพียร์อัตโนมัติ เพื่อนสำหรับตัวควบคุมแบบกำหนดเองต้องรายงานการเปลี่ยนแปลงการควบคุมรัฐที่เกี่ยวข้องกับการเข้าถึง โดยการเรียกวิธีการ RaiseAutomationEvent ในทำนองเดียวกัน เมื่อเปลี่ยนค่าคุณสมบัติ UI Automation สำคัญ ตัวควบคุมกำหนดเองเพื่อนควรเรียกวิธี RaisePropertyChangedEventตัวอย่างรหัสถัดไปแสดงวิธีการรับวัตถุเพียร์จากภายในรหัสกำหนดควบคุม และเรียกวิธีลั่นเหตุการณ์จากเพียร์ที่ เป็นการเพิ่มประสิทธิภาพ รหัสกำหนดว่า มีผู้ฟังใด ๆ สำหรับเหตุการณ์ชนิดนี้ เหตุการณ์ยิง และสร้างวัตถุเพียร์เท่านั้นเมื่อมีผู้ฟังเพื่อหลีกเลี่ยงค่าใช้จ่ายที่ไม่จำเป็น และช่วยให้การควบคุมยังคงตอบสนอง

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

AutomationEvents ตัวระบุเหตุการณ์ UI อัตโนมัติโดยจะมีการระบุค่า AutomationEvents ค่าของการแจงนับไม่ซ้ำกันระบุชนิดของเหตุการณ์. เพิ่มเหตุการณ์ลูกค้า UI อัตโนมัติสามารถสมัครสมาชิกกับเหตุการณ์อัตโนมัติ ในรูปแบบเพียร์อัตโนมัติเพื่อนสำหรับการควบคุมที่กำหนดเองจะต้องรายงานการเปลี่ยนแปลงการควบคุมของรัฐที่เกี่ยวข้องกับการเข้าถึงโดยเรียกวิธี RaiseAutomationEvent ในทำนองเดียวกันเมื่อคีย์ UI อัตโนมัติเปลี่ยนแปลงมูลค่าทรัพย์สินเพื่อนควบคุมที่กำหนดเองควรจะเรียกวิธี RaisePropertyChangedEvent ได้. ตัวอย่างรหัสต่อไปแสดงให้เห็นถึงวิธีการที่จะได้รับวัตถุเพียร์จากภายในรหัสนิยามควบคุมและเรียกวิธีการที่จะเริ่มกิจกรรมจากเพียร์ว่า ขณะที่การเพิ่มประสิทธิภาพรหัสกำหนดว่าจะมีผู้ฟังใด ๆ สำหรับประเภทเหตุการณ์นี้ ยิงเหตุการณ์และการสร้างวัตถุเพียร์เฉพาะเมื่อมีผู้ฟังหลีกเลี่ยงค่าใช้จ่ายที่ไม่จำเป็นและจะช่วยให้การควบคุมยังคงตอบสนอง