InvokePattern.Invoke メソッド

  • リファレンス

定義

名前空間:
System.Windows.Automation
アセンブリ:
UIAutomationClient.dll

要求を送信してコントロールをアクティブ化し、その 1 つの明確なアクションを開始します。

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

例外

InvalidOperationException

要素が InvokePattern コントロール パターンをサポートしていないか、非表示またはブロックされています。

ElementNotEnabledException

この要素は有効ではありません。 UI オートメーション プロバイダーが IsEnabled プロパティの独自の処理を実装した場合に発生する可能性があります。

例

次の例では、 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 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

注釈

を Invoke 呼び出す場合は、ブロックせずにすぐにが返されます。 ただし、この動作は、Microsoft UI オートメーション プロバイダーの実装に完全に依存します。 を呼び出すと Invoke ブロックの問題 (モーダル ダイアログなど) が発生するシナリオでは、 メソッドを呼び出すために別のヘルパー スレッドが必要になる場合があります。

適用対象

こちらもご覧ください