ButtonDesigner Класс

Определение

Пространство имен:: System.Web.UI.Design.WebControls

Сборка:: System.Design.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Используется для поддержки времени разработки в визуальном конструкторе Button для элемента управления веб-сервера.

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

Наследование: Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner
ButtonDesigner

Атрибуты: SupportsPreviewControlAttribute

Примеры

В этом разделе приведены два примера кода. В первом примере показано, как расширить ButtonDesigner класс. Второй демонстрирует расширение Button класса и связывание его с классом, созданным в первом примере кода.

В следующем примере кода показано, как создать пользовательский класс конструктора, расширяющий ButtonDesigner класс и переопределяющий GetDesignTimeHtml метод. BorderStyle Если свойство не было задано ранее (то есть имеет NotSet значение поля), вызов GetDesignTimeHtml метода задает ему сине-дефисированную границу с шириной 3 пикселя, а затем отображает эту границу на поверхности конструктора. BorderStyle Если свойство задано, отображаются существующие значения свойств границы.

Как правило, он GetDesignTimeHtml вызывает его базовый метод, ControlDesigner.GetDesignTimeHtmlкоторый вызывает Control.RenderControl метод связанного элемента управления для создания разметки.

' 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

В следующем примере кода показано, как использовать простой класс, который расширяет Button класс и связан с SampleButtonDesigner классом, созданным в предыдущем примере с помощью DesignerAttribute объекта.

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

В визуальном конструкторе при переходе с исходного представления на конструктор исходный код разметки, описывающий Button элемент управления, анализируется и создается версия элемента управления во время разработки на поверхности конструктора. При переходе к представлению источника элемент управления времени разработки сохраняется в исходном коде разметки и редактируется в разметку веб-страницы.

Конструкторы

Имя	Описание
ButtonDesigner()	Инициализирует новый экземпляр класса ButtonDesigner.

Свойства

