DesignSurface Classe

Définition

Espace de noms:

System.ComponentModel.Design

Assembly:

System.Windows.Forms.Design.dll

Présente une interface utilisateur pour concevoir des composants.

public ref class DesignSurface : IDisposable, IServiceProvider

public class DesignSurface : IDisposable, IServiceProvider

type DesignSurface = class
    interface IDisposable
    interface IServiceProvider

Public Class DesignSurface
Implements IDisposable, IServiceProvider

Héritage

Object

DesignSurface

Remarques

La DesignSurface classe implémente ce que l’utilisateur perçoit comme un concepteur. DesignSurface est l’interface utilisateur que l’utilisateur manipule pour modifier les fonctionnalités au moment du design. DesignSurface fournit une surface de conception entièrement autonome.

La DesignSurface classe peut être utilisée en tant que concepteur autonome, ou elle peut être associée à la DesignSurfaceManager classe pour fournir une implémentation commune pour une application qui héberge plusieurs DesignSurface objets.

La DesignSurface classe peut être utilisée par elle-même, ou l’utilisateur peut en dériver une nouvelle classe et augmenter le comportement.

La DesignSurface classe fournit automatiquement plusieurs services au moment du design. La DesignSurface classe ajoute tous ses services dans son constructeur. La plupart de ces services peuvent être remplacés en les remplaçant dans la propriété protégée ServiceContainer . Pour remplacer un service, remplacez le constructeur, appelez la base et apportez toutes les modifications par le biais de la propriété protégée ServiceContainer . Tous les services ajoutés au conteneur de service et qui implémentent IDisposable sont supprimés lorsque l’aire de conception est supprimée. L’ensemble par défaut des services remplaçables que la DesignSurface classe fournit est présenté dans le tableau suivant.

Service	Description
IExtenderProviderService	Permet aux objets qui ne font pas partie de la collection de composants du conteneur de fournir leurs propres fournisseurs d’extendeurs.
IExtenderListService	Utilisé par TypeDescriptor pour obtenir la liste des fournisseurs d’extendeurs. Avec ce service, les fournisseurs d’extendeurs peuvent vivre en dehors du conteneur.
ITypeDescriptorFilterService	Fournit des hooks de métadonnées du concepteur. Il s’agit de l’interface principale pour le filtrage des métadonnées.
ISelectionService	Permet de sélectionner des composants dans le concepteur.
IReferenceService	Fournit un moyen d’obtenir un nom pour les objets, même lorsque ces objets ne sont pas regroupés.
DesignSurface	Offre l’aire de conception elle-même en tant que service.
DesignerOptionService	Fournit une classe de base pour l'obtention et la définition des valeurs des options d'un concepteur.

Le tableau suivant montre les services non remplaçables fournis par défaut.

Service	Description
IComponentChangeService	Déclenche des événements à mesure que des modifications sont apportées aux composants.
IDesignerHost	Contrôle l’accès aux types, services et transactions. Interface principale pour les concepteurs.
IContainer	Possède l’ensemble des composants en cours de conception. Chaque concepteur a un IContainer qui possède les composants.
IServiceContainer	Dérive de IServiceProvider et fournit un moyen d’ajouter et de supprimer des services du concepteur.

En plus de ces services, la DesignSurface classe fournit également un seul service disponible via le site d’un composant. Ce service est unique pour chaque composant. Le tableau suivant montre les services qui ne peuvent pas être remplacés.

Service	Description
IDictionaryService	Dictionnaire générique de paires clé/valeur qui peut être utilisé pour stocker des données arbitraires sur un composant.
INestedContainer	Conteneur qui permet à un composant d’ajouter des composants enfants supplémentaires au concepteur. Ces composants feront partie de l’aire de conception, mais ne participeront pas à la sérialisation. Cela est utile lorsque vous souhaitez concevoir un contrôle capable d’exposer une région d’elle-même dans un concepteur, mais que vous ne souhaitez pas que la région participe à la sérialisation.

En plus de ISite, le site implémente également les interfaces suivantes.

Attention

Vérifiez l’existence de ces interfaces, plutôt que d’utiliser un cast aveugle, car d’autres implémentations de site peuvent ne pas les implémenter.

Service	Description
IServiceContainer	Fournit un moyen d’accéder au conteneur de services spécifiques au site. Par exemple, IDictionaryService est un service spécifique au site. Avec ce service, vous pouvez ajouter des services supplémentaires spécifiques au site.

Constructeurs

DesignSurface()	Initialise une nouvelle instance de la classe DesignSurface.
DesignSurface(IServiceProvider)	Initialise une nouvelle instance de la classe DesignSurface.
DesignSurface(IServiceProvider, Type)	Initialise une nouvelle instance de la classe DesignSurface.
DesignSurface(Type)	Initialise une nouvelle instance de la classe DesignSurface.

Propriétés

ComponentContainer	Obtient l'implémentation de IContainer dans l'aire de conception.
DtelLoading	Obtient une valeur indiquant si la Liste d’erreurs au moment du design se charge.
IsLoaded	Obtient une valeur indiquant si l'aire de conception est actuellement chargée.
LoadErrors	Retourne une collection d'erreurs de chargement ou une collection vide.
ServiceContainer	Obtient le conteneur de services.
View	Obtient l'affichage du concepteur racine.

Méthodes

BeginLoad(DesignerLoader)	Commence le processus de chargement par le chargeur de concepteur donné.
BeginLoad(Type)	Commence le processus de chargement.
CreateComponent(Type)	Obsolète. Crée une instance d'un composant.
CreateDesigner(IComponent, Boolean)	Crée un concepteur lorsqu'un composant est ajouté au conteneur.
CreateInstance(Type)	Crée une instance du type donné.
CreateNestedContainer(IComponent)	Crée un conteneur approprié à l'imbrication de contrôles ou de composants.
CreateNestedContainer(IComponent, String)	Crée un conteneur approprié à l'imbrication de contrôles ou de composants.
Dispose()	Libère les ressources utilisées par le DesignSurface.
Dispose(Boolean)	Libère les ressources utilisées par le DesignSurface.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Flush()	Sérialise des modifications dans l'aire de conception.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetService(Type)	Obtient un service du conteneur de services.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnLoaded(LoadedEventArgs)	Déclenche l’événement Loaded.
OnLoading(EventArgs)	Déclenche l’événement Loading.
OnUnloaded(EventArgs)	Déclenche l’événement Unloaded.
OnUnloading(EventArgs)	Déclenche l’événement Unloading.
OnViewActivate(EventArgs)	Déclenche l’événement ViewActivated.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Événements

Disposed	Se produit lorsque l'aire de conception est supprimée.
Flushed	Se produit lorsque la méthode Flush() de DesignSurface est appelée.
Loaded	Se produit lorsque le chargement du concepteur est terminé.
Loading	Se produit lorsque le concepteur est sur le point d'être chargé.
Unloaded	Se produit lorsqu'un concepteur a terminé un déchargement.
Unloading	Se produit lorsqu'un concepteur est sur le point de décharger.
ViewActivated	Se produit lorsque la méthode Activate() a été appelée sur IDesignerHost.

Voir aussi

• IDesignerHost
• IServiceProvider
• DesignerLoader
• IDesignerLoaderService