InvokePattern.Invoke Methode

Definition

Sendet eine Anforderung zum Aktivieren eines Steuerelements und Initiieren der einzelnen eindeutigen Aktion.Sends a request to activate a control and initiate its single, unambiguous action.

public:
 void Invoke();
public void Invoke ();
member this.Invoke : unit -> unit
Public Sub Invoke ()

Ausnahmen

Das Element unterstützt das InvokePattern-Steuerelementmuster nicht oder es ist ausgeblendet bzw. blockiert.The element does not support the InvokePattern control pattern or is hidden or blocked.

Das Element ist nicht aktiviert.The element is not enabled. Dies kann ausgelöst werden, wenn der Benutzeroberflächenautomatisierungs-Anbieter seine eigene Behandlung der IsEnabled-Eigenschaft implementiert hat.Can be raised when a UI Automation provider has implemented its own handling of the IsEnabled property.

Beispiele

Im folgenden Beispiel wird ein InvokePattern -Steuerelement Muster von einem-Steuerelement abgerufen, und die- Invoke Methode wird aufgerufen.In the following example an InvokePattern control pattern is obtained from a control and the Invoke method is called.

///--------------------------------------------------------------------
/// <summary>
/// Obtains an InvokePattern control pattern from a control
/// and calls the InvokePattern.Invoke() method on the control.
/// </summary>
/// <param name="targetControl">
/// The control of interest.
/// </param>
///--------------------------------------------------------------------
private void InvokeControl(AutomationElement targetControl)
{
    InvokePattern invokePattern = null;

    try
    {
        invokePattern =
            targetControl.GetCurrentPattern(InvokePattern.Pattern)
            as InvokePattern;
    }
    catch (ElementNotEnabledException)
    {
        // Object is not enabled
        return;
    }
    catch (InvalidOperationException)
    {
        // object doesn't support the InvokePattern control pattern
        return;
    }

    invokePattern.Invoke();
}
'''--------------------------------------------------------------------
''' <summary>
''' Obtains an InvokePattern control pattern from a control
''' and calls the InvokePattern.Invoke() method on the control.
''' </summary>
''' <param name="targetControl">
''' The control of interest.
''' </param>
'''--------------------------------------------------------------------
Private Sub InvokeControl(ByVal targetControl As AutomationElement) 
    Dim invokePattern As InvokePattern = Nothing
    
    Try
        invokePattern = _
        DirectCast(targetControl.GetCurrentPattern(invokePattern.Pattern), _
        InvokePattern)
    Catch e As ElementNotEnabledException
        ' Object is not enabled.
        Return
    Catch e As InvalidOperationException
        ' Object doesn't support the InvokePattern control pattern
        Return
    End Try
    
    invokePattern.Invoke()

End Sub

Hinweise

Aufrufe von Invoke sollten sofort ohne Blockierung zurückgegeben werden.Calls to Invoke should return immediately without blocking. Dieses Verhalten hängt jedoch vollständig von der Implementierung des Microsoft UI Automation-Anbieters ab.However, this behavior is entirely dependent on the Microsoft UI Automation provider implementation. In Szenarios, in denen Invoke das Aufrufen eines Blockierungs Problems (z. b. eines modalen Dialog Felds) ein Problem verursacht, ist möglicherweise ein separater Hilfsthread erforderlich,In scenarios where calling Invoke causes a blocking issue (such as a modal dialog) a separate helper thread may be required to call the method.

Gilt für: