Other Core methodsYour control may

Other Core methods

Your control may need to support keyboard equivalents for primary scenarios; for more info about why this might be necessary, see Keyboard accessibility. Implementing the key support is necessarily part of the control code and not the peer code because that is part of a control's logic, but your peer class should override the GetAcceleratorKeyCore and GetAccessKeyCore methods to report to UI Automation clients which keys are used. Consider that the strings that report key information might need to be localized, and should therefore come from resources, not hard-coded strings.

If you are providing a peer for a class that supports a collection, it's best to derive from both functional classes and peer classes that already have that kind of collection support. If you can't do so, peers for controls that maintain child collections may have to override the collection-related peer method GetChildrenCore to properly report the parent-child relationships to the UI Automation tree.

Implement the IsContentElementCore and IsControlElementCore methods to indicate whether your control contains data content or fulfills an interactive role in the user interface (or both). By default, both methods return true. These settings improve the usability of assistive technologies such as screen readers, which may use these methods to filter the automation tree. If your GetPatternCore method transfers pattern handling to a subelement peer, the subelement peer's IsControlElementCore method can return false to hide the subelement peer from the automation tree.

Some controls may support labeling scenarios, where a text label part supplies information for a non-text part, or a control is intended to be in a known labeling relationship with another control in the UI. If it's possible to provide a useful class-based behavior, you can override GetLabeledByCore to provide this behavior.

GetBoundingRectangleCore and GetClickablePointCore are used mainly for automated testing scenarios. If you want to support automated testing for your control, you might want to override these methods. This might be desired for range-type controls, where you can't suggest just a single point because where the user clicks in coordinate space has a different effect on a range. For example, the default ScrollBar automation peer overrides GetClickablePointCore to return a "not a number" Point value.

GetLiveSettingCore influences the control default for the LiveSetting value for UI Automation. You might want to override this if you want your control to return a value other than AutomationLiveSetting.Off. For more info on what LiveSetting represents, see AutomationProperties.LiveSetting.

You might override GetOrientationCore if your control has a settable orientation property that can map to AutomationOrientation. The ScrollBarAutomationPeer and SliderAutomationPeer classes do this.


Base implementation in FrameworkElementAutomationPeer

The base implementation of FrameworkElementAutomationPeer provides some UI Automation information that can be interpreted from various layout and behavior properties that are defined at the framework level.

GetBoundingRectangleCore: Returns a Rect structure based on the known layout characteristics. Returns a 0-value Rect if IsOffscreen is true.
GetClickablePointCore: Returns a Point structure based on the known layout characteristics, as long as there is a nonzero BoundingRectangle.
GetNameCore: More extensive behavior than can be summarized here; see GetNameCore. Basically, it attempts a string conversion on any known content of a ContentControl or related classes that have content. Also, if there is a value for LabeledBy, that item's Name value is used as the Name.
HasKeyboardFocusCore: Evaluated based on the owner's FocusState and IsEnabled properties. Elements that aren't controls always return false.
IsEnabledCore: Evaluated based on the owner's IsEnabled property if it is a Control. Elements that aren't controls always return true. This doesn't mean that the owner is enabled in the conventional interaction sense; it means that the peer is enabled despite the owner not having an IsEnabled property.
IsKeyboardFocusableCore: Returns true if owner is a Control; otherwise it is false.
IsOffscreenCore: A Visibility of Hidden on the owner element or any of its parents equates to a true value for IsOffscreen. Exception: a Popup object can be visible even if its owner's parents are not.
SetFocusCore: Calls Focus.
GetParent: Calls FrameworkElement.Parent from the owner, and looks up the appropriate peer. This isn't an override pair with a "Core" method, so you can't change this behavior.

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

