GetPattern and GetPatternCoreA peer

GetPattern and GetPatternCore

A peer's implementation of GetPatternCore returns the object that supports the pattern that is requested in the input parameter. Specifically, a UI Automation client calls a method that is forwarded to the provider's GetPattern method, and specifies a PatternInterface enumeration value that names the requested pattern. Your override of GetPatternCore should return the object that implements the specified pattern. That object is the peer itself, because the peer should implement the corresponding pattern interface any time that it reports that it supports a pattern. If your peer does not have a custom implementation of a pattern, but you know that the peer's base does implement the pattern, you can call the base type's implementation of GetPatternCore from your GetPatternCore. A peer's GetPatternCore should return null if a pattern is not supported by the peer. However, instead of returning null directly from your implementation, you would usually rely on the call to the base implementation to return null for any unsupported pattern.

When a pattern is supported, the GetPatternCore implementation can return this or Me. The expectation is that the UI Automation client will cast the GetPattern return value to the requested pattern interface whenever it is not null.

If a peer class inherits from another peer, and all necessary support and pattern reporting is already handled by the base class, implementing GetPatternCore isn't necessary. For example, if you are implementing a range control that derives from RangeBase, and your peer derives from RangeBaseAutomationPeer, that peer returns itself for PatternInterface.RangeValue and has working implementations of the IRangeValueProvider interface that supports the pattern.

Although it is not the literal code, this example approximates the implementation of GetPatternCore already present in RangeBaseAutomationPeer.

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

GetPattern และ GetPatternCoreการใช้งานแบบเพียร์ของ GetPatternCore ส่งกลับค่าวัตถุที่รองรับรูปแบบที่มีการร้องขอในพารามิเตอร์ป้อนเข้า เฉพาะ UI Automation ไคลเอนต์เรียกวิธีการที่ถูกส่งต่อไปวิธีการ GetPattern ของผู้ให้บริการ และระบุค่าแจงนับ PatternInterface ที่ชื่อรูปแบบการร้องขอ แทนที่ต้องการ GetPatternCore ส่งกลับวัตถุที่ใช้รูปแบบที่ระบุ วัตถุเป็นเพียร์เอง เพราะเพียร์ควรใช้อินเทอร์เฟซแบบสอดคล้องกันตลอดเวลาที่มันรายงานว่า จะสนับสนุนรูปแบบ ถ้าเพียร์ของคุณไม่มีการดำเนินการแบบกำหนดเองของรูปแบบ แต่คุณทราบว่า ฐานของเพียร์ที่ใช้รูปแบบ คุณสามารถเรียกใช้งานชนิดพื้นฐานของ GetPatternCore จากคุณ GetPatternCore GetPatternCore แบบเพียร์ส่งกลับเป็น null ถ้าเพียร์ไม่สนับสนุนรูปแบบ อย่างไรก็ตาม แทนการส่งกลับค่า null โดยตรงจากการใช้งานของคุณ คุณจะมักจะพึ่งการเรียกงานฐานกลับเป็น null สำหรับทุกรูปแบบไม่สนับสนุนเมื่อรูปแบบสนับสนุน การใช้งาน GetPatternCore สามารถส่งคืนนี้หรือฉัน คาดหวังได้ว่า ใช้ UI จะโยนค่าตอบแทน GetPattern กับอินเทอร์เฟซร้องขอรูปแบบเมื่อใดก็ ตามที่ไม่ว่างถ้าเพียร์คลาสที่สืบทอดจาก เพียร์อื่น และสนับสนุนที่จำเป็นทั้งหมด และรูปแบบรายงานแล้วจัดการ โดยคลาพื้นฐาน การใช้ GetPatternCore ไม่จำเป็น เช่น ถ้าคุณใช้ตัวควบคุมช่วงที่มาจาก RangeBase และเพียร์ของคุณมาจาก RangeBaseAutomationPeer เพียร์ที่กลับตัวเองสำหรับ PatternInterface.RangeValue และได้ปฏิบัติการทำงานของอินเทอร์เฟซสำหรับ IRangeValueProvider ที่รองรับรูปแบบแม้ว่าไม่ใช่รหัสตัวอักษร ตัวอย่างนี้สใกล้เคียงกับทองคำการดำเนินการของ GetPatternCore อยู่ใน RangeBaseAutomationPeer

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

GetPattern และ GetPatternCore ให้การดำเนินงานของเพียร์ GetPatternCore ส่งกลับวัตถุที่สนับสนุนรูปแบบที่มีการร้องขอในพารามิเตอร์การป้อนข้อมูล โดยเฉพาะลูกค้า UI อัตโนมัติเรียกวิธีการที่ถูกส่งต่อไปยังวิธี GetPattern ของผู้ให้บริการและระบุค่าการแจงนับ PatternInterface ว่าชื่อรูปแบบที่ได้รับการร้องขอ แทนที่ของคุณ GetPatternCore ควรกลับวัตถุที่ใช้รูปแบบที่ระบุ วัตถุที่ถูกเพียร์ตัวเองเพราะเพียร์ควรใช้อินเตอร์เฟซรูปแบบที่สอดคล้องกันตลอดเวลาว่ามันรายงานว่าจะสนับสนุนรูปแบบ ถ้าเพื่อนของคุณไม่ได้ดำเนินการเองของรูปแบบ แต่คุณรู้ว่าฐานของขุนนางไม่ดำเนินการตามรูปแบบที่คุณสามารถเรียกใช้งานสำหรับชนิดฐานของ GetPatternCore จาก GetPatternCore ของคุณ GetPatternCore ขุนนางควรกลับ null ถ้ารูปแบบไม่ได้รับการสนับสนุนโดยเพียร์ แต่แทนที่จะกลับ null โดยตรงจากการดำเนินงานของคุณคุณจะมักจะพึ่งพาการเรียกร้องให้ดำเนินการฐานเพื่อกลับ null สำหรับรูปแบบได้รับการสนับสนุนใด ๆ . เมื่อเป็นรูปแบบที่ได้รับการสนับสนุนการดำเนินงาน GetPatternCore สามารถกลับนี้หรือฉัน ความคาดหวังว่าลูกค้า UI อัตโนมัติจะโยนค่าตอบแทน GetPattern กับอินเตอร์เฟซรูปแบบการร้องขอเมื่อใดก็ตามที่มันไม่ได้เป็น null. ถ้าชั้นเพียร์ได้รับมรดกจากเพียร์อื่นและสนับสนุนที่จำเป็นทั้งหมดและการรายงานรูปแบบมีการจัดการแล้วโดยชั้นฐานการดำเนินการ GetPatternCore ไม่จำเป็น ตัวอย่างเช่นถ้าคุณมีการดำเนินการควบคุมช่วงที่เกิดขึ้นจาก RangeBase และเพื่อนของคุณมาจาก RangeBaseAutomationPeer, เพียร์ที่ส่งกลับตัวเองสำหรับ PatternInterface.RangeValue และมีการใช้งานการทำงานของอินเตอร์เฟซ IRangeValueProvider ที่สนับสนุนรูปแบบ. แม้ว่ามันจะไม่ได้เป็นรหัสตัวอักษร ตัวอย่างนี้ใกล้เคียงกับการดำเนินงานของ GetPatternCore ปัจจุบันแล้วใน RangeBaseAutomationPeer