Share via


InvokePattern.Invoke メソッド

定義

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

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

例外

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

この要素は有効ではありません。 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 によってブロックの問題が発生するシナリオ (モーダル ダイアログなど) では、メソッドを呼び出すために別のヘルパー スレッドが必要になる場合があります。

適用対象

こちらもご覧ください