UIElement3DAutomationPeer 類別

定義

UIElement3D 類型公開至 UI 自動化。Exposes UIElement3D types to UI Automation.

public ref class UIElement3DAutomationPeer : System::Windows::Automation::Peers::AutomationPeer
public class UIElement3DAutomationPeer : System.Windows.Automation.Peers.AutomationPeer
type UIElement3DAutomationPeer = class
    inherit AutomationPeer
Public Class UIElement3DAutomationPeer
Inherits AutomationPeer
繼承
UIElement3DAutomationPeer

備註

根據預設,繼承自的任何類別都會 UIElement3D 使用 UIElement3DAutomationPeer 來與消費者介面自動化進行通訊。By default, any class that inherits from UIElement3D uses UIElement3DAutomationPeer to communicate with UI Automation.

如果您建立繼承自的類別 UIElement3D ,您可能會想要提供自動化對等來支援您類別的功能。If you create a class that inherits from UIElement3D, you may want to provide an automation peer to support the functionality of your class. 覆寫 GetClassNameCore 方法以傳回字串,表示與相關聯之專案的型別 UIElement3DAutomationPeerOverride the GetClassNameCore method to return a string that represents the type of the element associated with the UIElement3DAutomationPeer. 例如,如果您建立名為的類別, My3DElement 而且呼叫了自動化對等,則覆 My3DElementAutomationPeerGetClassNameCore 方法以傳回字串 "My3DElement"。For example, if you create a class called My3DElement and an automation peer called My3DElementAutomationPeer, override the GetClassNameCore method to return the string "My3DElement".

如果您的類別符合其中一個已知的控制項類型,請覆寫 GetAutomationControlTypeCore 方法以傳回該類型 ControlTypeIf your class matches one of the known control types, override the GetAutomationControlTypeCore method to return that ControlType. 請注意,雖然現有的 ControlType 值通常與2d 控制項相關聯,但 ControlType 表示控制項的功能,而不是其外觀。Note that although the existing ControlType values are generally associated with 2D controls, the ControlType indicates a control's functionality, not its appearance. 因此,如果您在 UIElement3D 使用者按一下動作時叫用動作,您可能會想要 GetHelpTextCore 返回 ControlType.ButtonSo if your UIElement3D invokes an action when the user clicks it, you probably want GetHelpTextCore to return ControlType.Button.

您自訂的行為 UIElement3D 會決定您應覆寫的其他方法。The behavior of your custom UIElement3D determines what other methods you should override. 中的每個方法主題都會 UIElement3DAutomationPeer 描述如何使用方法,以及何時適合覆寫方法。Each method topic in the UIElement3DAutomationPeer describes how the method is used and when it is appropriate to override it.

UIElement3DAutomationPeer 在 .NET Framework 版本3.5 中引進。UIElement3DAutomationPeer is introduced in the .NET Framework version 3.5. 如需詳細資訊,請參閱版本和相依性For more information, see Versions and Dependencies.

建構函式

UIElement3DAutomationPeer(UIElement3D)

初始化 UIElement3DAutomationPeer 類別的新執行個體。Initializes a new instance of the UIElement3DAutomationPeer class.

屬性

Dispatcher

取得與這個 Dispatcher 關聯的 DispatcherObjectGets the Dispatcher this DispatcherObject is associated with.

(繼承來源 DispatcherObject)
EventsSource

取得或設定 AutomationPeer,其報告至自動化用戶端,作為所有來自此 AutomationPeer 的事件來源。Gets or sets an AutomationPeer that is reported to the automation client as a source for all the events that come from this AutomationPeer.

(繼承來源 AutomationPeer)
IsHwndHost

取得值,這個值表示與此主控制項 AutomationPeer hwnds 在 WINDOWS PRESENTATION FOUNDATION (WPF) 中相關聯的元素。Gets a value that indicates whether the element that is associated with this AutomationPeer hosts hwnds in Windows Presentation Foundation (WPF).

(繼承來源 AutomationPeer)
Owner

取得與 UIElement3DAutomationPeer 相關聯的 UIElement3DGets the UIElement3D that is associated with this UIElement3DAutomationPeer.

