FrameworkElementAutomationPeer.FromElement(UIElement) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve FrameworkElementAutomationPeer para el uiElement especificado.
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 AutomationPeerParámetros
- element
- UIElement
UiElement asociado a este FrameworkElementAutomationPeer.
Devoluciones
FrameworkElementAutomationPeer o null si no se pudo crear FrameworkElementAutomationPeer.
Ejemplos
El diseño de compatibilidad de automatización no conserva un identificador para su propio sistema del mismo nivel como parte de cómo se implementa OnCreateAutomationPeer, ya que no hay ninguna garantía de cuándo se crea realmente el mismo nivel. En su lugar, puede comprobar si hay agentes de escucha de eventos de automatización en tiempo de ejecución dentro de las definiciones de clase de control Just-In-Time, con código similar al siguiente:
if (AutomationPeer.ListenerExists(AutomationEvents.PropertyChanged))
{
MyAutomationPeer peer =
FrameworkElementAutomationPeer.FromElement(myCtrl) as MyAutomationPeer;
if (peer != null)
{
peer.RaisePropertyChangedEvent(
RangeValuePatternIdentifiers.ValueProperty,
(double)oldValue,
(double)newValue);
}
}
Comentarios
FromElement es una clase auxiliar que usa el código de control personalizado para devolver la instancia del mismo nivel que actúa. Con el elemento del mismo nivel devuelto, puede desencadenar eventos de automatización desde las mismas rutinas que también activan los eventos lógicos de control general o las propiedades de control de cambios. O bien, puede escribir sus propios métodos auxiliares que lo hacen y se invocan desde la lógica de control.
CreatePeerForElement tiene básicamente el mismo comportamiento que FromElement.
Si FromElement devuelve null, es probable que el elemento que pasó no tenga una implementación para OnCreateAutomationPeer.
FromElement puede devolver el mismo nivel incluso si la lógica del sistema CreateAutomationPeer aún no se ha ejecutado en el destino del elemento por algún motivo. Invocará internamente la misma lógica CreateAutomationPeer para obtener el mismo nivel.