UndoEngine Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menentukan fungsionalitas batalkan/ulangi generik pada waktu desain.
public ref class UndoEngine abstract : IDisposable
public abstract class UndoEngine : IDisposable
type UndoEngine = class
interface IDisposable
Public MustInherit Class UndoEngine
Implements IDisposable
- Warisan
-
UndoEngine
- Penerapan
Keterangan
Kelas UndoEngine abstrak menyediakan implementasi default fungsionalitas batalkan pada waktu desain. Unit urungkan mewakili satu unit pekerjaan yang tidak dapat diurungkan. Unit ini ditambahkan ke tumpukan dan pengguna kemudian dapat berjalan di tumpukan untuk mengurungkan setiap tindakan. Unit urungkan biasanya dirancang untuk beralih, yang berarti bahwa membatalkan dua kali mengembalikan aplikasi ke status awalnya.
Kelas ini UndoEngine memanfaatkan karakteristik objek berikut yang berjalan dalam perancang:
Semua objek menarik dapat dipertahankan ke beberapa format oleh pemuat perancang.
Semua objek menaikkan pemberitahuan perubahan properti saat properti diubah.
IDesignerHost menawarkan gagasan transaksi, yang dapat digunakan untuk mengarang tindakan urungkan yang mencakup beberapa tindakan yang lebih kecil.
Dengan fitur-fitur ini, UndoEngine dapat mengarang unit urungkan apa pun yang dibutuhkan secara otomatis.
Note
Jangan mengubah nilai properti secara langsung. Kelas UndoEngine mengharuskan Anda menggunakan yang sesuai TypeDescriptor untuk mengubah nilai properti.
UndoEngine memantau pemberitahuan perubahan untuk membuat unit urungkan, dan unit itu sendiri terdiri dari status objek berseri. Tabel berikut ini memperlihatkan layanan yang harus tersedia saat UndoEngine dibuat.
| Layanan | Deskripsi |
|---|---|
| ComponentSerializationService | Menyimpan nilai properti dan objek untuk komponen sebelum dan sesudah perubahan dilakukan. |
| IComponentChangeService | Memberi tahu mesin urungkan perubahan yang dilakukan pada komponen. |
| IDesignerHost | Digunakan untuk melacak transaksi. |
Note
UndoEngine Karena kelas memerlukan ComponentSerializationService dan IComponentChangeService, kelas hanya tersedia pada waktu desain.
Mesin batalkan melacak transaksi dan membuat satu unit urungkan yang mencakup transaksi. Akibatnya, mesin batalkan memiliki kontrol atas durasi tindakan yang tidak dapat diurungkan. Selain itu, karena transaksi dapat diberi nama, tindakan yang tidak dapat dibatalkan mewarisi namanya dari transaksi saat ini. Jika tidak ada transaksi yang tersedia dan perubahan dilaporkan, mesin batalkan membuat nama urungkan berdasarkan jenis perubahan (misalnya, "Ubah properti 'Teks'").
Konstruktor
| Nama | Deskripsi |
|---|---|
| UndoEngine(IServiceProvider) |
Menginisialisasi instans baru dari kelas UndoEngine. |
Properti
| Nama | Deskripsi |
|---|---|
| Enabled |
Mengaktifkan atau menonaktifkan UndoEngine. |
| UndoInProgress |
Menunjukkan apakah tindakan batalkan sedang berlangsung. |
Metode
| Nama | Deskripsi |
|---|---|
| AddUndoUnit(UndoEngine+UndoUnit) |
UndoEngine.UndoUnit Menambahkan ke tumpukan urungkan. |
| CreateUndoUnit(String, Boolean) |
Membuat baru UndoEngine.UndoUnit. |
| DiscardUndoUnit(UndoEngine+UndoUnit) |
UndoEngine.UndoUnitMembuang . |
| Dispose() |
Merilis semua sumber daya yang digunakan oleh UndoEngine. |
| Dispose(Boolean) |
Merilis sumber daya yang tidak dikelola yang UndoEngine digunakan oleh dan secara opsional merilis sumber daya terkelola. |
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetRequiredService(Type) |
Mendapatkan layanan yang diminta. |
| GetService(Type) |
Mendapatkan layanan yang diminta. |
| GetType() |
Mendapatkan Type instans saat ini. (Diperoleh dari Object) |
| MemberwiseClone() |
Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object) |
| OnUndoing(EventArgs) |
Menaikkan peristiwa Undoing. |
| OnUndone(EventArgs) |
Menaikkan peristiwa Undone. |
| ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Acara
| Nama | Deskripsi |
|---|---|
| Undoing |
Terjadi segera sebelum tindakan batalkan dilakukan. |
| Undone |
Terjadi segera setelah tindakan batalkan dilakukan. |