方法

CheckAccess()

判斷呼叫的執行是否可以存取這個 DispatcherObjectDetermines whether the calling thread has access to this DispatcherObject.

(繼承來源 DispatcherObject)
CreatePeerForElement(UIElement3D)

為指定的 UIElement3D 建立 UIElement3DAutomationPeerCreates a UIElement3DAutomationPeer for the specified UIElement3D.

Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

(繼承來源 Object)
FromElement(UIElement3D)

傳回指定之 UIElement3DAutomationPeerUIElement3DReturns the UIElement3DAutomationPeer for the specified UIElement3D.

GetAcceleratorKey()

取得與消費者介面自動化對等相關聯之元素的快速鍵組合。Gets the accelerator key combinations for the element that is associated with the UI Automation peer.

(繼承來源 AutomationPeer)
GetAcceleratorKeyCore()

傳回與這個 UIElement3DAutomationPeer 相關聯之 UIElement3D 的快速鍵。Returns the accelerator key for the UIElement3D that is associated with this UIElement3DAutomationPeer. 這個方法是由 GetAcceleratorKey() 所呼叫。This method is called by GetAcceleratorKey().

GetAccessKey()

取得與自動化對等相關聯之項目的存取金鑰。Gets the access key for the element that is associated with the automation peer.

(繼承來源 AutomationPeer)
GetAccessKeyCore()

傳回與這個 UIElement3DAutomationPeer 相關聯之 UIElement3D 的便捷鍵。Returns the access key for the UIElement3D that is associated with this UIElement3DAutomationPeer. 這個方法是由 GetAccessKey() 所呼叫。This method is called by GetAccessKey().

GetAutomationControlType()

取得與消費者介面自動化對等相關聯之元素的控制項類型。Gets the control type for the element that is associated with the UI Automation peer.

(繼承來源 AutomationPeer)
GetAutomationControlTypeCore()

傳回與這個 UIElement3DAutomationPeer 相關聯之 UIElement3D 的控制項類型。Returns the control type for the UIElement3D that is associated with this UIElement3DAutomationPeer. 這個方法是由 GetAutomationControlType() 所呼叫。This method is called by GetAutomationControlType().

GetAutomationId()

取得與自動化對等個體相關聯項目的 AutomationIdGets the AutomationId of the element that is associated with the automation peer.

(繼承來源 AutomationPeer)
GetAutomationIdCore()

傳回字串,這個字串會唯一識別與這個 UIElement3D 相關聯的 UIElement3DAutomationPeerReturns the string that uniquely identifies the UIElement3D that is associated with this UIElement3DAutomationPeer. 這個方法是由 GetAutomationId() 所呼叫。This method is called by GetAutomationId().

GetBoundingRectangle()

取得 Rect 物件,這個物件表示與自動化對等個體關聯之項目的螢幕座標。Gets the Rect object that represents the screen coordinates of the element that is associated with the automation peer.

(繼承來源 AutomationPeer)
GetBoundingRectangleCore()

傳回 Rect,表示與這個 UIElement3D 相關聯之 UIElement3DAutomationPeer 的週框 (Bounding Rectangle)。Returns the Rect that represents the bounding rectangle of the UIElement3D that is associated with this UIElement3DAutomationPeer. 這個方法是由 GetBoundingRectangle() 所呼叫。This method is called by GetBoundingRectangle().

GetChildren()

取得 GetChildren() 項目的集合,這些項目在使用者介面自動化樹狀目錄中是表示為自動化對等個體的直系子項目。Gets the collection of GetChildren() elements that are represented in the UI Automation tree as immediate child elements of the automation peer.

(繼承來源 AutomationPeer)
GetChildrenCore()

傳回與這個 UIElement3D 相關聯之 UIElement3DAutomationPeer 的子項目集合。Returns the collection of child elements of the UIElement3D that is associated with this UIElement3DAutomationPeer. 這個方法是由 GetChildren() 所呼叫。This method is called by GetChildren().

GetClassName()