Имя	Описание
ActionLists	Возвращает коллекцию списков действий для конструктора элементов управления. (Унаследовано от ControlDesigner)
AllowResize	Возвращает значение, указывающее, можно ли изменить размер элемента управления в среде времени разработки. (Унаследовано от ControlDesigner)
AssociatedComponents	Возвращает коллекцию компонентов, связанных с компонентом, управляемым конструктором. (Унаследовано от ComponentDesigner)
AutoFormats	Возвращает коллекцию предопределенных схем автоматического форматирования, отображаемых в диалоговом окне автоформатирования для связанного элемента управления во время разработки. (Унаследовано от ControlDesigner)
Behavior	Устаревшие.. Возвращает или задает поведение DHTML, связанное с конструктором. (Унаследовано от HtmlControlDesigner)
Component	Возвращает компонент, который проектируется этим конструктором. (Унаследовано от ComponentDesigner)
DataBindings	Возвращает коллекцию привязок данных для текущего элемента управления. (Унаследовано от HtmlControlDesigner)
DataBindingsEnabled	Возвращает значение, указывающее, поддерживается ли привязка данных содержащим регионом для связанного элемента управления. (Унаследовано от ControlDesigner)
DesignerState	Возвращает объект, используемый для сохранения данных связанного элемента управления во время разработки. (Унаследовано от ControlDesigner)
DesignTimeElement	Устаревшие.. Возвращает объект времени разработки, представляющий элемент управления, связанный с HtmlControlDesigner объектом в области конструктора. (Унаследовано от HtmlControlDesigner)
DesignTimeElementView	Устаревшие.. Возвращает объект элемента управления представления для конструктора элементов управления. (Унаследовано от ControlDesigner)
DesignTimeHtmlRequiresLoadComplete	Устаревшие.. Возвращает значение, указывающее, должен ли узел конструктора завершить загрузку перед вызовом GetDesignTimeHtml метода. (Унаследовано от ControlDesigner)
Expressions	Возвращает привязки выражений для текущего элемента управления во время разработки. (Унаследовано от HtmlControlDesigner)
HidePropertiesInTemplateMode	Возвращает значение, указывающее, скрыты ли свойства связанного элемента управления, когда элемент управления находится в режиме шаблона. (Унаследовано от ControlDesigner)
ID	Возвращает или задает строку идентификатора для элемента управления. (Унаследовано от ControlDesigner)
InheritanceAttribute	Возвращает атрибут, указывающий тип наследования связанного компонента. (Унаследовано от ComponentDesigner)
Inherited	Возвращает значение, указывающее, наследуется ли этот компонент. (Унаследовано от ComponentDesigner)
InTemplateMode	Получает значение, указывающее, находится ли элемент управления в режиме просмотра или редактирования шаблона в узле конструктора. Свойство InTemplateMode доступно только для чтения. (Унаследовано от ControlDesigner)
IsDirty	Устаревшие.. Возвращает или задает значение, указывающее, помечен ли элемент управления веб-сервера как измененный. (Унаследовано от ControlDesigner)
ParentComponent	Возвращает родительский компонент для этого конструктора. (Унаследовано от ComponentDesigner)
ReadOnly	Устаревшие.. Возвращает или задает значение, указывающее, доступны ли свойства элемента управления только для чтения во время разработки. (Унаследовано от ControlDesigner)
RootDesigner	Возвращает конструктор элементов управления для страницы веб-форм, содержащей связанный элемент управления. (Унаследовано от ControlDesigner)
ShadowProperties	Возвращает коллекцию значений свойств, которые переопределяют параметры пользователя. (Унаследовано от ComponentDesigner)
ShouldCodeSerialize	Устаревшие.. Возвращает или задает значение, указывающее, следует ли создавать объявление поля для элемента управления в файле программной части текущего документа конструктора во время сериализации. (Унаследовано от HtmlControlDesigner)
Tag	Возвращает объект, представляющий элемент разметки HTML для связанного элемента управления. (Унаследовано от ControlDesigner)
TemplateGroups	Получает коллекцию групп шаблонов, каждая из которых содержит одно или несколько определений шаблонов. (Унаследовано от ControlDesigner)
UsePreviewControl	Возвращает значение, указывающее, использует ли конструктор элементов управления временный предварительный просмотр для создания разметки HTML во время разработки. (Унаследовано от ControlDesigner)
Verbs	Возвращает команды времени разработки, поддерживаемые компонентом, связанным с конструктором. (Унаследовано от ComponentDesigner)
ViewControl	Возвращает или задает элемент управления веб-сервера, который можно использовать для предварительного просмотра разметки HTML во время разработки. (Унаследовано от ControlDesigner)
ViewControlCreated	Возвращает или задает значение, указывающее, был ли `View` элемент управления создан для отображения на поверхности конструктора. (Унаследовано от ControlDesigner)
Visible	Возвращает значение, указывающее, отображается ли элемент управления во время разработки. (Унаследовано от ControlDesigner)

Методы