วิธีการหลักอื่น ๆการควบคุมอาจต้องสนับสนุนแป้นพิมพ์สำหรับสถานการณ์หลัก สำหรับข้อมูลเพิ่มเติมเกี่ยวกับเหตุนี้อาจจำเป็น ดูการเข้าถึงแป้นพิมพ์ ดำเนินการสนับสนุนที่สำคัญคือจำเป็นต้องของรหัสควบคุมและไม่ใช่รหัสเพียร์ที่เป็นส่วนหนึ่งของตัวควบคุมตรรกะ แต่ชั้นเพียร์ควรแทน GetAcceleratorKeyCore และ GetAccessKeyCore วิธีการรายงานไปยังไคลเอนต์ UI Automation แป้นที่จะใช้ พิจารณาว่า สายที่รายงานข้อมูลที่สำคัญอาจต้องถูกปรับ และดังนั้นจึงควรมาจากทรัพยากร สายที่ไม่ตายถ้าคุณจะให้แบบเพียร์สำหรับคลาสที่สนับสนุนคอลเลกชัน มีการสืบทอดมาจากคลาสที่ทำงานและเรียนเพียร์ที่มีชนิดของการสนับสนุนชุดดีที่สุด ถ้าคุณไม่ทำเช่นนั้น เพื่อนสำหรับการควบคุมที่รักษาเด็กคออาจมีการแทนวิธีการเก็บเกี่ยวข้องเพียร์ GetChildrenCore อย่างถูกต้องรายงานความสัมพันธ์แม่ลูกไป UI Automationใช้วิธีการ IsContentElementCore และ IsControlElementCore เพื่อบ่งชี้ว่า การควบคุมประกอบด้วยเนื้อหาข้อมูล หรือตอบสนองบทบาทการโต้ตอบในส่วนติดต่อผู้ใช้ (หรือทั้งสอง) โดยค่าเริ่มต้น ทั้งสองวิธีส่งคืนจริง การตั้งค่าเหล่านี้ปรับปรุงการใช้งานของเทคโนโลยีช่วยเหลือเช่นตัวอ่านหน้าจอ ซึ่งอาจใช้วิธีการเหล่านี้เพื่อกรองข้อมูลแผนภูมิการทำงานอัตโนมัติ ถ้าวิธีของคุณ GetPatternCore ถ่ายโอนรูปแบบการจัดการแบบเพียร์ subelement วิธีของเพียร์ subelement IsControlElementCore สามารถส่งคืนเท็จซ่อนเพียร์ subelement จากต้นไม้อัตโนมัติตัวควบคุมบางตัวอาจสนับสนุนการติดฉลากสถานการณ์ ซึ่งเป็นส่วนหนึ่งของข้อความป้ายชื่ออุปกรณ์ข้อมูลสำหรับส่วนไม่ใช่ข้อความ หรือตัวควบคุมมีไว้เพื่ออยู่ในความสัมพันธ์การติดฉลากที่รู้จักกับตัวควบคุมอื่นใน UI ถ้าเป็นไปได้ที่จะให้ประโยชน์ตามลักษณะการทำงาน คุณสามารถแทนที่ GetLabeledByCore เพื่อให้ทำงานนี้GetBoundingRectangleCore และ GetClickablePointCore จะใช้สำหรับสถานการณ์การทดสอบอัตโนมัติ ถ้าคุณต้องการสนับสนุนการทดสอบอัตโนมัติสำหรับตัวควบคุมของคุณ คุณอาจต้องการแทนที่วิธีการเหล่านี้ นี้อาจเป็นที่ต้องการควบคุมชนิดช่วง ที่คุณไม่สามารถแนะนำเพียงจุดเดียวเนื่องจากที่ผู้ใช้คลิในพื้นที่ประสานงานมีผลแตกต่างกันในช่วง เช่น เริ่มต้นแถบเลื่อนอัตโนมัติเพียร์แทน GetClickablePointCore เพื่อกลับไป "ไม่ใช่ตัวเลข" ชี้ค่าGetLiveSettingCore มีอิทธิพลต่อการควบคุมเริ่มต้นสำหรับค่า LiveSetting สำหรับ UI Automation คุณอาจต้องการแทนที่ค่านี้ถ้าคุณต้องการควบคุมการส่งกลับค่าอื่นที่ไม่ใช่ AutomationLiveSetting.Off สำหรับข้อมูลเพิ่มเติมเกี่ยวกับสิ่งที่ LiveSetting แทน ดู AutomationProperties.LiveSettingคุณอาจแทน GetOrientationCore ถ้าตัวควบคุมของคุณมีคุณสมบัติทิศทางที่กำหนดได้ที่แผนการ AutomationOrientation เรียน ScrollBarAutomationPeer และ SliderAutomationPeer ทำเช่นนี้การใช้งานพื้นฐานใน FrameworkElementAutomationPeerการใช้งานพื้นฐานของ FrameworkElementAutomationPeer แสดงข้อมูล UI Automation ที่สามารถตีความจากรูปแบบต่าง ๆ และคุณสมบัติของลักษณะการทำงานที่กำหนดไว้ในระดับกรอบบางGetBoundingRectangleCore: กลับโครงสร้างรางเหลี่ยมตามลักษณะของเค้ารู้จัก ส่งกลับรางเหลี่ยมค่า 0 ถ้า IsOffscreen เป็นจริงGetClickablePointCore: ส่งกลับจุดโครงสร้างตามลักษณะเค้ารู้จัก ตราบใดที่มี BoundingRectangle ค่าGetNameCore: ลักษณะการทำงานหลากหลายมากขึ้นกว่าสามารถสรุปนี่ ดู GetNameCore โดยทั่วไป พยายามแปลงอักขระเนื้อทราบของ ContentControl หรือชั้นเรียนที่เกี่ยวข้องที่มีเนื้อหา นอกจากนี้ ถ้ามีค่า LabeledBy ค่าชื่อของสินค้าที่ถูกใช้เป็นชื่อHasKeyboardFocusCore: ประเมินตามคุณสมบัติ FocusState และลับของเจ้าของ องค์ประกอบที่ไม่ได้ควบคุมเสมอกลับเท็จIsEnabledCore: ประเมินอิงคุณสมบัติลับของเจ้าของถ้าเป็นตัวควบคุม องค์ประกอบที่ไม่ควบคุมแต่กลับจริง นี้ไม่ได้หมายความ ว่า เจ้าของจะเปิดใช้ในการโต้ตอบทั่วไป หมายความ ว่า เพียร์ถูกเปิดใช้งานแม้ มีเจ้าของไม่มีคุณสมบัติการลับIsKeyboardFocusableCore: คืนค่าจริงถ้าเจ้าของมีตัวควบคุม มิฉะนั้น เป็นเท็จIsOffscreenCore: การมองเห็นของที่ซ่อนองค์เจ้าหรือของพ่อแม่เท่ากับค่าจริงสำหรับ IsOffscreen ข้อยกเว้น: วัตถุผุดขึ้นสามารถมองเห็นได้แม้ว่าพ่อแม่ของเจ้าของไม่SetFocusCore: โทรโฟกัสGetParent: FrameworkElement.Parent โทรจากเจ้าของ และลักษณะค่าเพียร์ที่เหมาะสม นี้ไม่มีคู่แทน ด้วยวิธี "หลัก" ดังนั้นคุณไม่สามารถเปลี่ยนลักษณะการทำงานนี้

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