取得與 AutomationControlType 一起使用的名稱,以區分此 AutomationPeer 所表示的控制項。Gets a name that is used with AutomationControlType, to differentiate the control that is represented by this AutomationPeer.

(繼承來源 AutomationPeer)
GetClassNameCore()

傳回與這個 UIElement3D 相關聯之 UIElement3DAutomationPeer 的名稱。Returns the name of the UIElement3D that is associated with this UIElement3DAutomationPeer. 這個方法是由 GetClassName() 所呼叫。This method is called by GetClassName().

GetClickablePoint()

取得與自動化對等個體關聯之項目上的 Point,該對等個體回應滑鼠點選動作。Gets a Point on the element that is associated with the automation peer that responds to a mouse click.

(繼承來源 AutomationPeer)
GetClickablePointCore()

傳回 Point,表示與這個 UIElement3D 相關聯之 UIElement3DAutomationPeer 上的可按區域。Returns a Point that represents the clickable space that is on the UIElement3D that is associated with this UIElement3DAutomationPeer. 這個方法是由 GetClickablePoint() 所呼叫。This method is called by GetClickablePoint().

GetControlledPeers()

提供使用者介面自動化受此 AutomationPeer 影響或控制的項目清單。Provides UI Automation with a list of elements affected or controlled by this AutomationPeer.

(繼承來源 AutomationPeer)
GetControlledPeersCore()

在衍生類別中覆寫時,提供 UI 自動化及受此 AutomationPeer 影響或控制的元素清單。When overridden in a derived class, provides UI Automation with a list of elements affected or controlled by this AutomationPeer.

(繼承來源 AutomationPeer)
GetHashCode()

做為預設雜湊函式。Serves as the default hash function.

(繼承來源 Object)
GetHelpText()

取得文字,這個文字描述與自動化對等個體關聯之控制項的功能。Gets text that describes the functionality of the control that is associated with the automation peer.

(繼承來源 AutomationPeer)
GetHelpTextCore()

傳回字串,描述與這個 UIElement3D 相關聯之 UIElement3DAutomationPeer 的功能。Returns the string that describes the functionality of the UIElement3D that is associated with this UIElement3DAutomationPeer. 這個方法是由 GetHelpText() 所呼叫。This method is called by GetHelpText().

GetHostRawElementProviderCore()

告知消費者介面自動化在消費者介面自動化樹狀目錄中的哪個位置,以 hwnd Windows Presentation Foundation (WPF) 元素來放置所裝載的。Tells UI Automation where in the UI Automation tree to place the hwnd being hosted by a Windows Presentation Foundation (WPF) element.

(繼承來源 AutomationPeer)
GetItemStatus()

取得文字,這個文字表示與此自動化對等個體關聯之項目的視覺化狀態。Gets text that conveys the visual status of the element that is associated with this automation peer.

(繼承來源 AutomationPeer)
GetItemStatusCore()

傳回字串,表示與這個 UIElement3D 相關聯之 UIElement3DAutomationPeer 的狀態。Returns a string that communicates the status of the UIElement3D that is associated with this UIElement3DAutomationPeer. 這個方法是由 GetItemStatus() 所呼叫。This method is called by GetItemStatus().

GetItemType()

取得字串,這個字串描述物件所表示的項目類型。Gets a string that describes what kind of item an object represents.

(繼承來源 AutomationPeer)
GetItemTypeCore()

傳回人們可讀取的 (Human-Readable) 字串,表示這個 UIElement3DUIElement3DAutomationPeer 的項目型別。Returns a human-readable string that represents the item type that the UIElement3D for this UIElement3DAutomationPeer. 這個方法是由 GetItemType() 所呼叫。This method is called by GetItemType().

GetLabeledBy()

取得以該項目為目標之 LabelAutomationPeerGets the AutomationPeer for the Label that is targeted to the element.

(繼承來源 AutomationPeer)
GetLabeledByCore()

傳回項目的 AutomationPeer,這個項目是以這個 UIElement3DUIElement3DAutomationPeer 為目標。Returns the AutomationPeer for the element that targets the UIElement3D for this UIElement3DAutomationPeer. 這個方法是由 GetLabeledBy() 所呼叫。This method is called by GetLabeledBy().

