UndoEngine Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica la funcionalidad genérica para deshacer/rehacer en tiempo de diseño.
public ref class UndoEngine abstract : IDisposablepublic abstract class UndoEngine : IDisposabletype UndoEngine = class
interface IDisposablePublic MustInherit Class UndoEngine
Implements IDisposable- Herencia
-
UndoEngine
- Implementaciones
Comentarios
La UndoEngine clase abstracta proporciona una implementación predeterminada de la funcionalidad de deshacer en tiempo de diseño. Una unidad de deshacer representa una sola unidad de trabajo que se puede deshacer. Esta unidad se agrega a una pila y el usuario puede recorrer la pila para deshacer cada acción. Normalmente, las unidades de deshacer están diseñadas para alternar, lo que significa que llamar a deshacer dos veces devuelve la aplicación a su estado inicial.
La UndoEngine clase aprovecha las siguientes características de los objetos que se ejecutan en el diseñador:
El cargador del diseñador puede conservar todos los objetos interesantes en algún formato.
Todos los objetos generan notificaciones de cambio de propiedad cuando se cambia una propiedad.
IDesignerHost ofrece la idea de las transacciones, que se pueden usar para fabricar una acción de deshacer que abarca varias acciones más pequeñas.
Con estas características, UndoEngine puede fabricar cualquier unidad de deshacer que necesite automáticamente.
Nota
No cambie los valores de propiedad directamente. La UndoEngine clase requiere que use el adecuado TypeDescriptor para cambiar los valores de propiedad.
UndoEngine supervisa las notificaciones de cambio para crear unidades de deshacer y las propias unidades constan de estados de objeto serializados. En la tabla siguiente se muestran los servicios que deben estar disponibles cuando UndoEngine se crean.
| Servicio | Descripción |
|---|---|
| ComponentSerializationService | Guarda los valores de propiedad y objeto de un componente antes y después de realizar un cambio. |
| IComponentChangeService | Notifica al motor de deshacer los cambios realizados en los componentes. |
| IDesignerHost | Se usa para realizar un seguimiento de las transacciones. |
Nota
Dado que la UndoEngine clase requiere ComponentSerializationService y IComponentChangeService, solo está disponible en tiempo de diseño.
El motor de deshacer realiza un seguimiento de las transacciones y crea una sola unidad de deshacer que abarca una transacción. Como resultado, el motor de deshacer tiene control sobre la duración de una acción que se puede deshacer. Además, dado que las transacciones se pueden denominar, las acciones que se pueden deshacer heredan sus nombres de la transacción actual. Si no hay ninguna transacción disponible y se notifica un cambio, el motor de deshacer crea un nombre de deshacer basado en el tipo de cambio (por ejemplo, "Cambiar propiedad 'Text'").
Constructores
| UndoEngine(IServiceProvider) |
Inicializa una nueva instancia de la clase UndoEngine. |
Propiedades
| Enabled |
Habilita o deshabilita el objeto UndoEngine. |
| UndoInProgress |
Indica si está en curso una acción de deshacer. |
Métodos
| AddUndoUnit(UndoEngine+UndoUnit) |
Agrega un objeto UndoEngine.UndoUnit a la pila para deshacer. |
| CreateUndoUnit(String, Boolean) |
Crea un nuevo UndoEngine.UndoUnit. |
| DiscardUndoUnit(UndoEngine+UndoUnit) |
Descarta un objeto UndoEngine.UndoUnit. |
| Dispose() |
Libera todos los recursos que usa UndoEngine. |
| Dispose(Boolean) |
Libera los recursos no administrados que usa UndoEngine y, de forma opcional, libera los recursos administrados. |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetRequiredService(Type) |
Obtiene el servicio solicitado. |
| GetService(Type) |
Obtiene el servicio solicitado. |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| OnUndoing(EventArgs) |
Genera el evento Undoing. |
| OnUndone(EventArgs) |
Genera el evento Undone. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Eventos
| Undoing |
Se produce inmediatamente antes de que se realice una acción de deshacer. |
| Undone |
Se produce inmediatamente después de que se realice una acción de deshacer. |