วิธีการหลักอื่น ๆการควบคุมของคุณอาจต้องการที่จะสนับสนุนเทียบเท่าแป้นพิมพ์สำหรับสถานการณ์หลัก; สำหรับข้อมูลเพิ่มเติมเกี่ยวกับสาเหตุนี้อาจจะจำเป็นต้องเห็นการเข้าถึงแป้นพิมพ์ การดำเนินการสนับสนุนที่สำคัญคือจำเป็นต้องเป็นส่วนหนึ่งของรหัสควบคุมและไม่รหัสเพียร์เพราะเห็นว่าเป็นส่วนหนึ่งของตรรกะของตัวควบคุม แต่ชั้นเพียร์ของคุณควรแทนที่ GetAcceleratorKeyCore และ GetAccessKeyCore วิธีการที่จะรายงานให้กับลูกค้า UI อัตโนมัติซึ่งจะใช้กุญแจ พิจารณาว่าสายที่รายงานข้อมูลที่สำคัญอาจจะต้องมีการแปลและดังนั้นจึงควรจะมาจากแหล่งข้อมูลที่ไม่สตริงยากรหัส. ถ้าคุณจะให้เพียร์สำหรับการเรียนที่สนับสนุนคอลเลกชันที่ดีที่สุดที่จะเป็นผลมาจากทั้งการเรียนการทำงานและ เรียนเพียร์ที่มีอยู่แล้วมีชนิดของคอลเลกชันที่สนับสนุน ถ้าคุณไม่สามารถทำเช่นนั้นคนรอบข้างสำหรับการควบคุมที่รักษาคอลเลกชันของเด็กอาจจะต้องแทนที่คอลเลกชันที่เกี่ยวข้องกับวิธีการแบบ peer GetChildrenCore ที่จะต้องรายงานความสัมพันธ์แม่ลูกกับต้นไม้ UI อัตโนมัติ. ปฏิบัติตาม IsContentElementCore และ IsControlElementCore วิธีการที่จะระบุว่าคุณ การควบคุมมีเนื้อหาข้อมูลหรือตอบสนองบทบาทโต้ตอบในส่วนติดต่อผู้ใช้ (หรือทั้งสอง) โดยค่าเริ่มต้นวิธีการทั้งสองกลับจริง ตั้งค่าเหล่านี้ปรับปรุงการใช้งานของเทคโนโลยีที่อำนวยความสะดวกเช่นโปรแกรมอ่านหน้าจอซึ่งอาจใช้วิธีการเหล่านี้เพื่อกรองต้นไม้อัตโนมัติที่ หาก GetPatternCore รูปแบบการถ่ายโอนวิธีการของคุณจัดการกับเพียร์ subelement วิธี IsControlElementCore เพียร์ subelement สามารถกลับเท็จเพื่อซ่อนเพียร์ subelement จากต้นไม้อัตโนมัติ. การควบคุมบางอย่างอาจรองรับสถานการณ์การติดฉลากที่ป้ายข้อความข้อมูลวัสดุส่วนสำหรับส่วนที่ไม่ใช่ข้อความ หรือการควบคุมมีจุดมุ่งหมายที่จะอยู่ในความสัมพันธ์ที่รู้จักกันในการติดฉลากที่มีการควบคุมอื่นใน UI ถ้ามันเป็นไปได้ที่จะให้มีพฤติกรรมระดับตามที่มีประโยชน์คุณสามารถแทนที่ GetLabeledByCore เพื่อให้พฤติกรรมนี้. GetBoundingRectangleCore และ GetClickablePointCore ใช้เป็นหลักสำหรับสถานการณ์การทดสอบแบบอัตโนมัติ หากคุณต้องการที่จะสนับสนุนการทดสอบโดยอัตโนมัติสำหรับการควบคุมของคุณคุณอาจต้องการแทนที่วิธีการเหล่านี้ นี้อาจเป็นที่ต้องการสำหรับการควบคุมช่วงชนิดที่คุณไม่สามารถแนะนำเพียงจุดเดียวเพราะที่ผู้ใช้คลิกในการประสานงานพื้นที่มีผลแตกต่างกันในช่วง ยกตัวอย่างเช่นแถบเลื่อนเพียร์อัตโนมัติเริ่มต้นแทนที่ GetClickablePointCore ที่จะกลับมาเป็น "ไม่ได้เป็นจำนวน" ค่าจุด. GetLiveSettingCore มีผลต่อการควบคุมค่าเริ่มต้นสำหรับค่า LiveSetting สำหรับ UI อัตโนมัติ คุณอาจต้องการที่จะแทนที่นี้ถ้าคุณต้องการการควบคุมของคุณจะกลับมาเป็นค่าอื่นนอกเหนือ AutomationLiveSetting.Off สำหรับข้อมูลเพิ่มเติมเกี่ยวกับสิ่งที่แสดงให้เห็นถึง LiveSetting ให้ดู AutomationProperties.LiveSetting. คุณอาจแทนที่ GetOrientationCore ถ้าการควบคุมของคุณมีคุณสมบัติการวางแนวทางตัวอย่างไฟล์ที่สามารถแมปไป AutomationOrientation ScrollBarAutomationPeer และ SliderAutomationPeer เรียนทำเช่นนี้. ดำเนินการฐานใน FrameworkElementAutomationPeer การดำเนินการฐานของ FrameworkElementAutomationPeer ให้ข้อมูลบางอย่าง UI ทำงานอัตโนมัติที่สามารถตีความได้จากรูปแบบและพฤติกรรมคุณสมบัติต่างๆที่กำหนดไว้ในระดับกรอบ. GetBoundingRectangleCore: คืน RECT โครงสร้างบนพื้นฐานของการเป็นที่รู้จัก ลักษณะรูปแบบ ส่งกลับ 0 ค่า Rect ถ้า IsOffscreen เป็นความจริง. GetClickablePointCore: คืนโครงสร้างจุดซึ่งเป็นไปตามลักษณะรูปแบบที่รู้จักกันตราบใดที่มีการ BoundingRectangle ภัณฑ์. GetNameCore: พฤติกรรมอย่างกว้างขวางมากขึ้นกว่าที่สามารถสรุปได้ที่นี่ ดู GetNameCore โดยทั่วไปจะพยายามแปลงสตริงกับเนื้อหาที่รู้จักกันใด ๆ ของ ContentControl หรือชั้นเรียนที่เกี่ยวข้องที่มีเนื้อหา นอกจากนี้ถ้ามีค่าสำหรับ LabeledBy ค่าชื่อรายการที่ใช้เป็นชื่อ. HasKeyboardFocusCore: การประเมินขึ้นอยู่กับเจ้าของ FocusState และ IsEnabled คุณสมบัติ องค์ประกอบที่ไม่ได้ควบคุมเสมอกลับเท็จ. IsEnabledCore: การประเมินขึ้นอยู่กับคุณสมบัติ IsEnabled เจ้าของถ้ามันเป็นตัวควบคุม องค์ประกอบที่ไม่ได้ควบคุมเสมอกลับจริง นี้ไม่ได้หมายความว่าเจ้าของถูกเปิดใช้งานในความรู้สึกที่มีปฏิสัมพันธ์ธรรมดา; ก็หมายความว่าเพียร์ถูกเปิดใช้งานแม้จะมีเจ้าของที่ไม่ได้มีคุณสมบัติ IsEnabled. IsKeyboardFocusableCore: คืนจริงถ้าเจ้าของควบคุม; มิฉะนั้นมันเป็นเท็จ. IsOffscreenCore: มองเห็นของที่ซ่อนอยู่ในองค์ประกอบเจ้าของหรือใด ๆ ของพ่อแม่ของมันเท่ากับมูลค่าที่แท้จริงสำหรับ IsOffscreen ข้อยกเว้น: วัตถุป๊อปอัพสามารถมองเห็นได้แม้ถ้าพ่อแม่ของเจ้าของไม่ได้. SetFocusCore: โทรโฟกัส. GetParent: โทร FrameworkElement.Parent จากเจ้าของและเงยหน้าขึ้นมองเพียร์ที่เหมาะสม นี้ไม่ได้เป็นคู่แทนที่ด้วย "แก่น" วิธีการเพื่อให้คุณไม่สามารถเปลี่ยนพฤติกรรมนี้