GetLiveSetting()

取得與此 Automation Peer 建立關聯的即時區域通知特性。Gets the notification characteristics of a live region that is associated with this automation peer.

(繼承來源 AutomationPeer)
GetLiveSettingCore()

取得與此 UIElement3DAutomationPeer 建立關聯的 UIElement3D 物件即時區域通知特性。Gets the notification characteristics of the live region of the UIElement3D object that is associated with this UIElement3DAutomationPeer. 這個方法是由 GetLiveSetting() 所呼叫。This method is called by GetLiveSetting().

GetLiveSettingCore()

於衍生類別中覆寫時,傳回即時區域的通知特性。When overridden in a derived class, returns the notification characteristics of a live region. GetLiveSetting() 方法呼叫。Called by the GetLiveSetting() method.

(繼承來源 AutomationPeer)
GetLocalizedControlType()

取得人們可解讀的當地語系化字串,這個字串表示與這個自動化對等個體相關聯控制項的 AutomationControlType 值。Gets a human-readable localized string that represents the AutomationControlType value for the control that is associated with this automation peer.

(繼承來源 AutomationPeer)
GetLocalizedControlTypeCore()

在衍生類別中覆寫時,被 GetLocalizedControlType() 呼叫。When overridden in a derived class, is called by GetLocalizedControlType().

(繼承來源 AutomationPeer)
GetName()

取得文字,這個文字描述與此自動化對等個體關聯的項目。Gets text that describes the element that is associated with this automation peer.

(繼承來源 AutomationPeer)
GetNameCore()

傳回字串,表示與這個 UIElement3D 相關聯的 UIElement3DAutomationPeerReturns the string that represents the UIElement3D that is associated with this UIElement3DAutomationPeer. 這個方法是由 GetName() 所呼叫。This method is called by GetName().

GetOrientation()

取得值,這個值表示明確的控制項方向 (若有的話)。Gets a value that indicates the explicit control orientation, if any.

(繼承來源 AutomationPeer)
GetOrientationCore()

傳回與這個 UIElement3D 相關聯之 UIElement3DAutomationPeer 的方向。Returns the orientation of the UIElement3D that is associated with this UIElement3DAutomationPeer. 這個方法是由 GetOrientation() 所呼叫。This method is called by GetOrientation().

GetParent()

取得 AutomationPeer,它是這個 AutomationPeer 的父代。Gets the AutomationPeer that is the parent of this AutomationPeer.

(繼承來源 AutomationPeer)
GetPattern(PatternInterface)

傳回與這個 UIElement3DAutomationPeer 相關聯之 UIElement3D 的控制項模式。Returns the control pattern for the UIElement3D that is associated with this UIElement3DAutomationPeer.

GetPeerFromPoint(Point)

從指定之點取得 AutomationPeerGets an AutomationPeer from the specified point.

(繼承來源 AutomationPeer)
GetPeerFromPointCore(Point)

在衍生類別中覆寫時,從 GetPeerFromPoint(Point) 呼叫。When overridden in a derived class, is called from GetPeerFromPoint(Point).

(繼承來源 AutomationPeer)
GetPositionInSet()

嘗試取得 PositionInSet 屬性的值。Attempts to get the value of the PositionInSet property.

(繼承來源 AutomationPeer)
GetPositionInSetCore()

讀取 PositionInSetProperty 並傳回 PositionInSet 附加屬性的值。Reads PositionInSetProperty and returns the value of the PositionInSet attached property.

GetPositionInSetCore()

在衍生類別中覆寫時,提供使用者介面自動化描述此項目在群組或集合中佔用位置之以一為起始的整數值。When overridden in a derived class, provides UI Automation with a one-based integer value that describes the position this element occupies in a group or set.

(繼承來源 AutomationPeer)
GetSizeOfSet()

嘗試取得 SizeOfSet 屬性的值。Attempts to get the value of the SizeOfSet property.

(繼承來源 AutomationPeer)
GetSizeOfSetCore()

