FrameworkElementAutomationPeer.FromElement(UIElement) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
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。
傳回
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);
}
}
備註
FromElement 是協助程式類別，由自定義控件程式代碼用來傳回作用中的對等實例。 使用傳回的對等，您可以從引發一般控件邏輯事件或變更控件屬性的相同例程內引發自動化事件。 或者，您可以撰寫自己的協助程式方法，以執行這項操作，並從控件邏輯叫用。
CreatePeerForElement 基本上與 FromElement 的行為相同。
如果 FromElement 傳回 null，可能是因為您傳遞的項目沒有 OnCreateAutomationPeer 的實作。
即使 CreateAutomationPeer 系統邏輯因為某些原因尚未在 專案 目標上執行，FromElement 還是可以傳回對等。 它會在內部叫用相同的 CreateAutomationPeer 邏輯，以取得對等。