PanelContainerDesigner Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет поддержку во время разработки в визуальном конструкторе для элемента управления Panel.
public ref class PanelContainerDesigner : System::Web::UI::Design::ContainerControlDesigner
public class PanelContainerDesigner : System.Web.UI.Design.ContainerControlDesigner
type PanelContainerDesigner = class
inherit ContainerControlDesigner
Public Class PanelContainerDesigner
Inherits ContainerControlDesigner
- Наследование
-
PanelContainerDesigner
Примеры
В следующем примере кода показано, как расширить PanelContainerDesigner класс для изменения внешнего вида и поведения элементов управления, производных от элемента управления во время разработки Panel .
В этом примере класс является производным MyPanelContainer
от Panel элемента управления . В примере также наследуется MyPanelContainerDesigner
класс от PanelContainerDesigner класса и применяется DesignerAttribute атрибут для MyPanelContainerDesigner
к классу MyPanelContainer
.
переопределяет MyPanelContainerDesigner
следующие PanelContainerDesigner элементы:
Свойство FrameStyle , определяющее стиль границы во время разработки
MyPanelContainer
для элемента управления .Свойство FrameCaption для предоставления подпись по умолчанию для
MyPanelContainer
элемента управления, если он не определен.Метод Initialize для создания ArgumentException исключения, если связанный элемент управления не
MyPanelContainer
является объектом .
using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.ComponentModel;
using System.Security.Permissions;
namespace Examples.CS.WebControls.Design
{
// The MyPanelContainer is a copy of the Panel.
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(Examples.CS.WebControls.Design.MyPanelContainerDesigner))]
public class MyPanelContainer : Panel
{
} // MyPanelContainer
// Override members of the PanelContainerDesigner.
public class MyPanelContainerDesigner : PanelContainerDesigner
{
// Provide a design-time caption for the panel.
public override string FrameCaption
{
get
{
// If the FrameCaption is empty, use the panel control ID.
string localCaption = base.FrameCaption;
if (localCaption == null || localCaption == "")
localCaption = ((Panel)Component).ID.ToString();
return localCaption;
}
} // FrameCaption
// Provide a design-time border style for the panel.
public override Style FrameStyle
{
get
{
Style styleOfFrame = base.FrameStyle;
// If no border style is defined, define one.
if (styleOfFrame.BorderStyle == BorderStyle.NotSet ||
styleOfFrame.BorderStyle == BorderStyle.None)
styleOfFrame.BorderStyle = BorderStyle.Outset;
return styleOfFrame;
}
} // FrameStyle
// Initialize the designer.
public override void Initialize(IComponent component)
{
// Ensure that only a MyPanelContainer can be created
// in this designer.
if (!(component is MyPanelContainer))
throw new ArgumentException();
base.Initialize(component);
} // Initialize
} // MyPanelContainerDesigner
} // Examples.CS.WebControls.Design
Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.ComponentModel
Imports System.Security.Permissions
Namespace Examples.VB.WebControls.Design
' The MyPanelContainer is a copy of the PanelContainer.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<Designer(GetType(Examples.VB.WebControls.Design.MyPanelContainerDesigner))> _
Public Class MyPanelContainer
Inherits Panel
End Class
' Override members of the PanelContainerDesigner.
Public Class MyPanelContainerDesigner
Inherits PanelContainerDesigner
' Provide a design-time caption for the panel.
Public Overrides ReadOnly Property FrameCaption() As String
Get
' If the FrameCaption is empty, use the panel control ID.
Dim localCaption As String = MyBase.FrameCaption
If localCaption Is Nothing Or localCaption = "" Then
localCaption = CType(Component, Panel).ID.ToString()
End If
Return localCaption
End Get
End Property ' FrameCaption
' Provide a design-time border style for the panel.
Public Overrides ReadOnly Property FrameStyle() As Style
Get
Dim styleOfFrame As Style = MyBase.FrameStyle
' If no border style is defined, define one.
If (styleOfFrame.BorderStyle = BorderStyle.NotSet Or _
styleOfFrame.BorderStyle = BorderStyle.None) Then
styleOfFrame.BorderStyle = BorderStyle.Outset
End If
Return styleOfFrame
End Get
End Property ' FrameStyle
' Initialize the designer.
Public Overrides Sub Initialize(ByVal component As IComponent)
' Ensure that only a MyPanelContainer can be created
' in this designer.
If Not TypeOf component Is MyPanelContainer Then
Throw New ArgumentException()
End If
MyBase.Initialize(component)
End Sub
End Class
End Namespace ' Examples.VB.WebControls.Design
Комментарии
Элемент Panel управления используется в качестве контейнера для других элементов управления, особенно если элементы управления создаются программным способом.
В визуальном конструкторе при переключении из исходного представления в конструктор исходный код разметки, описывающий связанный Panel элемент управления, анализируется, и в области конструктора создается версия элемента управления во время разработки. При переключении обратно в представление источника элемент управления времени разработки сохраняется в исходном коде разметки и редактируется в разметке для веб-страницы. Класс PanelContainerDesigner обеспечивает поддержку Panel элементов управления в визуальном конструкторе во время разработки.
Свойство FrameCaption получает подпись, который отображается в связанном Panel элементе управления. Свойство FrameStyle получает стили связанного элемента управления.
Свойство UsePreviewControl всегда возвращает true
значение , указывающее, что конструктор создает временную копию связанного Panel объекта для создания разметки времени разработки.
Метод Initialize подготавливает конструктор к просмотру, редактированию и проектированию связанного Panel элемента управления. Метод AddDesignTimeCssAttributes задает для элементов коллекции строковые представления различных атрибутов стиля связанного элемента управления.
Конструкторы
PanelContainerDesigner() |
Инициализирует новый экземпляр класса PanelContainerDesigner. |
Свойства
ActionLists |
Получает коллекцию списков действий для конструктора элементов управления. (Унаследовано от ControlDesigner) |
AllowResize |
Возвращает значение, показывающее, можно ли изменить размеры элемента управления во время разработки. (Унаследовано от ContainerControlDesigner) |
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) |
FrameCaption |
Получает заголовок, который отображается в сопоставленном элементе управления Panel. |
FrameStyle |
Получает стили сопоставленного элемента управления Panel. |
HidePropertiesInTemplateMode |
Получает значение, указывающее, скрыты ли свойства сопоставленного элемента управления, когда он находится в режиме шаблона. (Унаследовано от ControlDesigner) |
ID |
Получает или задает строку идентификатора элемента управления. (Унаследовано от ControlDesigner) |
InheritanceAttribute |
Возвращает атрибут, обозначающий тип наследования связанного компонента. (Унаследовано от ComponentDesigner) |
Inherited |
Возвращает значение, определяющее, наследуется ли этот компонент или нет. (Унаследовано от ComponentDesigner) |
InTemplateMode |
получает значение, указывающее, находится ли элемент управления в режиме просмотра или редактирования шаблона в основном приложении разработки. Свойство InTemplateMode доступно только для чтения. (Унаследовано от ControlDesigner) |
IsDirty |
Устаревшие..
Получает или задает значение, указывающее наличие отметки об изменении серверного веб-элемента управления. (Унаследовано от ControlDesigner) |
NoWrap |
Получает значение, которое определяет, следует ли использовать атрибут HTML |
ParentComponent |
Возвращает родительский компонент этого конструктора. (Унаследовано от ComponentDesigner) |
ReadOnly |
Устаревшие..
Получает или задает значение, указывающее, доступны ли только для чтения свойства элемента управления во время разработки. (Унаследовано от ControlDesigner) |
RootDesigner |
Получает конструктор элементов управления для страницы веб-форм, содержащей сопоставленный элемент управления. (Унаследовано от ControlDesigner) |
SetTextualDefaultProperty |
Предоставляет поддержку во время разработки в визуальном конструкторе для элемента управления Panel. (Унаследовано от ComponentDesigner) |
ShadowProperties |
Возвращает коллекцию значений свойств, переопределяющих параметры пользователя. (Унаследовано от ComponentDesigner) |
ShouldCodeSerialize |
Устаревшие..
Получает или задает значение, показывающее, создавать ли объявление поля для элемента управления в файле кода программной части для текущего документа разработки во время сериализации. (Унаследовано от HtmlControlDesigner) |
Tag |
Получает объект, представляющей элемент разметки HTML для сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
TemplateGroups |
Получает коллекцию групп шаблонов, каждая из которых содержит одно или несколько определений шаблонов. (Унаследовано от ControlDesigner) |
UsePreviewControl |
Получает значение, указывающее, должен ли конструктор использовать при создании разметки времени разработки временную копию вместо фактического элемента управления. |
Verbs |
Возвращает команды в режиме конструктора, поддерживаемые компонентом, связанным с конструктором. (Унаследовано от ComponentDesigner) |
ViewControl |
Получает или задает серверный веб-элемент управления, который может быть использован для предварительного просмотра разметки HTML времени разработки. (Унаследовано от ControlDesigner) |
ViewControlCreated |
Получает или задает значение, указывающее, создан ли элемент управления |
Visible |
Получает значение, указывающее, является ли элемент управления видимым во время разработки. (Унаследовано от ControlDesigner) |
Методы
AddDesignTimeCssAttributes(IDictionary) |
Добавляет строковые представления атрибутов стиля в коллекцию, которая должна использоваться при отрисовке элемента управления во время разработки. |
CreateErrorDesignTimeHtml(String) |
Создает разметку HTML для отображения указанного сообщения об ошибке во время разработки. (Унаследовано от ControlDesigner) |
CreateErrorDesignTimeHtml(String, Exception) |
Создает разметку HTML для отображения во время разработки указанного сообщения об ошибке, вызванной исключением. (Унаследовано от ControlDesigner) |
CreatePlaceHolderDesignTimeHtml() |
Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления. (Унаследовано от ControlDesigner) |
CreatePlaceHolderDesignTimeHtml(String) |
Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления, а также дополнительно указанные инструкции или сведения. (Унаследовано от ControlDesigner) |
CreateViewControl() |
Возвращает копию связанного элемента управления для просмотра или отрисовки в рабочей области конструирования. (Унаследовано от ControlDesigner) |
Dispose() |
Освобождает все ресурсы, занятые модулем ComponentDesigner. (Унаследовано от ComponentDesigner) |
Dispose(Boolean) |
Освобождает неуправляемые (а при необходимости и управляемые) ресурсы, используемые объектом HtmlControlDesigner. (Унаследовано от HtmlControlDesigner) |
DoDefaultAction() |
Создает в файле с исходным кодом подпись метода для события по умолчанию для компонента и устанавливает курсор в позицию, где была создана эта подпись. (Унаследовано от ComponentDesigner) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetBounds() |
Получает координаты прямоугольника, представляющего границы элемента управления, когда он отображается в рабочей области конструирования. (Унаследовано от ControlDesigner) |
GetDesignTimeCssAttributes() |
Возвращает коллекцию атрибутов стиля для элемента управления во время разработки. (Унаследовано от ContainerControlDesigner) |
GetDesignTimeHtml() |
Получает HTML-разметку, используемую для представления элемента управления во время разработки. (Унаследовано от ControlDesigner) |
GetDesignTimeHtml(DesignerRegionCollection) |
Возвращает HTML-разметку, используемую для отображения элемента управления во время разработки. (Унаследовано от ContainerControlDesigner) |
GetEditableDesignerRegionContent(EditableDesignerRegion) |
Возвращает содержимое редактируемой области элемента управления во время разработки. (Унаследовано от ContainerControlDesigner) |
GetEmptyDesignTimeHtml() |
Извлекает разметку HTML, используемую для представления северного веб-элемента управления во время разработки, у которого не будет визуального представления во время выполнения. (Унаследовано от ControlDesigner) |
GetErrorDesignTimeHtml(Exception) |
Получает HTML-разметку, которая предоставляет сведения об указанном исключении. (Унаследовано от ControlDesigner) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetPersistenceContent() |
Возвращает сохраняемое содержимое элемента управления на этапе разработки. (Унаследовано от ContainerControlDesigner) |
GetPersistInnerHtml() |
Устаревшие..
Получает сохраненную внутреннюю разметку HTML элемента управления. (Унаследовано от ControlDesigner) |
GetService(Type) |
Пытается извлечь службу заданного типа с узла режима разработки компонента конструктора. (Унаследовано от ComponentDesigner) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
GetViewRendering() |
Получает объект, содержащий разметку времени разработки для содержимого и областей сопоставленного элемента управления. (Унаследовано от ControlDesigner) |
Initialize(IComponent) |
Подготавливает конструктор для просмотра, редактирования и разработки связанного элемента управления. |
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 является |
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) |
Устанавливает содержимое редактируемой области элемента управления во время разработки. (Унаследовано от ContainerControlDesigner) |
SetRegionContent(EditableDesignerRegion, String) |
Указывает содержимое редактируемой области в представлении времени разработки элемента управления. (Унаследовано от ControlDesigner) |
SetViewFlags(ViewFlags, Boolean) |
Назначает указанное битовое перечисление ViewFlags указанному значению флага. (Унаследовано от ControlDesigner) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
UpdateDesignTimeHtml() |
Обновляет разметку HTML времени разработки для сопоставленного серверного веб-элемента управления посредством вызова метода GetDesignTimeHtml. (Унаследовано от ControlDesigner) |
Явные реализации интерфейса
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по