FrameworkElementAutomationPeer.FromElement(UIElement) 方法

定義

命名空間:

Windows.UI.Xaml.Automation.Peers

會傳回指定之 UIElement的FrameworkElementAutomationPeer。

public:
 static AutomationPeer ^ FromElement(UIElement ^ element);

 static AutomationPeer FromElement(UIElement const& element);

public static AutomationPeer FromElement(UIElement element);

function fromElement(element)

Public Shared Function FromElement (element As UIElement) As AutomationPeer

參數

element

UIElement

與此FrameworkElementAutomationPeer相關聯的UIElement。

傳回

AutomationPeer

FrameworkElementAutomationPeer，如果無法建立FrameworkElementAutomationPeer，則為 null。

範例

自動化支援設計不會在實作 OnCreateAutomationPeer的方式中保留您自己的對等控制碼，因為實際建立對等時沒有任何保證。 相反地，您可以使用如下所示的程式碼，檢查控制項類別定義 Just-In-Time 內的執行時間自動化事件接聽程式：

if (AutomationPeer.ListenerExists(AutomationEvents.PropertyChanged))
{
    MyAutomationPeer peer = 
        FrameworkElementAutomationPeer.FromElement(myCtrl) as MyAutomationPeer;

    if (peer != null)
    {
        peer.RaisePropertyChangedEvent(
            RangeValuePatternIdentifiers.ValueProperty,
            (double)oldValue,
            (double)newValue);
    }
}

If AutomationPeer.ListenerExists(AutomationEvents.PropertyChanged) Then
    Dim peer As MyDownAutomationPeer = _
    TryCast(FrameworkElementAutomationPeer.FromElement(myCtrl), MyAutomationPeer)
    If peer IsNot Nothing Then
        peer.RaisePropertyChangedEvent(RangeValuePatternIdentifiers.ValueProperty, CDbl(oldValue), CDbl(newValue))
    End If
End If

備註

FromElement 是協助程式類別，由自訂控制項程式碼用來傳回作用中的對等實例。 使用傳回的對等，您可以從相同的常式內引發自動化事件，同時引發一般控制項邏輯事件或變更控制項屬性。 或者，您可以撰寫自己的協助程式方法，以執行此動作並從控制項邏輯叫用。

CreatePeerForElement 基本上與 FromElement 的行為相同。

如果 FromElement 傳回 null，可能是因為您傳遞的元素沒有 OnCreateAutomationPeer的實作。

即使 CreateAutomationPeer 系統邏輯因某些原因尚未在 專案 目標上執行，FromElement 還是可以傳回對等。 它會在內部叫用相同的 CreateAutomationPeer 邏輯，以取得對等。

另請參閱

• CreatePeerForElement(UIElement)