ContainerControlDesigner Kelas

Definisi

Ruang nama:

System.Web.UI.Design

Rakitan:

System.Design.dll

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::ControlDesigner

public class ContainerControlDesigner : System.Web.UI.Design.ControlDesigner

type ContainerControlDesigner = class
    inherit ControlDesigner

Public Class ContainerControlDesigner
Inherits ControlDesigner

Warisan

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

ContainerControlDesigner

Turunan

System.Web.UI.Design.WebControls.MultiViewDesigner

System.Web.UI.Design.WebControls.PanelContainerDesigner

System.Web.UI.Design.WebControls.ViewDesigner

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:

• false untuk menunjukkan bahwa ContainerControlDesigner mewakili konten wilayah desain yang dapat diedit sebagai kontrol anak.

• true untuk 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 nowrap pada tabel.
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 View kontrol telah dibuat untuk ditampilkan pada permukaan desain. (Diperoleh dari ControlDesigner)
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. 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 true. (Diperoleh dari ControlDesigner)
OnSetComponentDefaults()	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)

Implementasi Antarmuka Eksplisit

IDesignerFilter.PostFilterAttributes(IDictionary)	Untuk deskripsi anggota ini, lihat PostFilterAttributes(IDictionary) metode . (Diperoleh dari ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	Untuk deskripsi anggota ini, lihat PostFilterEvents(IDictionary) metode . (Diperoleh dari ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	Untuk deskripsi anggota ini, lihat PostFilterProperties(IDictionary) metode . (Diperoleh dari ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	Untuk deskripsi anggota ini, lihat PreFilterAttributes(IDictionary) metode . (Diperoleh dari ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	Untuk deskripsi anggota ini, lihat PreFilterEvents(IDictionary) metode . (Diperoleh dari ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	Untuk deskripsi anggota ini, lihat PreFilterProperties(IDictionary) metode . (Diperoleh dari ComponentDesigner)
ITreeDesigner.Children	Untuk deskripsi anggota ini, lihat Children properti . (Diperoleh dari ComponentDesigner)
ITreeDesigner.Parent	Untuk deskripsi anggota ini, lihat Parent properti . (Diperoleh dari ComponentDesigner)

Lihat juga

• ControlDesigner
• CompositeControlDesigner
• EditableDesignerRegion
• Panel
• PanelContainerDesigner
• Pengantar Perancang Kontrol ASP.NET
• Atribut dan Dukungan Design-Time