DesignSurface Kelas

Referensi

Definisi

Ruang nama:: System.ComponentModel.Design

Rakitan:: System.Design.dll

Rakitan:: System.Windows.Forms.Design.dll

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: Object
DesignSurface

Atribut: SecurityCriticalAttribute

Penerapan: IDisposable IServiceProvider

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.

Berlaku untuk