DesignSurface 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.
Menyajikan antarmuka pengguna untuk merancang komponen.
public ref class DesignSurface : IDisposable, IServiceProvider
public class DesignSurface : IDisposable, IServiceProvider
[System.Security.SecurityCritical]
public class DesignSurface : IDisposable, IServiceProvider
type DesignSurface = class
interface IDisposable
interface IServiceProvider
[<System.Security.SecurityCritical>]
type DesignSurface = class
interface IDisposable
interface IServiceProvider
Public Class DesignSurface
Implements IDisposable, IServiceProvider
- Warisan
-
DesignSurface
- Atribut
- Penerapan
Keterangan
Kelas DesignSurface mengimplementasikan apa yang dirasakan pengguna sebagai perancang. DesignSurface adalah antarmuka pengguna yang dimanipulasi pengguna untuk mengubah fitur waktu desain. DesignSurface menyediakan permukaan desain yang sepenuhnya mandiri.
Kelas DesignSurface dapat digunakan sebagai perancang yang berdiri sendiri, atau dapat digabungkan dengan DesignSurfaceManager kelas untuk menyediakan implementasi umum untuk aplikasi yang menghosting beberapa DesignSurface objek.
Kelas DesignSurface dapat digunakan dengan sendirinya, atau pengguna dapat memperoleh kelas baru darinya dan menambah perilaku.
Kelas ini DesignSurface menyediakan beberapa layanan waktu desain secara otomatis. Kelas DesignSurface menambahkan semua layanannya dalam konstruktornya. Sebagian besar layanan ini dapat ditimpa dengan menggantinya di properti yang dilindungi ServiceContainer . Untuk mengganti layanan, ganti konstruktor, basis panggilan, dan buat perubahan apa pun melalui properti yang dilindungi ServiceContainer . Semua layanan yang ditambahkan ke kontainer layanan dan yang menerapkan IDisposable dibuang ketika permukaan desain dibuang. Kumpulan default layanan yang dapat diganti yang DesignSurface disediakan kelas diperlihatkan dalam tabel berikut.
Layanan | Deskripsi |
---|---|
IExtenderProviderService | Memungkinkan objek yang bukan bagian dari koleksi komponen kontainer untuk menyediakan penyedia extender mereka sendiri. |
IExtenderListService | Digunakan oleh TypeDescriptor untuk mendapatkan daftar penyedia extender. Dengan layanan ini, penyedia extender dapat tinggal di luar kontainer. |
ITypeDescriptorFilterService | Menyediakan kait metadata perancang. Ini adalah antarmuka utama untuk pemfilteran metadata. |
ISelectionService | Menyediakan cara untuk memilih komponen dalam perancang. |
IReferenceService | Menyediakan cara untuk mendapatkan nama untuk objek, bahkan ketika objek tersebut tidak disiapkan. |
DesignSurface | Menawarkan permukaan desain itu sendiri sebagai layanan. |
DesignerOptionService | Menyediakan kelas dasar untuk mendapatkan dan mengatur nilai opsi untuk perancang. |
Tabel berikut ini memperlihatkan layanan yang tidak dapat diganti yang disediakan secara default.
Layanan | Deskripsi |
---|---|
IComponentChangeService | Menaikkan peristiwa saat perubahan dilakukan pada komponen. |
IDesignerHost | Mengontrol akses ke jenis, layanan, dan transaksi. Antarmuka utama untuk desainer. |
IContainer | Memiliki sekumpulan komponen yang sedang dirancang. Setiap desainer memiliki yang memiliki IContainer komponen. |
IServiceContainer | Berasal dari IServiceProvider dan menyediakan cara untuk menambahkan dan menghapus layanan dari perancang. |
Selain layanan ini, DesignSurface kelas ini juga menyediakan satu layanan yang tersedia melalui situs komponen. Layanan ini unik untuk setiap komponen. Tabel berikut ini memperlihatkan layanan yang tidak dapat diganti.
Layanan | Deskripsi |
---|---|
IDictionaryService | Kamus generik pasangan kunci/nilai yang dapat digunakan untuk menyimpan data arbitrer tentang komponen. |
INestedContainer | Kontainer yang memungkinkan komponen untuk menambahkan komponen anak tambahan ke perancang. Komponen-komponen ini akan menjadi bagian dari permukaan desain, tetapi tidak akan berpartisipasi dalam serialisasi. Ini berguna ketika Anda ingin merancang kontrol yang mampu mengekspos wilayah dirinya sendiri dalam perancang, tetapi Anda tidak ingin wilayah tersebut berpartisipasi dalam serialisasi. |
Selain ISite, situs ini juga mengimplementasikan antarmuka berikut.
Perhatian
Periksa keberadaan antarmuka ini, daripada menggunakan transmisi yang tidak pandang bulu, karena implementasi situs lain mungkin tidak mengimplementasikannya.
Layanan | Deskripsi |
---|---|
IServiceContainer | Menyediakan cara untuk masuk ke kontainer layanan khusus situs. Misalnya, IDictionaryService adalah layanan khusus situs. Dengan layanan ini, Anda dapat menambahkan layanan khusus situs tambahan. |
Konstruktor
DesignSurface() |
Menginisialisasi instans baru kelas DesignSurface. |
DesignSurface(IServiceProvider) |
Menginisialisasi instans baru kelas DesignSurface. |
DesignSurface(IServiceProvider, Type) |
Menginisialisasi instans baru kelas DesignSurface. |
DesignSurface(Type) |
Menginisialisasi instans baru kelas DesignSurface. |
Properti
ComponentContainer |
IContainer Mendapatkan implementasi dalam permukaan desain. |
DtelLoading |
Mendapatkan nilai yang menunjukkan apakah Daftar Kesalahan Waktu Desain sedang dimuat. |
IsLoaded |
Mendapatkan nilai yang menunjukkan apakah permukaan desain saat ini dimuat. |
LoadErrors |
Mengembalikan kumpulan kesalahan pemuatan atau kumpulan yang batal. |
ServiceContainer |
Mendapatkan kontainer layanan. |
View |
Mendapatkan tampilan untuk perancang akar. |
Metode
BeginLoad(DesignerLoader) |
Memulai proses pemuatan dengan pemuat perancang yang diberikan. |
BeginLoad(Type) |
Memulai proses pemuatan. |
CreateComponent(Type) |
Kedaluwarsa.
Membuat instans komponen. |
CreateDesigner(IComponent, Boolean) |
Membuat perancang saat komponen ditambahkan ke kontainer. |
CreateInstance(Type) |
Membuat instans dari jenis yang diberikan. |
CreateNestedContainer(IComponent) |
Membuat kontainer yang cocok untuk kontrol atau komponen berlapis. |
CreateNestedContainer(IComponent, String) |
Membuat kontainer yang cocok untuk kontrol atau komponen berlapis. |
Dispose() |
Merilis sumber daya yang digunakan oleh DesignSurface. |
Dispose(Boolean) |
Merilis sumber daya yang digunakan oleh DesignSurface. |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
Flush() |
Menserialisasikan perubahan pada permukaan desain. |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetService(Type) |
Mendapatkan layanan dari kontainer layanan. |
GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
OnLoaded(LoadedEventArgs) |
Memunculkan kejadian Loaded. |
OnLoading(EventArgs) |
Memunculkan kejadian Loading. |
OnUnloaded(EventArgs) |
Memunculkan kejadian Unloaded. |
OnUnloading(EventArgs) |
Memunculkan kejadian Unloading. |
OnViewActivate(EventArgs) |
Memunculkan kejadian ViewActivated. |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Acara
Disposed |
Terjadi ketika permukaan desain dibuang. |
Flushed |
Terjadi ketika panggilan dilakukan ke Flush() metode DesignSurface. |
Loaded |
Terjadi ketika beban perancang telah selesai. |
Loading |
Terjadi ketika desainer akan dimuat. |
Unloaded |
Terjadi ketika perancang telah selesai membongkar. |
Unloading |
Terjadi ketika perancang akan membongkar. |
ViewActivated |
Terjadi ketika Activate() metode telah dipanggil pada IDesignerHost. |