Bagikan melalui


DesignSurface Kelas

Definisi

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.

Berlaku untuk

Lihat juga