Interface IOleUndoUnit (ocidl.h)

  • Artigo

Serve como a interface main em uma unidade desfazer. Uma unidade de desfazer encapsula as informações necessárias para desfazer ou refazer uma única ação.

Quando o estado de um objeto é alterado e precisa criar uma unidade de desfazer, primeiro ele precisa saber quais unidades pai estão abertas. Ele chama o método IOleUndoManager::GetOpenParentState para determinar isso. Se a chamada retornar S_FALSE, não haverá nenhum pai habilitado. Se a chamada retornar S_OK mas o sinalizador UAS_NOPARENTENABLE estiver definido, o pai aberto será um pai desabilitando. Em qualquer um desses casos, o objeto chama IOleUndoManager::D iscardFrom(NULL) no gerenciador de desfazer e ignora a criação da unidade de desfazer.

Se o método retornar S_OK, mas o sinalizador UAS_BLOCKED estiver definido, o pai aberto será um pai de bloqueio. O objeto não precisa criar uma unidade de desfazer, pois ela seria imediatamente descartada. Se o valor retornado for S_OK e nenhum dos sinalizadores de bits estiver definido, o objeto criará a unidade de desfazer e chamará IOleUndoManager::Add no gerenciador de desfazer.

O objeto deve manter um ponteiro para o gerenciador de desfazer.

Herança

A interface IOleUndoUnit herda da interface IUnknown . O IOleUndoUnit também tem estes tipos de membros:

Métodos

A interface IOleUndoUnit tem esses métodos.

 
IOleUndoUnit::D o

Instrui a unidade de desfazer a executar sua ação. Observe que, se ele contiver unidades de desfazer filho, ele também deverá chamar seus métodos Do.
IOleUndoUnit::GetDescription

Recupera uma descrição da unidade de desfazer que pode ser usada na interface do usuário desfazer ou refazer.
IOleUndoUnit::GetUnitType

Recupera o CLSID e um identificador de tipo para a unidade de desfazer.
IOleUndoUnit::OnNextAdd

Notifica a última unidade de desfazer na coleção de que uma nova unidade foi adicionada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ocidl.h

Confira também

IOleParentUndoUnit

IOleUndoManager