ButtonDesigner Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.Design.WebControls

Rakitan:: System.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.

Digunakan untuk menyediakan dukungan waktu desain dalam perancang visual untuk Button kontrol server Web.

public ref class ButtonDesigner : System::Web::UI::Design::ControlDesigner

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

[System.Web.UI.Design.SupportsPreviewControl(true)]
public class ButtonDesigner : System.Web.UI.Design.ControlDesigner

type ButtonDesigner = class
    inherit ControlDesigner

[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type ButtonDesigner = class
    inherit ControlDesigner

Public Class ButtonDesigner
Inherits ControlDesigner

Warisan: Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner
ButtonDesigner

Atribut: SupportsPreviewControlAttribute

Contoh

Bagian ini menyediakan dua contoh kode. Yang pertama menunjukkan cara memperpanjang ButtonDesigner kelas. Yang kedua menunjukkan cara memperluas Button kelas dan mengaitkannya dengan kelas yang dibuat dalam contoh kode pertama.

Contoh kode berikut menunjukkan cara membuat kelas perancang kustom yang memperluas ButtonDesigner kelas dan mengambil GetDesignTimeHtml alih metode . BorderStyle Jika properti belum diatur sebelumnya (yaitu, properti memiliki NotSet nilai bidang), panggilan ke GetDesignTimeHtml metode mengaturnya ke batas putus-putus biru dengan lebar tiga piksel, lalu menampilkan batas tersebut pada permukaan desain. BorderStyle Jika properti telah diatur, nilai properti batas yang ada akan ditampilkan.

Biasanya, GetDesignTimeHtml memanggil metode dasarnya, ControlDesigner.GetDesignTimeHtml, yang memanggil ke Control.RenderControl metode kontrol terkait untuk menghasilkan markup.

' Create a class that derives from ButtonDesigner
' and displays the custom SampleButton control
' on the design surface.
Imports System.Web.UI.Design
Imports System.Drawing
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls

Namespace Examples.AspNet 

    
    Public Class SampleButtonDesigner
        Inherits ButtonDesigner

        ' Override the GetDesignTimeHtml method.
        Public Overrides Function GetDesignTimeHtml() As String

            Dim sampleButton As SampleButton = CType(Component, SampleButton)
            Dim designTimeHtml As String = Nothing

            ' Check the control's BorderStyle property
            ' to conditionally render design-time HTML.
            If (sampleButton.BorderStyle = BorderStyle.NotSet) Then

                ' Create variables to hold current property settings.
                Dim oldBorderStyle As BorderStyle = sampleButton.BorderStyle
                Dim oldBorderWidth As Unit = sampleButton.BorderWidth
                Dim oldBorderColor As Color = sampleButton.BorderColor

                ' Set properties and the design-time HTML.
                Try
                    sampleButton.BorderStyle = BorderStyle.Dashed
                    sampleButton.BorderWidth = Unit.Pixel(3)
                    sampleButton.BorderColor = Color.Blue
                    designTimeHtml = MyBase.GetDesignTimeHtml()

                    ' If an exception occurs, call the GetErrorDesignTimeHtml
                    ' method.
                Catch ex As Exception
                    designTimeHtml = GetErrorDesignTimeHtml(ex)

                    ' Return properties to their original settings.
                Finally
                    sampleButton.BorderStyle = oldBorderStyle
                    sampleButton.BorderWidth = oldBorderWidth
                    sampleButton.BorderColor = oldBorderColor
                End Try

            Else
                designTimeHtml = MyBase.GetDesignTimeHtml()
            End If

            Return designTimeHtml

        End Function

    End Class
End Namespace

Contoh kode berikut menunjukkan cara menggunakan kelas sederhana yang memperluas Button kelas dan dikaitkan dengan SampleButtonDesigner kelas , yang dibuat dalam contoh sebelumnya, melalui DesignerAttribute objek .

<DesignerAttribute( _
    GetType(Examples.AspNet.SampleButtonDesigner))> _
Public Class SampleButton
    Inherits Button
    ' Include code here for a custom 
    ' class that inherits from Button.        
End Class

Keterangan

Dalam desainer visual, saat Anda beralih dari tampilan Sumber ke Desain, kode sumber markup yang menjelaskan Button kontrol diurai dan versi waktu desain kontrol dibuat pada permukaan desain. Saat Anda beralih kembali ke tampilan Sumber, kontrol waktu desain dipertahankan ke kode sumber markup dan diedit ke markup untuk halaman Web.

Konstruktor

ButtonDesigner()

Menginisialisasi instans baru kelas ButtonDesigner.

Properti

ActionLists	Mendapatkan kumpulan daftar tindakan untuk perancang kontrol. (Diperoleh dari ControlDesigner)
AllowResize	Mendapatkan nilai yang menunjukkan apakah kontrol dapat diubah ukurannya di lingkungan waktu desain. (Diperoleh dari ControlDesigner)
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 design-time 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)
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)
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	Digunakan untuk menyediakan dukungan waktu desain dalam perancang visual untuk Button kontrol server Web. (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

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)
GetDesignTimeHtml()	Mendapatkan markup yang digunakan untuk merender kontrol terkait pada waktu desain.
GetDesignTimeHtml(DesignerRegionCollection)	Mengambil markup HTML untuk menampilkan kontrol dan mengisi koleksi dengan wilayah perancang kontrol saat ini. (Diperoleh dari ControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)	Mengembalikan konten untuk wilayah yang dapat diedit dari tampilan waktu desain kontrol terkait. (Diperoleh dari ControlDesigner)
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()	Mengambil markup HTML dalam kontrol yang dapat dipertahankan pada waktu desain. (Diperoleh dari ControlDesigner)
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 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. 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)	Menentukan konten untuk wilayah kontrol yang dapat diedit pada waktu desain. (Diperoleh dari ControlDesigner)
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)

Berlaku untuk

Bagikan melalui