DesignSurface Classe

Définition

Présente une interface utilisateur pour concevoir des composants.

public ref class DesignSurface : IDisposable, IServiceProvider
public class DesignSurface : IDisposable, IServiceProvider
[System.Security.SecurityCritical]
public class DesignSurface : IDisposable, IServiceProvider
type DesignSurface = class
    interface IDisposable
    interface IServiceProvider
[<System.Security.SecurityCritical>]
type DesignSurface = class
    interface IDisposable
    interface IServiceProvider
Public Class DesignSurface
Implements IDisposable, IServiceProvider
Héritage
DesignSurface
Attributs
Implémente

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.

S’applique à

Voir aussi