Метод IOleUndoManager::RedoTo (ocidl.h)
Указывает диспетчеру отмены вызывать действия отмены обратно через стек повтора вплоть до указанной единицы отмены.
Синтаксис
HRESULT RedoTo(
[in] IOleUndoUnit *pUU
);
Параметры
[in] pUU
Указатель IOleUndoUnit на единицу верхнего уровня для повтора. Если этот параметр имеет значение NULL, используется последняя добавленная единица верхнего уровня.
Возвращаемое значение
Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.
| Код возврата | Описание |
|---|---|
|
Указанная единица отмены не находится в стеке повтора. |
|
Попытка отмены и отката завершилась сбоем. Диспетчер отмены никогда не должен распространять E_ABORT, полученные из автономного блока отмены. Вместо этого он должен сопоставлять все E_ABORT значения, возвращаемые из других единиц отмены, с E_FAIL. |
|
Диспетчер отмены отключен. |
Комментарии
Этот метод вызывает метод IOleUndoUnit::D o для каждой единицы отмены верхнего уровня. Затем он освобождает этот блок отмены.
Обратите внимание, что указанная единица отмены должна быть единицей верхнего уровня, обычно извлекаемой через IOleUndoManager::EnumRedoable.
Если из блока отмены возвращается ошибка, диспетчер отмены должен попытаться откатить состояние документа, чтобы восстановить ее, выполнив действия в стеке отмены.
Независимо от успешности отката диспетчер отмены всегда должен очищать оба стека, прежде чем возвращать ошибку.
Если диспетчер отмены вызвал метод IOleUndoUnit::D o в нескольких единицах верхнего уровня, он должен откатить только ту единицу, которая вернула ошибку. Не следует откатывать единицы верхнего уровня, которые были выполнены успешно.
Диспетчер отмены также должен отслеживать, были ли добавлены единицы в противоположный стек, чтобы не пытаться выполнить откат, если ничего не было добавлено. Подробное описание обработки ошибок см. в интерфейсе IOleUndoManager .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | ocidl.h |