Método IOleUndoUnit::D o (ocidl.h)

Indica a la unidad de deshacer que lleve a cabo su acción. Tenga en cuenta que si contiene unidades de deshacer secundarias, también debe llamar a sus métodos Do.

Sintaxis

HRESULT Do(
  [in] IOleUndoManager *pUndoManager
);

Parámetros

[in] pUndoManager

Puntero al administrador de deshacer. Vea IOleUndoManager.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente.

Comentarios

La unidad de deshacer es responsable de llevar a cabo su acción. La realización de su propia acción de deshacer da como resultado otra acción que puede revertirse. Sin embargo, si pUndoManager es NULL, la unidad de deshacer debe realizar su acción de deshacer, pero no debe intentar colocar nada en la pila de rehacer o deshacer.

Si pUndoManager no es NULL, se requiere que la unidad coloque una unidad correspondiente en la pila de rehacer o deshacer. Como resultado, este método se mueve a la pila rehacer o deshacer, o crea una nueva unidad de deshacer y la agrega a la pila adecuada. Después de crear una nueva unidad de deshacer, esta unidad de deshacer llama a IOleUndoManager::Open o IOleUndoManager::Add. El administrador de deshacer colocará la nueva unidad de deshacer en la pila de deshacer o rehacer en función de su estado actual.

Una unidad primaria debe pasar a sus elementos secundarios el mismo administrador de deshacer, posiblemente NULL, que se ha dado al elemento primario. Se permite, pero no es necesario, cuando pUndoManager es NULL para abrir una unidad primaria en la pila de rehacer o deshacer siempre que no se confirme. Una unidad primaria bloqueada garantiza que no se agregue nada a la pila por unidades secundarias.

Si esta unidad de deshacer es una unidad primaria, debe colocarse en la pila de rehacer o deshacer antes de llamar al método Do en sus elementos secundarios.

Después de llamar a este método, el administrador de deshacer debe liberar la unidad de deshacer.

Notas para los implementadores

Consulte la interfaz IOleUndoManager para ver las estrategias de control de errores para las unidades de deshacer. La estrategia de control de errores afecta a la implementación de este método, especialmente para las unidades primarias.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ocidl.h

Consulte también

IOleUndoManager::Add

IOleUndoManager::Open

IOleUndoUnit