Macros.Pause メソッド

[アーティクル]
08/09/2011

現在記録中のマクロにコードが書き込まれないように、マクロレコーダーを一時停止します。このメソッドはマクロから使用しないでください。

名前空間: EnvDTE
アセンブリ: EnvDTE (EnvDTE.dll 内)

構文

'宣言
Sub Pause

void Pause()

void Pause()

abstract Pause : unit -> unit

function Pause()

解説

あるマクロコマンドでタスクを実行するために他のマクロコマンドを起動する場合、呼び出されたコマンドをマクロに記録する必要がないときは、Pause を使用すると便利です。この場合、呼び出し側のコマンドがコマンドの動作全体を取り込むコードを生成します。

一時停止後にマクロ記録を再開するには、Resume を使用します。 Pause は、アドインからのみ使用します。

マクロ記録モードでないときに、アドインで Pause メソッドを呼び出すと、メソッドでは何の処理も行われませんが、エラーは発生しません。

例

public void CodeExample(DTE2 dte, AddIn addin)
{
    // INSTRUCTIONS: Run this code, open a solution, start
    // recording a macro, then connect the add-in containing this code.
    try
    {
        Macros mac = dte.Macros;
        if (mac.IsRecording)
        {
            mac.Pause();
            if (!mac.IsRecording)
                mac.Resume();
            mac.EmitMacroCode("rem Code added by the EmitMacroCode method");
            // Demonstrate these two properties return the same reference.
            bool test = mac.DTE.Equals(mac.Parent);
            if (test) MessageBox.Show("The DTE and Parent property refer to the same object.");
            else MessageBox.Show("The DTE and Parent property do not refer to the same object.");
        }
        else MessageBox.Show("Start a macro recording session and reconnect addin");
    }
    catch(Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}