提供使用者介面自動化的 SizeOfSet 屬性值。Provides a value for UI Automation's SizeOfSet property.

GetSizeOfSetCore()

在衍生類別中覆寫時,提供 UI 自動化及此元素所屬群組或集合的大小。When overridden in a derived class, provides UI Automation with the size of the group or set that this element belongs to.

(繼承來源 AutomationPeer)
GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(繼承來源 Object)
HasKeyboardFocus()

取得值,這個值表示與這個自動化對等個體相關聯的項目目前是否有鍵盤焦點。Gets a value that indicates whether the element that is associated with this automation peer currently has keyboard focus.

(繼承來源 AutomationPeer)
HasKeyboardFocusCore()

傳回值,這個值表示與這個 UIElement3D 相關聯的 UIElement3DAutomationPeer 目前是否有鍵盤輸入焦點。Returns a value that indicates whether the UIElement3D that is associated with this UIElement3DAutomationPeer currently has keyboard input focus. 這個方法是由 HasKeyboardFocus() 所呼叫。This method is called by HasKeyboardFocus().

InvalidatePeer()

觸發重新計算 AutomationPeer 的主要屬性,並在屬性變更時引發對自動化用戶端的 PropertyChanged 通知。Triggers recalculation of the main properties of the AutomationPeer and raises the PropertyChanged notification to the Automation Client if the properties changed.

(繼承來源 AutomationPeer)
IsContentElement()

取得值,這個值表示與此 Automation Peer 相關聯的項目是否包含呈現給使用者的資料。Gets a value that indicates whether the element that is associated with this automation peer contains data that is presented to the user.

(繼承來源 AutomationPeer)
IsContentElementCore()

傳回值,這個值表示與這個 UIElement3D 相關聯的 UIElement3DAutomationPeer 是否為包含對使用者呈現之資料的項目。Returns a value that indicates whether the UIElement3D that is associated with this UIElement3DAutomationPeer is an element that contains data that is presented to the user. 這個方法是由 IsContentElement() 所呼叫。This method is called by IsContentElement().

IsControlElement()

取得值,這個值會指出使用者是否可將專案理解為互動,或在 GUI 中參與控制項的邏輯結構。Gets a value that indicates whether the element is understood by the user as interactive or as contributing to the logical structure of the control in the GUI.

(繼承來源 AutomationPeer)
IsControlElementCore()

傳回值,這個值表示與這個 UIElement3D 相關聯的 UIElement3DAutomationPeer 是否會由使用者辨識為互動式。Returns a value that indicates whether the UIElement3D that is associated with this UIElement3DAutomationPeer is understood by the end user as interactive. (選擇性)使用者可以瞭解在 UIElement3D GUI 中參與控制項的邏輯結構。Optionally, the user might understand the UIElement3D as contributing to the logical structure of the control in the GUI. 這個方法是由 IsControlElement() 所呼叫。This method is called by IsControlElement().

IsEnabled()

取得值,這個值表示與此自動化對等個體關聯的項目是否支援互動。Gets a value that indicates whether the element associated with this automation peer supports interaction.

(繼承來源 AutomationPeer)
IsEnabledCore()

傳回值,這個值表示與這個 UIElement3D 相關聯的 UIElement3DAutomationPeer 是否可以參與點擊測試 (Hit Testing) 或接受焦點。Returns a value that indicates whether the UIElement3D that is associated with this UIElement3DAutomationPeer can participate in hit testing or accept focus. 這個方法是由 IsKeyboardFocusable() 所呼叫。This method is called by IsKeyboardFocusable().

IsKeyboardFocusable()

取得值,這個值表示項目是否可以接受鍵盤焦點。Gets a value that indicates whether the element can accept keyboard focus.

(繼承來源 AutomationPeer)
IsKeyboardFocusableCore()

傳回值,這個值表示與這個 UIElement3D 相關聯的 UIElement3DAutomationPeer 是否可以接受鍵盤焦點。Returns a value that indicates whether the UIElement3D that is associated with this UIElement3DAutomationPeer can accept keyboard focus. 這個方法是由 IsKeyboardFocusable() 所呼叫。This method is called by IsKeyboardFocusable().