Имя	Описание
CreateErrorDesignTimeHtml(String, Exception)	Создает разметку HTML для отображения указанного сообщения об ошибке исключения во время разработки. (Унаследовано от ControlDesigner)
CreateErrorDesignTimeHtml(String)	Создает разметку HTML для отображения указанного сообщения об ошибке во время разработки. (Унаследовано от ControlDesigner)
CreatePlaceHolderDesignTimeHtml()	Предоставляет простое прямоугольное представление заполнителя, отображающее тип и идентификатор элемента управления. (Унаследовано от ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)	Предоставляет простое прямоугольное представление заполнителя, отображающее тип и идентификатор элемента управления, а также дополнительные инструкции или сведения. (Унаследовано от ControlDesigner)
CreateViewControl()	Возвращает копию связанного элемента управления для просмотра или отрисовки на поверхности конструктора. (Унаследовано от ControlDesigner)
Dispose()	Освобождает все ресурсы, используемые параметром ComponentDesigner. (Унаследовано от ComponentDesigner)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые HtmlControlDesigner объектом, и при необходимости освобождает управляемые ресурсы. (Унаследовано от HtmlControlDesigner)
DoDefaultAction()	Создает сигнатуру метода в файле исходного кода для события по умолчанию компонента и перемещает курсор пользователя в это расположение. (Унаследовано от ComponentDesigner)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetBounds()	Извлекает координаты прямоугольника, представляющего границы элемента управления, отображаемого на поверхности конструктора. (Унаследовано от ControlDesigner)
GetDesignTimeHtml()	Получает разметку, которая используется для отрисовки связанного элемента управления во время разработки.
GetDesignTimeHtml(DesignerRegionCollection)	Извлекает разметку HTML для отображения элемента управления и заполняет коллекцию текущими областями конструктора элементов управления. (Унаследовано от ControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)	Возвращает содержимое редактируемой области представления времени разработки связанного элемента управления. (Унаследовано от ControlDesigner)
GetEmptyDesignTimeHtml()	Извлекает разметку HTML для представления элемента управления веб-сервера во время разработки, которое не будет визуального представления во время выполнения. (Унаследовано от ControlDesigner)
GetErrorDesignTimeHtml(Exception)	Извлекает разметку HTML, которая предоставляет сведения об указанном исключении. (Унаследовано от ControlDesigner)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetPersistenceContent()	Извлекает сохраняемую внутреннюю разметку HTML элемента управления во время разработки. (Унаследовано от ControlDesigner)
GetPersistInnerHtml()	Устаревшие.. Извлекает сохраняемую внутреннюю разметку HTML элемента управления. (Унаследовано от ControlDesigner)
GetService(Type)	Пытается получить указанный тип службы из сайта режима конструктора компонента конструктора. (Унаследовано от ComponentDesigner)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetViewRendering()	Извлекает объект, содержащий разметку времени разработки для содержимого и регионов связанного элемента управления. (Унаследовано от ControlDesigner)
Initialize(IComponent)	Инициализирует конструктор элементов управления и загружает указанный компонент. (Унаследовано от ControlDesigner)
InitializeExistingComponent(IDictionary)	Повторно инициализирует существующий компонент. (Унаследовано от ComponentDesigner)
InitializeNewComponent(IDictionary)	Инициализирует только что созданный компонент. (Унаследовано от ComponentDesigner)
InitializeNonDefault()	Устаревшие.. Устаревшие.. Инициализирует параметры импортированного компонента, который уже инициализирован для параметров, отличных от значений по умолчанию. (Унаследовано от ComponentDesigner)
Invalidate()	Отменяет всю область элемента управления, отображаемую на поверхности конструктора, и сообщает конструктору элементов управления перераскрыть элемент управления. (Унаследовано от ControlDesigner)
Invalidate(Rectangle)	Отменяет указанную область элемента управления, отображаемую на поверхности конструктора, и сообщает конструктору элементов управления перераскрыть элемент управления. (Унаследовано от ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)	InheritanceAttribute Возвращает указанный ComponentDesignerобъект. (Унаследовано от ComponentDesigner)
IsPropertyBound(String)	Устаревшие.. Извлекает значение, указывающее, привязано ли указанное свойство связанного элемента управления. (Унаследовано от ControlDesigner)
Localize(IDesignTimeResourceWriter)	Использует предоставленный модуль записи ресурсов для сохранения локализованных свойств связанного элемента управления с ресурсом в узле конструктора. (Унаследовано от ControlDesigner)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnAutoFormatApplied(DesignerAutoFormat)	Вызывается при применении предопределенной схемы автоматического форматирования к связанному элементу управления. (Унаследовано от ControlDesigner)
OnBehaviorAttached()	Вызывается при присоединении конструктора элементов управления к объекту Behavior. (Унаследовано от ControlDesigner)
OnBehaviorDetaching()	Устаревшие.. Вызывается, когда поведение отсоединяется от элемента. (Унаследовано от HtmlControlDesigner)
OnBindingsCollectionChanged(String)	Устаревшие.. Вызывается при изменении коллекции привязки данных. (Унаследовано от ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)	Вызывается узлом конструктора, когда пользователь щелкает связанный элемент управления во время разработки. (Унаследовано от ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)	Вызывается при изменении связанного элемента управления. (Унаследовано от ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)	Представляет метод, который будет обрабатывать ComponentChanging событие для связанного элемента управления. (Унаследовано от ControlDesigner)
OnControlResize()	Устаревшие.. Вызывается при изменении размера связанного веб-сервера в узле конструктора во время разработки. (Унаследовано от ControlDesigner)
OnPaint(PaintEventArgs)	Вызывается, когда конструктор элементов управления рисует связанный элемент управления на поверхности конструктора, если CustomPaint значение равно `true`. (Унаследовано от ControlDesigner)
OnSetComponentDefaults()	Устаревшие.. Устаревшие.. Задает свойства по умолчанию для компонента. (Унаследовано от ComponentDesigner)
OnSetParent()	Предоставляет способ выполнения дополнительной обработки при присоединении связанного элемента управления к родительскому элементу управления. (Унаследовано от HtmlControlDesigner)
PostFilterAttributes(IDictionary)	Позволяет конструктору изменять или удалять элементы из набора атрибутов, предоставляемых через объект TypeDescriptor. (Унаследовано от ComponentDesigner)
PostFilterEvents(IDictionary)	Позволяет конструктору изменять или удалять элементы из набора событий, предоставляемых через TypeDescriptorобъект. (Унаследовано от ComponentDesigner)
PostFilterProperties(IDictionary)	Позволяет конструктору изменять или удалять элементы из набора свойств, предоставляемых через объект TypeDescriptor. (Унаследовано от ComponentDesigner)
PreFilterAttributes(IDictionary)	Позволяет конструктору добавлять в набор атрибутов, предоставляемых с помощью TypeDescriptor. (Унаследовано от ComponentDesigner)
PreFilterEvents(IDictionary)	Задает список событий, предоставляемых во время разработки для TypeDescriptor объекта компонента. (Унаследовано от HtmlControlDesigner)
PreFilterProperties(IDictionary)	Добавляет свойства в сетку свойств в узле конструктора или удаляет их во время разработки или предоставляет новые свойства времени разработки, которые могут соответствовать свойствам связанного элемента управления. (Унаследовано от ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)	Уведомляет об IComponentChangeService изменении этого компонента. (Унаследовано от ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)	Уведомляет IComponentChangeService об изменении этого компонента. (Унаследовано от ComponentDesigner)
RaiseResizeEvent()	Устаревшие.. Вызывает событие OnControlResize(). (Унаследовано от ControlDesigner)
RegisterClone(Object, Object)	Регистрирует внутренние данные в клонируемом элементе управления. (Унаследовано от ControlDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)	Указывает содержимое редактируемой области элемента управления во время разработки. (Унаследовано от ControlDesigner)
SetRegionContent(EditableDesignerRegion, String)	Указывает содержимое редактируемой области в представлении времени разработки элемента управления. (Унаследовано от ControlDesigner)
SetViewFlags(ViewFlags, Boolean)	Назначает указанное побитовое ViewFlags перечисление указанному значению флага. (Унаследовано от ControlDesigner)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
UpdateDesignTimeHtml()	Обновляет разметку HTML во время разработки для связанного веб-сервера, вызывая GetDesignTimeHtml метод. (Унаследовано от ControlDesigner)

Явные реализации интерфейса

Имя	Описание
IDesignerFilter.PostFilterAttributes(IDictionary)	Описание этого элемента см. в описании PostFilterAttributes(IDictionary) метода. (Унаследовано от ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	Описание этого элемента см. в описании PostFilterEvents(IDictionary) метода. (Унаследовано от ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	Описание этого элемента см. в описании PostFilterProperties(IDictionary) метода. (Унаследовано от ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	Описание этого элемента см. в описании PreFilterAttributes(IDictionary) метода. (Унаследовано от ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	Описание этого элемента см. в описании PreFilterEvents(IDictionary) метода. (Унаследовано от ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	Описание этого элемента см. в описании PreFilterProperties(IDictionary) метода. (Унаследовано от ComponentDesigner)
ITreeDesigner.Children	Описание этого элемента см. в свойстве Children . (Унаследовано от ComponentDesigner)
ITreeDesigner.Parent	Описание этого элемента см. в свойстве Parent . (Унаследовано от ComponentDesigner)

Применяется к

См. также раздел

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через