IOleUndoUnit::D o メソッド (ocidl.h)

  • [アーティクル]

操作を実行するように元に戻す単位に指示します。 子の元に戻す単位が含まれている場合は、Do メソッドも呼び出す必要があることに注意してください。

構文

HRESULT Do(
  [in] IOleUndoManager *pUndoManager
);

パラメーター

[in] pUndoManager

元に戻すマネージャーへのポインター。 「IOleUndoManager」を参照してください。

戻り値

このメソッドは、成功したS_OKを返します。

注釈

元に戻すユニットは、その操作を実行する役割を担います。 独自の元に戻す操作を実行すると、元に戻すことができる別のアクションが発生します。 ただし、 pUndoManager が NULL の場合、元に戻す単位は元に戻す操作を実行する必要がありますが、やり直しスタックまたは元に戻すスタックに何も配置しないでください。

pUndoManager が NULL でない場合、対応するユニットをやり直しまたは元に戻すスタックに配置するには、ユニットが必要です。 その結果、このメソッドはそれ自体をやり直しまたは元に戻すスタックに移動するか、新しい元に戻す単位を作成して適切なスタックに追加します。 新しい元に戻す単位を作成した後、この元に戻すユニットは IOleUndoManager::Open または IOleUndoManager::Add を呼び出します。 元に戻すマネージャーは、現在の状態に応じて、元に戻すまたはやり直しスタックに新しい元に戻す単位を配置します。

親ユニットは、親に与えられたのと同じ元に戻すマネージャー ( NULL) を子に渡す必要があります。 pUndoManager が NULL の場合、コミットされていない限り、やり直しスタックまたは元に戻すスタックで親ユニットを開くのは許容されますが、必要ありません。 ブロックされた親ユニットは、子ユニットによってスタックに何も追加されないようにします。

この元に戻す単位が親単位の場合は、子に 対して Do メソッドを呼び出す前に、それ自体をやり直しまたは元に戻すスタックに配置する必要があります。

このメソッドを呼び出した後、元に戻すマネージャーは、元に戻す単位を解放する必要があります。

実装者へのメモ

元に戻す単位のエラー処理方法については、 IOleUndoManager インターフェイスを参照してください。 エラー処理戦略は、特に親ユニットの場合、このメソッドの実装に影響します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ocidl.h

こちらもご覧ください

IOleUndoManager::Add

IOleUndoManager::Open

IOleUndoUnit