ButtonDesigner Класс
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Используется для предоставления поддержки во время разработки в визуальном конструкторе для элемента управления веб-сервера 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
- Наследование
- Атрибуты
В этом разделе приведены два примера кода. Первый демонстрирует расширение ButtonDesigner класса . Второй демонстрирует, как расширить Button класс и связать его с классом, созданным в первом примере кода.
В следующем примере кода показано, как создать пользовательский класс конструктора ButtonDesigner , который расширяет класс и переопределяет GetDesignTimeHtml метод . BorderStyle Если свойство не было задано ранее (то есть имеет NotSet значение поля), вызов GetDesignTimeHtml метода задает для него сине-пунктирную границу шириной в три пикселя, а затем отображает эту границу в области конструктора. 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 , описывающего элемент управления, и в области конструктора создается версия элемента управления во время разработки. При переключении обратно в исходное представление элемент управления времени разработки сохраняется в исходном коде разметки и редактируется в разметке для веб-страницы.
Button |
Инициализирует новый экземпляр класса ButtonDesigner. |
Action |
Получает коллекцию списков действий для конструктора элементов управления. (Унаследовано от ControlDesigner) |
Allow |
Получает значение, указывающее, можно ли изменять размер элемента управления в среде времени разработки. (Унаследовано от ControlDesigner) |
Associated |
Получает коллекцию компонентов, сопоставленных компоненту, который управляется конструктором. (Унаследовано от ComponentDesigner) |
Auto |
Получает коллекцию предварительно определенных схем автоматического форматирования, которые будут отображаться в диалоговом окне Автоформат для связанного элемента управления во время разработки. (Унаследовано от ControlDesigner) |
Behavior |
Устаревшие..
Получает или задает поведение DHTML, связанное с конструктором. (Унаследовано от HtmlControlDesigner) |
Component |
Возвращает основной компонент, создаваемый данным конструктором. (Унаследовано от ComponentDesigner) |
Data |
Получает коллекцию привязок данных для текущего элемента управления. (Унаследовано от HtmlControlDesigner) |
Data |
Получает значение, указывающее, поддерживается ли привязка данных областью, содержащей элемент управления. (Унаследовано от ControlDesigner) |
Designer |
Получает объект, используемый для сохранения данных сопоставленного элемента управления во время разработки. (Унаследовано от ControlDesigner) |
Design |
Устаревшие..
Возвращает объект времени разработки, представляющий элемент управления, сопоставленный с объектом HtmlControlDesigner в области разработки. (Унаследовано от HtmlControlDesigner) |
Design |
Устаревшие..
Получает объект элемента управления представлением для конструктора элементов управления. (Унаследовано от ControlDesigner) |
Design |
Устаревшие..
Получает значение, указывающее, должна ли быть завершена загрузка основным приложением разработки до вызова метода GetDesignTimeHtml. (Унаследовано от ControlDesigner) |
Expressions |
Возвращает привязки выражений для текущего элемента управления во время разработки. (Унаследовано от HtmlControlDesigner) |
Hide |
Получает значение, указывающее, скрыты ли свойства сопоставленного элемента управления, когда он находится в режиме шаблона. (Унаследовано от ControlDesigner) |
ID |
Получает или задает строку идентификатора элемента управления. (Унаследовано от ControlDesigner) |
Inheritance |
Возвращает атрибут, обозначающий тип наследования связанного компонента. (Унаследовано от ComponentDesigner) |
Inherited |
Возвращает значение, определяющее, наследуется ли этот компонент или нет. (Унаследовано от ComponentDesigner) |
In |
получает значение, указывающее, находится ли элемент управления в режиме просмотра или редактирования шаблона в основном приложении разработки. Свойство InTemplateMode доступно только для чтения. (Унаследовано от ControlDesigner) |
Is |
Устаревшие..
Получает или задает значение, указывающее наличие отметки об изменении серверного веб-элемента управления. (Унаследовано от ControlDesigner) |
Parent |
Возвращает родительский компонент этого конструктора. (Унаследовано от ComponentDesigner) |
Read |
Устаревшие..
Получает или задает значение, указывающее, доступны ли только для чтения свойства элемента управления во время разработки. (Унаследовано от ControlDesigner) |
Root |
Получает конструктор элементов управления для страницы веб-форм, содержащей сопоставленный элемент управления. (Унаследовано от ControlDesigner) |
Set |
Используется для предоставления поддержки во время разработки в визуальном конструкторе для элемента управления веб-сервера Button. (Унаследовано от ComponentDesigner) |
Shadow |
Возвращает коллекцию значений свойств, переопределяющих параметры пользователя. (Унаследовано от ComponentDesigner) |
Should |
Устаревшие..
Получает или задает значение, показывающее, создавать ли объявление поля для элемента управления в файле кода программной части для текущего документа разработки во время сериализации. (Унаследовано от HtmlControlDesigner) |
Tag |
Получает объект, представляющей элемент разметки HTML для сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
Template |
Получает коллекцию групп шаблонов, каждая из которых содержит одно или несколько определений шаблонов. (Унаследовано от ControlDesigner) |
Use |
Получает значение, указывающее, использует ли конструктор элементов управления временный элемент управления "Предварительный просмотр" для создания разметки HTML во время разработки. (Унаследовано от ControlDesigner) |
Verbs |
Возвращает команды в режиме конструктора, поддерживаемые компонентом, связанным с конструктором. (Унаследовано от ComponentDesigner) |
View |
Получает или задает серверный веб-элемент управления, который может быть использован для предварительного просмотра разметки HTML времени разработки. (Унаследовано от ControlDesigner) |
View |
Получает или задает значение, указывающее, создан ли элемент управления |
Visible |
Получает значение, указывающее, является ли элемент управления видимым во время разработки. (Унаследовано от ControlDesigner) |
Create |
Создает разметку HTML для отображения указанного сообщения об ошибке во время разработки. (Унаследовано от ControlDesigner) |
Create |
Создает разметку HTML для отображения во время разработки указанного сообщения об ошибке, вызванной исключением. (Унаследовано от ControlDesigner) |
Create |
Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления. (Унаследовано от ControlDesigner) |
Create |
Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления, а также дополнительно указанные инструкции или сведения. (Унаследовано от ControlDesigner) |
Create |
Возвращает копию связанного элемента управления для просмотра или отрисовки в рабочей области конструирования. (Унаследовано от ControlDesigner) |
Dispose() |
Освобождает все ресурсы, занятые модулем ComponentDesigner. (Унаследовано от ComponentDesigner) |
Dispose(Boolean) |
Освобождает неуправляемые (а при необходимости и управляемые) ресурсы, используемые объектом HtmlControlDesigner. (Унаследовано от HtmlControlDesigner) |
Do |
Создает в файле с исходным кодом подпись метода для события по умолчанию для компонента и устанавливает курсор в позицию, где была создана эта подпись. (Унаследовано от ComponentDesigner) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
Get |
Получает координаты прямоугольника, представляющего границы элемента управления, когда он отображается в рабочей области конструирования. (Унаследовано от ControlDesigner) |
Get |
Получает разметку, используемую для отрисовки связанного элемента управления во время разработки. |
Get |
Получает разметку HTML для отображения элемента управления и заполняет коллекцию текущими областями конструктора элемента управления. (Унаследовано от ControlDesigner) |
Get |
Возвращает содержимое редактируемой области представления времени разработки связанного элемента управления. (Унаследовано от ControlDesigner) |
Get |
Извлекает разметку HTML, используемую для представления северного веб-элемента управления во время разработки, у которого не будет визуального представления во время выполнения. (Унаследовано от ControlDesigner) |
Get |
Получает HTML-разметку, которая предоставляет сведения об указанном исключении. (Унаследовано от ControlDesigner) |
Get |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
Get |
Получает сохраненную внутреннюю разметку HTML элемента управления во время разработки. (Унаследовано от ControlDesigner) |
Get |
Устаревшие..
Получает сохраненную внутреннюю разметку HTML элемента управления. (Унаследовано от ControlDesigner) |
Get |
Пытается извлечь службу заданного типа с узла режима разработки компонента конструктора. (Унаследовано от ComponentDesigner) |
Get |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
Get |
Получает объект, содержащий разметку времени разработки для содержимого и областей сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
Initialize(IComponent) |
Инициализирует конструктор элементов управления и загружает указанный компонент. (Унаследовано от ControlDesigner) |
Initialize |
Выполняет повторную инициализацию существующего компонента. (Унаследовано от ComponentDesigner) |
Initialize |
Инициализирует только что созданный компонент. (Унаследовано от ComponentDesigner) |
Initialize |
Устаревшие..
Устаревшие..
Инициализирует параметры импортированного компонента, параметры которого уже были инициализированы с использованием параметров, отличных от заданных по умолчанию. (Унаследовано от ComponentDesigner) |
Invalidate() |
Делает недействительной целую область элемента управления, отображаемого в рабочей области конструирования, и сигнализирует конструктору элементов управления о необходимости перерисовки элемента управления. (Унаследовано от ControlDesigner) |
Invalidate(Rectangle) |
Делает недействительной указанную область элемента управления, отображаемого в рабочей области конструирования, и сигнализирует конструктору элемента управления о необходимости перерисовки элемента управления. (Унаследовано от ControlDesigner) |
Invoke |
Возвращает атрибут InheritanceAttribute заданного объекта ComponentDesigner. (Унаследовано от ComponentDesigner) |
Is |
Устаревшие..
Получает значение, указывающее, является ли указанное свойство сопоставленного элемента управления привязанным к данным. (Унаследовано от ControlDesigner) |
Localize(IDesign |
Использует предоставленный модуль записи ресурсов для сохранения локализуемых свойств сопоставленного элемента управления в ресурсе основного приложения разработки. (Унаследовано от ControlDesigner) |
Memberwise |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
On |
Вызывается, когда предварительно определенная схема автоматического форматирования применяется к сопоставленному элементу управления. (Унаследовано от ControlDesigner) |
On |
Вызывается, когда конструктор элемента управления вложен в объект Behavior. (Унаследовано от ControlDesigner) |
On |
Устаревшие..
Вызывается при разрыве связи поведения и элемента. (Унаследовано от HtmlControlDesigner) |
On |
Устаревшие..
Вызывается при изменении коллекции привязки данных. (Унаследовано от ControlDesigner) |
On |
Вызывается основным приложением разработки, когда пользователь во время разработки щелкает сопоставленный элемент управления. (Унаследовано от ControlDesigner) |
On |
Вызывается при изменении сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
On |
Предоставляет метод, обрабатывающий событие ComponentChanging для сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
On |
Устаревшие..
Вызывается, когда изменяется размер сопоставленного серверного веб-элемента управления в основном приложении разработки во время разработки. (Унаследовано от ControlDesigner) |
On |
Вызывается, когда конструктор элементов управления прорисовывает сопоставленный элемент управления в рабочей области конструирования, если значением поля CustomPaint является |
On |
Устаревшие..
Устаревшие..
Задает для компонента свойства по умолчанию. (Унаследовано от ComponentDesigner) |
On |
Предоставляет способ выполнения дополнительной обработки, когда сопоставленный элемент управления сопоставляется с родительским элементом управления. (Унаследовано от HtmlControlDesigner) |
Post |
Позволяет конструктору изменять или удалять элементы из набора атрибутов, предоставленных через класс TypeDescriptor. (Унаследовано от ComponentDesigner) |
Post |
Позволяет конструктору изменять или удалять элементы из набора событий, предоставленных через класс TypeDescriptor. (Унаследовано от ComponentDesigner) |
Post |
Позволяет конструктору изменять или удалять элементы из набора свойств, предоставленных с использованием класса TypeDescriptor. (Унаследовано от ComponentDesigner) |
Pre |
Позволяет конструктору добавлять элементы к набору атрибутов, предоставленному с использованием класса TypeDescriptor. (Унаследовано от ComponentDesigner) |
Pre |
Определяет список событий, предоставляемых во время разработки для объекта TypeDescriptor компонента. (Унаследовано от HtmlControlDesigner) |
Pre |
Добавляет свойства в сетку свойств в основном приложении разработки во время разработки или удаляет их из этой сетки либо предоставляет новые свойства времени разработки, которые могут соответствовать свойствам сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
Raise |
Уведомляет службу IComponentChangeService о том, что данный компонент был изменен. (Унаследовано от ComponentDesigner) |
Raise |
Уведомляет службу IComponentChangeService о том, что компонент будет изменен. (Унаследовано от ComponentDesigner) |
Raise |
Устаревшие..
Вызывает событие OnControlResize(). (Унаследовано от ControlDesigner) |
Register |
Регистрирует внутренние данные в клонированном элементе управления. (Унаследовано от ControlDesigner) |
Set |
Указывает содержимое редактируемой области элемента управления во время разработки. (Унаследовано от ControlDesigner) |
Set |
Указывает содержимое редактируемой области в представлении времени разработки элемента управления. (Унаследовано от ControlDesigner) |
Set |
Назначает указанное битовое перечисление ViewFlags указанному значению флага. (Унаследовано от ControlDesigner) |
To |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Update |
Обновляет разметку HTML времени разработки для сопоставленного серверного веб-элемента управления посредством вызова метода GetDesignTimeHtml. (Унаследовано от ControlDesigner) |
Өнім | Нұсқалар |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET кері байланысы
.NET — бастапқы коды ашық жоба. Пікір қалдыру үшін сілтемені таңдаңыз: