UndoEngine Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
A tervezéskor általános visszavonási/újradátalakítási funkciót ad meg.
public ref class UndoEngine abstract : IDisposablepublic abstract class UndoEngine : IDisposabletype UndoEngine = class
interface IDisposablePublic MustInherit Class UndoEngine
Implements IDisposable- Öröklődés
-
UndoEngine
- Megvalósítás
Megjegyzések
Az UndoEngine absztrakt osztály a visszavonási funkciók alapértelmezett implementációját biztosítja a tervezéskor. A visszavonási egység a visszavonható munka egyetlen egységét jelöli. Ez az egység hozzáadódik egy veremhez, és a felhasználó ezután végigvezetheti a vermet az egyes műveletek visszavonásához. A visszavonási egységeket általában úgy tervezték, hogy váltson, ami azt jelenti, hogy a visszavonás meghívása kétszer visszaadja az alkalmazást a kezdő állapotba.
Az UndoEngine osztály a tervezőn belül futó objektumok alábbi jellemzőit használja ki:
A tervezőbetöltő minden érdekes objektumot megőrizhet valamilyen formátumban.
Minden objektum tulajdonságmódosítási értesítéseket küld egy tulajdonság módosításakor.
IDesignerHost a tranzakciók ötletét kínálja, amelyek felhasználhatók egy több kisebb műveletre kiterjedő visszavonási művelet létrehozásához.
Ezekkel a funkciókkal automatikusan létrehozhatja azokat a visszavonási egységeket, UndoEngine amelyekre szüksége van.
Note
Ne módosítsa közvetlenül a tulajdonságértékeket. Az UndoEngine osztály megköveteli, hogy a tulajdonságértékek módosításához a megfelelőt TypeDescriptor használja.
UndoEngine figyeli a visszavonási egységek létrehozásához szükséges változásértesítéseket, és maguk az egységek szerializált objektumállapotokból állnak. Az alábbi táblázat a létrehozáskor UndoEngine elérhető szolgáltatásokat mutatja be.
| Szolgáltatás | Leírás |
|---|---|
| ComponentSerializationService | A módosítás előtt és után menti egy összetevő tulajdonság- és objektumértékeit. |
| IComponentChangeService | Értesíti az összetevők módosításainak visszavonási motorját. |
| IDesignerHost | Tranzakciók nyomon követésére szolgál. |
Note
Mivel az UndoEngine osztály megköveteli ComponentSerializationService , és IComponentChangeServicecsak tervezéskor érhető el.
A visszavonási motor nyomon követi a tranzakciókat, és egyetlen visszavonási egységet hoz létre, amely magában foglal egy tranzakciót. Ennek eredményeképpen a visszavonási motor szabályozza a visszavonható műveletek időtartamát. Mivel a tranzakciók elnevezhetők, a visszavonható műveletek az aktuális tranzakciótól öröklik a nevüket. Ha nem érhető el tranzakció, és a rendszer módosítást jelent, a visszavonási motor létrehoz egy visszavonási nevet a módosítás típusa alapján (például "Szöveg módosítása" tulajdonság).
Konstruktorok
| Name | Description |
|---|---|
| UndoEngine(IServiceProvider) |
Inicializálja a UndoEngine osztály új példányát. |
Tulajdonságok
| Name | Description |
|---|---|
| Enabled |
Engedélyezi vagy letiltja a UndoEngine. |
| UndoInProgress |
Jelzi, hogy folyamatban van-e visszavonási művelet. |
Metódusok
| Name | Description |
|---|---|
| AddUndoUnit(UndoEngine+UndoUnit) |
Hozzáad egy UndoEngine.UndoUnit elemet a visszavonási veremhez. |
| CreateUndoUnit(String, Boolean) |
Létrehoz egy újat UndoEngine.UndoUnit. |
| DiscardUndoUnit(UndoEngine+UndoUnit) |
Elvet egy UndoEngine.UndoUnit. |
| Dispose() |
Felszabadítja a .-hez használt összes erőforrást UndoEngine. |
| Dispose(Boolean) |
Felszabadítja a felügyelt erőforrások által UndoEngine használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat. |
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetRequiredService(Type) |
Lekéri a kért szolgáltatást. |
| GetService(Type) |
Lekéri a kért szolgáltatást. |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| OnUndoing(EventArgs) |
Az eseményt emeli Undoing ki. |
| OnUndone(EventArgs) |
Az eseményt emeli Undone ki. |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |
esemény
| Name | Description |
|---|---|
| Undoing |
Közvetlenül a visszavonási művelet végrehajtása előtt következik be. |
| Undone |
A visszavonási művelet végrehajtása után azonnal megtörténik. |
