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 fungsi urungkan pada waktu desain. Unit undo mewakili satu unit pekerjaan yang tidak dapat diurungkan. Unit ini ditambahkan ke tumpukan dan pengguna kemudian dapat berjalan di tumpukan untuk membatalkan setiap tindakan. Unit urungkan biasanya dirancang untuk beralih, yang berarti bahwa memanggil urungkan dua kali mengembalikan aplikasi ke status awalnya.
Kelas 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 ide transaksi, yang dapat digunakan untuk membuat tindakan batalkan yang mencakup beberapa tindakan yang lebih kecil.
Dengan fitur-fitur ini, UndoEngine dapat membuat unit urungkan yang dibutuhkan secara otomatis.
Catatan
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. |
Catatan
UndoEngine Karena kelas membutuhkan ComponentSerializationService dan IComponentChangeService, kelas hanya tersedia pada waktu desain.
Mesin urungkan melacak transaksi dan membuat satu unit batalkan yang mencakup transaksi. Akibatnya, mesin undo memiliki kontrol atas durasi tindakan yang tidak dapat diurungkan. Selain itu, karena transaksi dapat diberi nama, tindakan yang tidak dapat diurungkan mewarisi nama mereka dari transaksi saat ini. Jika tidak ada transaksi yang tersedia dan perubahan dilaporkan, mesin urungkan membuat nama urungkan berdasarkan jenis perubahan (misalnya, "Ubah properti 'Teks'").
Konstruktor
UndoEngine(IServiceProvider) |
Menginisialisasi instans baru kelas UndoEngine. |
Properti
Enabled |
Mengaktifkan atau menonaktifkan UndoEngine. |
UndoInProgress |
Menunjukkan apakah tindakan batalkan sedang berlangsung. |
Metode
AddUndoUnit(UndoEngine+UndoUnit) |
UndoEngine.UndoUnit Menambahkan ke tumpukan urungkan. |
CreateUndoUnit(String, Boolean) |
Membuat baru UndoEngine.UndoUnit. |
DiscardUndoUnit(UndoEngine+UndoUnit) |
Membuang UndoEngine.UndoUnit. |
Dispose() |
Merilis semua sumber daya yang UndoEnginedigunakan oleh . |
Dispose(Boolean) |
Merilis sumber daya tidak terkelola yang digunakan oleh UndoEngine 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 dari instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
OnUndoing(EventArgs) |
Memunculkan kejadian Undoing. |
OnUndone(EventArgs) |
Memunculkan kejadian Undone. |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Acara
Undoing |
Terjadi segera sebelum tindakan batalkan dilakukan. |
Undone |
Terjadi segera setelah tindakan batalkan dilakukan. |