IsOffscreen()

取得值,這個值表示項目是否不在螢幕上。Gets a value that indicates whether an element is off the screen.

(繼承來源 AutomationPeer)
IsOffscreenCore()

傳回值,這個值表示與這個 UIElement3D 相關聯的 UIElement3DAutomationPeer 是否不在螢幕上。Returns a value that indicates whether the UIElement3D that is associated with this UIElement3DAutomationPeer is off the screen. 這個方法是由 IsOffscreen() 所呼叫。This method is called by IsOffscreen().

IsPassword()

取得值,這個值表示項目是否包含敏感性內容。Gets a value that indicates whether the element contains sensitive content.

(繼承來源 AutomationPeer)
IsPasswordCore()

傳回值,這個值表示與這個 UIElement3D 相關聯的 UIElement3DAutomationPeer 是否包含受保護的內容。Returns a value that indicates whether the UIElement3D that is associated with this UIElement3DAutomationPeer contains protected content. 這個方法是由 IsPassword() 所呼叫。This method is called by IsPassword().

IsRequiredForForm()

取得值,這個值表示與此對等個體關聯的項目在表單上是否為必填項。Gets a value that indicates whether the element that is associated with this peer must be completed on a form.

(繼承來源 AutomationPeer)
IsRequiredForFormCore()

傳回值,這個值表示與這個 UIElement3D 相關聯的 UIElement3DAutomationPeer 是否為表單上必須填寫的項目。Returns a value that indicates whether the UIElement3D that is associated with this UIElement3DAutomationPeer is required to be completed on a form. 這個方法是由 IsRequiredForForm() 所呼叫。This method is called by IsRequiredForForm().

MemberwiseClone()

建立目前 Object 的淺層複製。Creates a shallow copy of the current Object.

(繼承來源 Object)
PeerFromProvider(IRawElementProviderSimple)

取得指定之 AutomationPeer Proxy 的 IRawElementProviderSimpleGets an AutomationPeer for the specified IRawElementProviderSimple proxy.

(繼承來源 AutomationPeer)
ProviderFromPeer(AutomationPeer)

取得所指定之 IRawElementProviderSimpleAutomationPeerGets the IRawElementProviderSimple for the specified AutomationPeer.

(繼承來源 AutomationPeer)
RaiseAsyncContentLoadedEvent(AsyncContentLoadedEventArgs)

AutomationPeer 呼叫以引發 AsyncContentLoadedEvent 事件。Called by the AutomationPeer to raise the AsyncContentLoadedEvent event.

(繼承來源 AutomationPeer)
RaiseAutomationEvent(AutomationEvents)

引發自動化事件。Raises an automation event.

(繼承來源 AutomationPeer)
RaisePropertyChangedEvent(AutomationProperty, Object, Object)

引發事件,通知自動化用戶端已變更屬性值。Raises an event to notify the automation client of a changed property value.

(繼承來源 AutomationPeer)
ResetChildrenCache()

呼叫 GetChildrenCore(),以同步方式重設子項目的樹狀結構。Synchronously resets the tree of child elements by calling GetChildrenCore().

(繼承來源 AutomationPeer)
SetFocus()

對與此自動化對等個體關聯的項目設定鍵盤焦點。Sets the keyboard focus on the element that is associated with this automation peer.

(繼承來源 AutomationPeer)
SetFocusCore()

設定與這個 UIElement3DAutomationPeer 相關聯的 UIElement3D 上的鍵盤輸入焦點。Sets the keyboard input focus on the UIElement3D that is associated with this UIElement3DAutomationPeer. 這個方法是由 SetFocus() 所呼叫。This method is called by SetFocus().

ToString()

傳回代表目前物件的字串。Returns a string that represents the current object.

(繼承來源 Object)
VerifyAccess()

請強制執行可以存取這個 DispatcherObject 的呼叫執行緒。Enforces that the calling thread has access to this DispatcherObject.

(繼承來源 DispatcherObject)

適用於