ContainerControlDesigner 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.
Menyediakan fungsionalitas perancang untuk kontrol yang berisi kontrol turunan atau properti yang dapat dimodifikasi pada waktu desain.
public ref class ContainerControlDesigner : System::Web::UI::Design::ControlDesignerpublic class ContainerControlDesigner : System.Web.UI.Design.ControlDesignertype ContainerControlDesigner = class
inherit ControlDesignerPublic Class ContainerControlDesigner
Inherits ControlDesigner- Warisan
- Turunan
Contoh
Contoh kode berikut menunjukkan cara mendapatkan kelas perancang ContainerControlDesigner dari kelas . Contohnya mendefinisikan kontrol sederhana yang berasal dari CompositeControl kelas , lalu mendefinisikan perancang terkait, yang berasal dari ContainerControlDesigner kelas . Kelas perancang turunan mengambil alih FrameCaption properti dan FrameStyle untuk menyesuaikan bingkai yang berada di sekitar wilayah kontrol yang dapat diedit pada permukaan desain.
using System;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Drawing;
using System.Web.UI;
using System.Web.UI.Design;
using System.Web.UI.Design.WebControls;
using System.Web.UI.WebControls;
namespace ControlDesignerSamples.CS
{
// Define a simple composite control, derived from the
// System.Web.UI.WebControls.CompositeControl class.
[
Designer(typeof(SimpleContainerControlDesigner)) ,
ParseChildren(false)
]
public class SimpleContainerControl : CompositeControl
{
}
// Define the designer for the simple composite control.
// The designer derives from System.Web.UI.Design.ContainerControlDesigner.
// The designer defines the style and caption for frame around the
// editable region in the design surface.
public class SimpleContainerControlDesigner : ContainerControlDesigner
{
private Style _style = null;
// Define the caption text for the frame in the design surface.
public override string FrameCaption
{
get
{
return "= My simple container control =";
}
}
// Define the style of the frame around the control in the design surface.
public override Style FrameStyle
{
get
{
if (_style == null)
{
_style = new Style();
_style.Font.Name = "Verdana";
_style.Font.Size = new FontUnit("XSmall");
_style.BackColor = Color.LavenderBlush;
_style.ForeColor = Color.DarkBlue;
}
return _style;
}
}
}
}
Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.Collections
Imports System.Drawing
Imports System.Web.UI
Imports System.Web.UI.Design
Imports System.Web.UI.Design.WebControls
Imports System.Web.UI.WebControls
Namespace ControlDesignerSamples.VB
' Define a simple composite control, derived from the
' System.Web.UI.WebControls.CompositeControl class.
<Designer(GetType(SimpleContainerControlDesigner)), _
ParseChildren(False)> _
Public Class SimpleContainerControl
Inherits CompositeControl
End Class
' Define the designer for the simple composite control.
' The designer derives from System.Web.UI.Design.ContainerControlDesigner.
' The designer defines the style and caption for the frame around the
' editable region of the control in the design surface.
Public Class SimpleContainerControlDesigner
Inherits ContainerControlDesigner
Private _style As Style = Nothing
' Define the caption text for the frame in the design surface.
Public Overrides ReadOnly Property FrameCaption() As String
Get
Return "- My simple container control -"
End Get
End Property
' Define the style of the frame around the control in the design surface.
Public Overrides ReadOnly Property FrameStyle() As Style
Get
If _style Is Nothing Then
_style = New Style()
_style.Font.Name = "Verdana"
_style.Font.Size = New FontUnit("XSmall")
_style.BackColor = Color.LavenderBlush
_style.ForeColor = Color.DarkBlue
End If
Return _style
End Get
End Property
End Class
End Namespace
Keterangan
Kelas ini ContainerControlDesigner menyediakan kelas perancang dasar untuk kontrol yang dapat dimodifikasi pada permukaan desain. Ini termasuk kontrol yang berisi kontrol anak atau properti dalam yang dapat diedit. ContainerControlDesigner menyediakan satu wilayah berbingkai untuk mewakili kontrol, dan secara otomatis menangani penyajian kontrol pada waktu desain.
Terapkan ParseChildrenAttribute atribut pada kontrol terkait untuk menentukan perilaku waktu desain .ContainerControlDesigner Terapkan ParseChildrenAttribute pengaturan pada kontrol terkait sebagai berikut:
falseuntuk menunjukkan bahwa ContainerControlDesigner mewakili konten wilayah desain yang dapat diedit sebagai kontrol anak.trueuntuk menunjukkan bahwa ContainerControlDesigner mewakili konten wilayah desain yang dapat diedit sebagai properti dalam kontrol yang dapat diedit.
Pengembang kontrol dapat memperoleh dan memperluas perancang kustom dari salah satu dari beberapa perancang dasar tergantung pada jenis kontrol yang sedang dikembangkan, seperti yang didefinisikan dalam daftar berikut:
Kontrol yang memungkinkan kontrol anak ditambahkan ke dalamnya pada waktu desain dapat berasal dari ContainerControlDesigner kelas . Misalnya, PanelContainerDesigner kelas berasal dari ContainerControlDesigner kelas dan mewakili Panel kontrol pada permukaan desain.
Kontrol yang memiliki satu atau beberapa kontrol anak, dan mungkin juga memiliki wilayah perancang yang dapat diedit di mana kontrol dapat ditambahkan pada waktu desain, dapat berasal dari CompositeControlDesigner kelas .
Kontrol yang memerlukan pemrosesan waktu desain kustom dapat berasal dari kelas dasar ControlDesigner .
Catatan
Kelas ContainerControlDesigner menggantikan kelas usang ReadWriteControlDesigner .
DesignerAttribute Gunakan atribut untuk mengaitkan kelas perancang kustom bersama dengan implementasi kontrol kustom. Untuk informasi mendetail tentang cara menggunakan perancang kontrol dengan kontrol kustom, lihat Panduan: Membuat Perancang Kontrol Dasar untuk Kontrol Server Web.
Konstruktor
| ContainerControlDesigner() |
Menginisialisasi instans baru kelas ContainerControlDesigner. |
Properti
| ActionLists |
Mendapatkan kumpulan daftar tindakan untuk perancang kontrol. (Diperoleh dari ControlDesigner) |
| AllowResize |
Mendapatkan nilai yang menunjukkan apakah kontrol dapat diubah ukurannya pada waktu desain. |
| AssociatedComponents |
Mendapatkan kumpulan komponen yang terkait dengan komponen yang dikelola oleh perancang. (Diperoleh dari ComponentDesigner) |
| AutoFormats |
Mendapatkan kumpulan skema pemformatan otomatis yang telah ditentukan sebelumnya untuk ditampilkan dalam kotak dialog Format Otomatis untuk kontrol terkait pada waktu desain. (Diperoleh dari ControlDesigner) |
| Behavior |
Kedaluwarsa.
Mendapatkan atau mengatur perilaku DHTML yang terkait dengan perancang. (Diperoleh dari HtmlControlDesigner) |
| Component |
Mendapatkan komponen yang didesain desainer ini. (Diperoleh dari ComponentDesigner) |
| DataBindings |
Mendapatkan pengumpulan pengikatan data untuk kontrol saat ini. (Diperoleh dari HtmlControlDesigner) |
| DataBindingsEnabled |
Mendapatkan nilai yang menunjukkan apakah pengikatan data didukung oleh wilayah yang berisi untuk kontrol terkait. (Diperoleh dari ControlDesigner) |
| DesignerState |
Mendapatkan objek yang digunakan untuk mempertahankan data untuk kontrol terkait pada waktu desain. (Diperoleh dari ControlDesigner) |
| DesignTimeElement |
Kedaluwarsa.
Mendapatkan objek waktu desain yang mewakili kontrol yang terkait dengan HtmlControlDesigner objek pada permukaan desain. (Diperoleh dari HtmlControlDesigner) |
| DesignTimeElementView |
Kedaluwarsa.
Mendapatkan objek kontrol tampilan untuk perancang kontrol. (Diperoleh dari ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Kedaluwarsa.
Mendapatkan nilai yang menunjukkan apakah host desain harus menyelesaikan pemuatan sebelum GetDesignTimeHtml metode dapat dipanggil. (Diperoleh dari ControlDesigner) |
| Expressions |
Mendapatkan pengikatan ekspresi untuk kontrol saat ini pada waktu desain. (Diperoleh dari HtmlControlDesigner) |
| FrameCaption |
Mendapatkan keterangan yang ditampilkan untuk kontrol pada waktu desain. |
| FrameStyle |
Mendapatkan gaya yang diterapkan ke bingkai kontrol pada waktu desain. |
| HidePropertiesInTemplateMode |
Mendapatkan nilai yang menunjukkan apakah properti kontrol terkait disembunyikan saat kontrol dalam mode templat. (Diperoleh dari ControlDesigner) |
| ID |
Mendapatkan atau mengatur string ID untuk kontrol. (Diperoleh dari ControlDesigner) |
| InheritanceAttribute |
Mendapatkan atribut yang menunjukkan jenis pewarisan komponen terkait. (Diperoleh dari ComponentDesigner) |
| Inherited |
Mendapatkan nilai yang menunjukkan apakah komponen ini diwariskan. (Diperoleh dari ComponentDesigner) |
| InTemplateMode |
Mendapatkan nilai yang menunjukkan apakah kontrol berada dalam mode tampilan templat atau pengeditan di host desain. Properti InTemplateMode bersifat baca-saja. (Diperoleh dari ControlDesigner) |
| IsDirty |
Kedaluwarsa.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server Web telah ditandai sebagai diubah. (Diperoleh dari ControlDesigner) |
| NoWrap |
Mendapatkan nilai yang menentukan apakah akan menggunakan atribut HTML |
| ParentComponent |
Mendapatkan komponen induk untuk perancang ini. (Diperoleh dari ComponentDesigner) |
| ReadOnly |
Kedaluwarsa.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah properti kontrol bersifat baca-saja pada waktu desain. (Diperoleh dari ControlDesigner) |
| RootDesigner |
Mendapatkan perancang kontrol untuk halaman Formulir Web yang berisi kontrol terkait. (Diperoleh dari ControlDesigner) |
| SetTextualDefaultProperty |
Menyediakan fungsionalitas perancang untuk kontrol yang berisi kontrol turunan atau properti yang dapat dimodifikasi pada waktu desain. (Diperoleh dari ComponentDesigner) |
| ShadowProperties |
Mendapatkan kumpulan nilai properti yang mengambil alih pengaturan pengguna. (Diperoleh dari ComponentDesigner) |
| ShouldCodeSerialize |
Kedaluwarsa.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan membuat deklarasi bidang untuk kontrol dalam file code-behind untuk dokumen desain saat ini selama serialisasi. (Diperoleh dari HtmlControlDesigner) |
| Tag |
Mendapatkan objek yang mewakili elemen markup HTML untuk kontrol terkait. (Diperoleh dari ControlDesigner) |
| TemplateGroups |
Mendapatkan kumpulan grup templat, masing-masing berisi satu atau beberapa definisi templat. (Diperoleh dari ControlDesigner) |
| UsePreviewControl |
Mendapatkan nilai yang menunjukkan apakah perancang kontrol menggunakan kontrol pratinjau sementara untuk menghasilkan markup HTML waktu desain. (Diperoleh dari ControlDesigner) |
| Verbs |
Mendapatkan kata kerja waktu desain yang didukung oleh komponen yang terkait dengan perancang. (Diperoleh dari ComponentDesigner) |
| ViewControl |
Mendapatkan atau mengatur kontrol server Web yang dapat digunakan untuk mempratinjau markup HTML waktu desain. (Diperoleh dari ControlDesigner) |
| ViewControlCreated |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah |
| Visible |
Mendapatkan nilai yang menunjukkan apakah kontrol terlihat pada waktu desain. (Diperoleh dari ControlDesigner) |
Metode
| AddDesignTimeCssAttributes(IDictionary) |
Menambahkan atribut gaya untuk kontrol pada waktu desain. |
| CreateErrorDesignTimeHtml(String) |
Membuat markup HTML untuk menampilkan pesan kesalahan tertentu pada waktu desain. (Diperoleh dari ControlDesigner) |
| CreateErrorDesignTimeHtml(String, Exception) |
Membuat markup HTML untuk menampilkan pesan kesalahan pengecualian tertentu pada waktu desain. (Diperoleh dari ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Menyediakan representasi tempat penampung persegi panjang sederhana yang menampilkan jenis dan ID kontrol. (Diperoleh dari ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Menyediakan representasi tempat penampung persegi panjang sederhana yang menampilkan jenis dan ID kontrol, dan juga instruksi atau informasi tambahan yang ditentukan. (Diperoleh dari ControlDesigner) |
| CreateViewControl() |
Mengembalikan salinan kontrol terkait untuk menampilkan atau merender pada permukaan desain. (Diperoleh dari ControlDesigner) |
| Dispose() |
Merilis semua sumber daya yang ComponentDesignerdigunakan oleh . (Diperoleh dari ComponentDesigner) |
| Dispose(Boolean) |
Merilis sumber daya tidak terkelola yang digunakan oleh HtmlControlDesigner objek dan secara opsional merilis sumber daya terkelola. (Diperoleh dari HtmlControlDesigner) |
| DoDefaultAction() |
Membuat tanda tangan metode dalam file kode sumber untuk peristiwa default pada komponen dan menavigasi kursor pengguna ke lokasi tersebut. (Diperoleh dari ComponentDesigner) |
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| GetBounds() |
Mengambil koordinat persegi panjang yang mewakili batas untuk kontrol seperti yang ditampilkan pada permukaan desain. (Diperoleh dari ControlDesigner) |
| GetDesignTimeCssAttributes() |
Mengembalikan kumpulan atribut gaya untuk kontrol pada waktu desain. |
| GetDesignTimeHtml() |
Mengambil markup HTML yang digunakan untuk mewakili kontrol pada waktu desain. (Diperoleh dari ControlDesigner) |
| GetDesignTimeHtml(DesignerRegionCollection) |
Mengembalikan markup HTML yang digunakan untuk mewakili kontrol pada waktu desain. |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Mengembalikan konten untuk wilayah kontrol yang dapat diedit pada waktu desain. |
| GetEmptyDesignTimeHtml() |
Mengambil markup HTML untuk mewakili kontrol server Web pada waktu desain yang tidak akan memiliki representasi visual pada durasi. (Diperoleh dari ControlDesigner) |
| GetErrorDesignTimeHtml(Exception) |
Mengambil markup HTML yang menyediakan informasi tentang pengecualian yang ditentukan. (Diperoleh dari ControlDesigner) |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetPersistenceContent() |
Mengembalikan konten kontrol yang dapat dipertahankan pada waktu desain. |
| GetPersistInnerHtml() |
Kedaluwarsa.
Mengambil markup HTML dalam kontrol yang dapat dipertahankan. (Diperoleh dari ControlDesigner) |
| GetService(Type) |
Mencoba mengambil jenis layanan yang ditentukan dari situs mode desain komponen perancang. (Diperoleh dari ComponentDesigner) |
| GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
| GetViewRendering() |
Mengambil objek yang berisi markup waktu desain untuk konten dan wilayah kontrol terkait. (Diperoleh dari ControlDesigner) |
| Initialize(IComponent) |
Menginisialisasi perancang kontrol dan memuat komponen yang ditentukan. (Diperoleh dari ControlDesigner) |
| InitializeExistingComponent(IDictionary) |
Menginisialisasi ulang komponen yang ada. (Diperoleh dari ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Menginisialisasi komponen yang baru dibuat. (Diperoleh dari ComponentDesigner) |
| InitializeNonDefault() |
Kedaluwarsa.
Kedaluwarsa.
Menginisialisasi pengaturan untuk komponen yang diimpor yang sudah diinisialisasi ke pengaturan selain default. (Diperoleh dari ComponentDesigner) |
| Invalidate() |
Membatalkan seluruh area kontrol yang ditampilkan pada permukaan desain dan memberi sinyal kepada perancang kontrol untuk menggambar ulang kontrol. (Diperoleh dari ControlDesigner) |
| Invalidate(Rectangle) |
Membatalkan area kontrol yang ditentukan yang ditampilkan pada permukaan desain dan memberi sinyal kepada perancang kontrol untuk menggambar ulang kontrol. (Diperoleh dari ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
InheritanceAttribute Mendapatkan dari yang ditentukanComponentDesigner. (Diperoleh dari ComponentDesigner) |
| IsPropertyBound(String) |
Kedaluwarsa.
Mengambil nilai yang menunjukkan apakah properti yang ditentukan pada kontrol terkait terikat data. (Diperoleh dari ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Menggunakan penulis sumber daya yang disediakan untuk mempertahankan properti kontrol terkait yang dapat dilokalkan ke sumber daya di host desain. (Diperoleh dari ControlDesigner) |
| MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Dipanggil ketika skema pemformatan otomatis yang telah ditentukan sebelumnya telah diterapkan ke kontrol terkait. (Diperoleh dari ControlDesigner) |
| OnBehaviorAttached() |
Dipanggil saat perancang kontrol dilampirkan ke objek Perilaku. (Diperoleh dari ControlDesigner) |
| OnBehaviorDetaching() |
Kedaluwarsa.
Dipanggil ketika perilaku memisahkan diri dari elemen . (Diperoleh dari HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Kedaluwarsa.
Dipanggil saat pengumpulan pengikatan data berubah. (Diperoleh dari ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Dipanggil oleh host desain saat pengguna mengklik kontrol terkait pada waktu desain. (Diperoleh dari ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Dipanggil saat kontrol terkait berubah. (Diperoleh dari ControlDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Mewakili metode yang akan menangani ComponentChanging peristiwa untuk kontrol terkait. (Diperoleh dari ControlDesigner) |
| OnControlResize() |
Kedaluwarsa.
Dipanggil ketika kontrol server Web terkait telah diubah ukurannya di host desain pada waktu desain. (Diperoleh dari ControlDesigner) |
| OnPaint(PaintEventArgs) |
Dipanggil ketika perancang kontrol menggambar kontrol terkait pada permukaan desain, jika CustomPaint nilainya adalah |
| OnSetComponentDefaults() |
Kedaluwarsa.
Kedaluwarsa.
Mengatur properti default untuk komponen. (Diperoleh dari ComponentDesigner) |
| OnSetParent() |
Menyediakan cara untuk melakukan pemrosesan tambahan ketika kontrol terkait dilampirkan ke kontrol induk. (Diperoleh dari HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
Memungkinkan perancang untuk mengubah atau menghapus item dari sekumpulan atribut yang diekspos melalui TypeDescriptor. (Diperoleh dari ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Memungkinkan perancang untuk mengubah atau menghapus item dari serangkaian peristiwa yang diekspos melalui TypeDescriptor. (Diperoleh dari ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Memungkinkan perancang untuk mengubah atau menghapus item dari sekumpulan properti yang diekspos melalui TypeDescriptor. (Diperoleh dari ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Memungkinkan perancang untuk menambahkan ke set atribut yang diekspos melalui TypeDescriptor. (Diperoleh dari ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Mengatur daftar peristiwa yang diekspos pada waktu desain untuk TypeDescriptor objek untuk komponen. (Diperoleh dari HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Menambahkan properti ke atau menghapus properti dari kisi Properti di host desain pada waktu desain atau menyediakan properti waktu desain baru yang mungkin sesuai dengan properti pada kontrol terkait. (Diperoleh dari ControlDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Memberi tahu IComponentChangeService bahwa komponen ini telah diubah. (Diperoleh dari ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Memberi tahu IComponentChangeService bahwa komponen ini akan diubah. (Diperoleh dari ComponentDesigner) |
| RaiseResizeEvent() |
Kedaluwarsa.
Memunculkan kejadian OnControlResize(). (Diperoleh dari ControlDesigner) |
| RegisterClone(Object, Object) |
Mendaftarkan data internal dalam kontrol kloning. (Diperoleh dari ControlDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Mengatur konten untuk wilayah kontrol yang dapat diedit pada waktu desain. |
| SetRegionContent(EditableDesignerRegion, String) |
Menentukan konten untuk wilayah yang dapat diedit dalam tampilan waktu desain kontrol. (Diperoleh dari ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Menetapkan enumerasi bitwise ViewFlags yang ditentukan ke nilai bendera yang ditentukan. (Diperoleh dari ControlDesigner) |
| ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
| UpdateDesignTimeHtml() |
Menyegarkan markup HTML waktu desain untuk kontrol server Web terkait dengan memanggil GetDesignTimeHtml metode . (Diperoleh dari ControlDesigner) |
