ContainerControlDesigner Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des fonctionnalités de concepteur pour les contrôles qui contiennent des contrôles enfants ou des propriétés qui peuvent être modifiés au moment du design.
public ref class ContainerControlDesigner : System::Web::UI::Design::ControlDesignerpublic class ContainerControlDesigner : System.Web.UI.Design.ControlDesignertype ContainerControlDesigner = class
inherit ControlDesignerPublic Class ContainerControlDesigner
Inherits ControlDesigner- Héritage
- Dérivé
Exemples
L’exemple de code suivant montre comment dériver une classe de concepteur de la ContainerControlDesigner classe. L’exemple définit un contrôle simple dérivé de la CompositeControl classe, puis définit un concepteur associé, dérivé de la ContainerControlDesigner classe. La classe de concepteur dérivée remplace les propriétés et FrameCaption les FrameStyle propriétés pour personnaliser le cadre autour de la zone modifiable du contrôle sur l’aire de conception.
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
Remarques
La ContainerControlDesigner classe fournit une classe de concepteur de base pour les contrôles qui peuvent être modifiés sur l’aire de conception. Cela inclut les contrôles qui contiennent des contrôles enfants ou des propriétés internes modifiables. Il ContainerControlDesigner fournit une seule région encadrée pour représenter le contrôle et gère automatiquement le rendu du contrôle au moment du design.
Appliquez l’attribut ParseChildrenAttribute sur le contrôle associé pour déterminer le comportement au moment du design du ContainerControlDesigner. Appliquez les ParseChildrenAttribute paramètres sur le contrôle associé comme suit :
falsepour indiquer que le ContainerControlDesigner contenu de la zone de conception modifiable en tant que contrôles enfants représente le contenu de la zone de conception modifiable.truepour indiquer que le ContainerControlDesigner contenu de la zone de conception modifiable est modifiable en tant que propriétés internes modifiables du contrôle.
Les développeurs de contrôles peuvent dériver et étendre un concepteur personnalisé à partir d’un de plusieurs concepteurs de base en fonction du type de contrôle en cours de développement, tel que défini dans la liste suivante :
Les contrôles qui permettent aux contrôles enfants d’être ajoutés au moment du design peuvent dériver de la ContainerControlDesigner classe. Par exemple, la PanelContainerDesigner classe est dérivée de la ContainerControlDesigner classe et représente un Panel contrôle sur l’aire de conception.
Les contrôles qui ont un ou plusieurs contrôles enfants et peuvent également avoir une région de concepteur modifiable où les contrôles peuvent être ajoutés au moment du design, peuvent dériver de la CompositeControlDesigner classe.
Les contrôles qui nécessitent un traitement personnalisé au moment du design peuvent dériver de la classe de base ControlDesigner .
Note
La ContainerControlDesigner classe remplace la classe obsolète ReadWriteControlDesigner .
Utilisez l’attribut DesignerAttribute pour associer une classe de concepteur personnalisé à une implémentation de contrôle personnalisée. Pour plus d’informations sur l’utilisation des concepteurs de contrôles avec des contrôles personnalisés, consultez Procédure pas à pas : Création d’un Concepteur de contrôles de base pour un contrôle serveur web.
Constructeurs
| Nom | Description |
|---|---|
| ContainerControlDesigner() |
Initialise une nouvelle instance de la classe ContainerControlDesigner. |
Propriétés
| Nom | Description |
|---|---|
| ActionLists |
Obtient la collection de listes d’actions pour le concepteur de contrôles. (Hérité de ControlDesigner) |
| AllowResize |
Obtient une valeur indiquant si le contrôle peut être redimensionné au moment du design. |
| AssociatedComponents |
Obtient la collection de composants associés au composant géré par le concepteur. (Hérité de ComponentDesigner) |
| AutoFormats |
Obtient la collection de schémas de mise en forme automatique prédéfinis à afficher dans la boîte de dialogue Mise en forme automatique du contrôle associé au moment du design. (Hérité de ControlDesigner) |
| Behavior |
Obsolète.
Obtient ou définit le comportement DHTML associé au concepteur. (Hérité de HtmlControlDesigner) |
| Component |
Obtient le composant que ce concepteur conçoit. (Hérité de ComponentDesigner) |
| DataBindings |
Obtient la collection de liaisons de données pour le contrôle actuel. (Hérité de HtmlControlDesigner) |
| DataBindingsEnabled |
Obtient une valeur indiquant si la liaison de données est prise en charge par la région conteneur du contrôle associé. (Hérité de ControlDesigner) |
| DesignerState |
Obtient un objet utilisé pour conserver les données du contrôle associé au moment du design. (Hérité de ControlDesigner) |
| DesignTimeElement |
Obsolète.
Obtient l’objet au moment du design représentant le contrôle associé à l’objet HtmlControlDesigner sur l’aire de conception. (Hérité de HtmlControlDesigner) |
| DesignTimeElementView |
Obsolète.
Obtient l’objet de contrôle d’affichage pour le concepteur de contrôles. (Hérité de ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Obsolète.
Obtient une valeur indiquant si l’hôte de conception doit terminer le chargement avant que la GetDesignTimeHtml méthode puisse être appelée. (Hérité de ControlDesigner) |
| Expressions |
Obtient les liaisons d’expression pour le contrôle actuel au moment du design. (Hérité de HtmlControlDesigner) |
| FrameCaption |
Obtient la légende affichée pour un contrôle au moment du design. |
| FrameStyle |
Obtient le style appliqué à l’image de contrôle au moment du design. |
| HidePropertiesInTemplateMode |
Obtient une valeur indiquant si les propriétés du contrôle associé sont masquées lorsque le contrôle est en mode modèle. (Hérité de ControlDesigner) |
| ID |
Obtient ou définit la chaîne d’ID du contrôle. (Hérité de ControlDesigner) |
| InheritanceAttribute |
Obtient un attribut qui indique le type d’héritage du composant associé. (Hérité de ComponentDesigner) |
| Inherited |
Obtient une valeur indiquant si ce composant est hérité. (Hérité de ComponentDesigner) |
| InTemplateMode |
Obtient une valeur indiquant si le contrôle est en mode d’affichage ou d’édition de modèle dans l’hôte de conception. La propriété InTemplateMode est en lecture seule. (Hérité de ControlDesigner) |
| IsDirty |
Obsolète.
Obtient ou définit une valeur indiquant si le contrôle serveur Web a été marqué comme modifié. (Hérité de ControlDesigner) |
| NoWrap |
Obtient une valeur qui spécifie s’il faut utiliser l’attribut HTML |
| ParentComponent |
Obtient le composant parent de ce concepteur. (Hérité de ComponentDesigner) |
| ReadOnly |
Obsolète.
Obtient ou définit une valeur indiquant si les propriétés du contrôle sont en lecture seule au moment du design. (Hérité de ControlDesigner) |
| RootDesigner |
Obtient le concepteur de contrôles de la page Web Forms qui contient le contrôle associé. (Hérité de ControlDesigner) |
| ShadowProperties |
Obtient une collection de valeurs de propriété qui remplacent les paramètres utilisateur. (Hérité de ComponentDesigner) |
| ShouldCodeSerialize |
Obsolète.
Obtient ou définit une valeur indiquant s’il faut créer une déclaration de champ pour le contrôle dans le fichier code-behind du document de conception actuel lors de la sérialisation. (Hérité de HtmlControlDesigner) |
| Tag |
Obtient un objet représentant l’élément de balisage HTML pour le contrôle associé. (Hérité de ControlDesigner) |
| TemplateGroups |
Obtient une collection de groupes de modèles, chacune contenant une ou plusieurs définitions de modèle. (Hérité de ControlDesigner) |
| UsePreviewControl |
Obtient une valeur indiquant si le concepteur de contrôles utilise un contrôle d’aperçu temporaire pour générer le balisage HTML au moment du design. (Hérité de ControlDesigner) |
| Verbs |
Obtient les verbes au moment du design pris en charge par le composant associé au concepteur. (Hérité de ComponentDesigner) |
| ViewControl |
Obtient ou définit un contrôle de serveur Web qui peut être utilisé pour afficher un aperçu du balisage HTML au moment du design. (Hérité de ControlDesigner) |
| ViewControlCreated |
Obtient ou définit une valeur indiquant si un |
| Visible |
Obtient une valeur qui indique si le contrôle est visible au moment du design. (Hérité de ControlDesigner) |
Méthodes
| Nom | Description |
|---|---|
| AddDesignTimeCssAttributes(IDictionary) |
Ajoute les attributs de style pour le contrôle au moment du design. |
| CreateErrorDesignTimeHtml(String, Exception) |
Crée le balisage HTML pour afficher un message d’erreur d’exception spécifié au moment du design. (Hérité de ControlDesigner) |
| CreateErrorDesignTimeHtml(String) |
Crée un balisage HTML pour afficher un message d’erreur spécifié au moment du design. (Hérité de ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Fournit une représentation d’espace réservé rectangulaire simple qui affiche le type et l’ID du contrôle. (Hérité de ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Fournit une représentation d’espace réservé rectangulaire simple qui affiche le type et l’ID du contrôle, ainsi que des instructions ou des informations spécifiées supplémentaires. (Hérité de ControlDesigner) |
| CreateViewControl() |
Retourne une copie du contrôle associé pour l’affichage ou le rendu sur l’aire de conception. (Hérité de ControlDesigner) |
| Dispose() |
Libère toutes les ressources utilisées par le ComponentDesigner. (Hérité de ComponentDesigner) |
| Dispose(Boolean) |
Libère les ressources non managées utilisées par l’objet HtmlControlDesigner et libère éventuellement les ressources managées. (Hérité de HtmlControlDesigner) |
| DoDefaultAction() |
Crée une signature de méthode dans le fichier de code source pour l’événement par défaut sur le composant et accède au curseur de l’utilisateur à cet emplacement. (Hérité de ComponentDesigner) |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetBounds() |
Récupère les coordonnées du rectangle représentant les limites du contrôle, comme indiqué sur l’aire de conception. (Hérité de ControlDesigner) |
| GetDesignTimeCssAttributes() |
Retourne la collection d’attributs de style pour le contrôle au moment du design. |
| GetDesignTimeHtml() |
Récupère le balisage HTML utilisé pour représenter le contrôle au moment du design. (Hérité de ControlDesigner) |
| GetDesignTimeHtml(DesignerRegionCollection) |
Retourne le balisage HTML utilisé pour représenter le contrôle au moment du design. |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Retourne le contenu de la région modifiable du contrôle au moment du design. |
| GetEmptyDesignTimeHtml() |
Récupère le balisage HTML pour représenter un contrôle serveur Web au moment du design qui n’aura aucune représentation visuelle au moment de l’exécution. (Hérité de ControlDesigner) |
| GetErrorDesignTimeHtml(Exception) |
Récupère le balisage HTML qui fournit des informations sur l’exception spécifiée. (Hérité de ControlDesigner) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetPersistenceContent() |
Retourne le contenu persistant du contrôle au moment du design. |
| GetPersistInnerHtml() |
Obsolète.
Récupère le balisage HTML interne persistant du contrôle. (Hérité de ControlDesigner) |
| GetService(Type) |
Tente de récupérer le type de service spécifié à partir du site en mode conception du composant du concepteur. (Hérité de ComponentDesigner) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| GetViewRendering() |
Récupère un objet qui contient le balisage au moment du design pour le contenu et les régions du contrôle associé. (Hérité de ControlDesigner) |
| Initialize(IComponent) |
Initialise le concepteur de contrôles et charge le composant spécifié. (Hérité de ControlDesigner) |
| InitializeExistingComponent(IDictionary) |
Réinitialise un composant existant. (Hérité de ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Initialise un composant nouvellement créé. (Hérité de ComponentDesigner) |
| InitializeNonDefault() |
Obsolète.
Obsolète.
Initialise les paramètres d’un composant importé qui est déjà initialisé dans des paramètres autres que les paramètres par défaut. (Hérité de ComponentDesigner) |
| Invalidate() |
Invalide toute la zone du contrôle affichée sur l’aire de conception et signale au concepteur de contrôles de redessiner le contrôle. (Hérité de ControlDesigner) |
| Invalidate(Rectangle) |
Invalide la zone spécifiée du contrôle affichée sur l’aire de conception et signale au concepteur de contrôles de redessiner le contrôle. (Hérité de ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Obtient le InheritanceAttributeComponentDesigner. (Hérité de ComponentDesigner) |
| IsPropertyBound(String) |
Obsolète.
Récupère une valeur indiquant si la propriété spécifiée sur le contrôle associé est liée aux données. (Hérité de ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Utilise l’enregistreur de ressources fourni pour conserver les propriétés localisables du contrôle associé à une ressource dans l’hôte de conception. (Hérité de ControlDesigner) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Appelé lorsqu’un schéma de mise en forme automatique prédéfini a été appliqué au contrôle associé. (Hérité de ControlDesigner) |
| OnBehaviorDetaching() |
Obsolète.
Appelé lorsqu’un comportement dissocie de l’élément. (Hérité de HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Obsolète.
Appelé lorsque la collection de liaisons de données change. (Hérité de ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Appelé par l’hôte de conception lorsque l’utilisateur clique sur le contrôle associé au moment du design. (Hérité de ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Appelé lorsque le contrôle associé change. (Hérité de ControlDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Représente la méthode qui gère l’événement ComponentChanging pour le contrôle associé. (Hérité de ControlDesigner) |
| OnControlResize() |
Obsolète.
Appelé lorsque le contrôle serveur Web associé a été redimensionné dans l’hôte de conception au moment du design. (Hérité de ControlDesigner) |
| OnPaint(PaintEventArgs) |
Appelé lorsque le concepteur de contrôles dessine le contrôle associé sur l’aire de conception, si la CustomPaint valeur est |
| OnSetComponentDefaults() |
Obsolète.
Obsolète.
Définit les propriétés par défaut du composant. (Hérité de ComponentDesigner) |
| OnSetParent() |
Fournit un moyen d’effectuer un traitement supplémentaire lorsque le contrôle associé est attaché à un contrôle parent. (Hérité de HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
Permet à un concepteur de modifier ou de supprimer des éléments de l’ensemble d’attributs qu’il expose par le biais d’un TypeDescriptor. (Hérité de ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Permet à un concepteur de modifier ou de supprimer des éléments de l’ensemble d’événements qu’il expose par le biais d’un TypeDescriptor. (Hérité de ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Permet à un concepteur de modifier ou de supprimer des éléments de l’ensemble de propriétés qu’il expose par le biais d’un TypeDescriptor. (Hérité de ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Permet à un concepteur d’ajouter à l’ensemble d’attributs qu’il expose par le biais d’un TypeDescriptor. (Hérité de ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Définit la liste des événements exposés au moment du design pour l’objet TypeDescriptor du composant. (Hérité de HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Ajoute ou supprime des propriétés de la grille Propriétés dans un hôte de conception au moment du design ou fournit de nouvelles propriétés au moment du design qui peuvent correspondre aux propriétés du contrôle associé. (Hérité de ControlDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Avertit que IComponentChangeService ce composant a été modifié. (Hérité de ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Avertit que IComponentChangeService ce composant est sur le point d’être modifié. (Hérité de ComponentDesigner) |
| RaiseResizeEvent() |
Obsolète.
Déclenche l’événement OnControlResize(). (Hérité de ControlDesigner) |
| RegisterClone(Object, Object) |
Inscrit des données internes dans un contrôle cloné. (Hérité de ControlDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Définit le contenu de la région modifiable du contrôle au moment du design. |
| SetRegionContent(EditableDesignerRegion, String) |
Spécifie le contenu d’une région modifiable dans l’affichage au moment du design du contrôle. (Hérité de ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Affecte l’énumération au niveau ViewFlags du bit spécifiée à la valeur d’indicateur spécifiée. (Hérité de ControlDesigner) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| UpdateDesignTimeHtml() |
Actualise le balisage HTML au moment du design pour le contrôle serveur Web associé en appelant la GetDesignTimeHtml méthode. (Hérité de ControlDesigner) |
