Partager via

DesignSurface Classe

Définition

Espace de noms:
System.ComponentModel.Design
Assembly:
System.Design.dll
Assembly:
System.Windows.Forms.Design.dll
Assemblys:
System.Design.dll, System.Windows.Forms.Design.dll
Source:
DesignSurface.cs
Source:
DesignSurface.cs
Source:
DesignSurface.cs
Source:
DesignSurface.cs
Source:
DesignSurface.cs

Présente une interface utilisateur pour la conception de 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
Object
DesignSurface
Attributs
SecurityCriticalAttribute
Implémente
IDisposable IServiceProvider

Remarques

La DesignSurface classe implémente ce que l’utilisateur considère 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 comme concepteur autonome, ou elle peut être couplé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 dériver une nouvelle classe de celui-ci 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 des modifications par le biais de la propriété protégée ServiceContainer . Tous les services ajoutés au conteneur de service et qui IDisposable sont supprimés lorsque l’aire de conception est supprimée. L’ensemble par défaut de services remplaçables fournis par la DesignSurface classe est indiqué 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 de 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 siteés.
DesignSurface Offre l’aire de conception elle-même en tant que service.
DesignerOptionService Fournit une classe de base pour obtenir et définir des valeurs d’option pour 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 qui sont conçus. Chaque concepteur possède les IContainer composants.
IServiceContainer Dérive et IServiceProvider 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 peuvent être utilisées 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 vous ne souhaitez pas que la région participe à la sérialisation.

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

Avertissement

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 il s’agit d’un service spécifique au site. Avec ce service, vous pouvez ajouter des services spécifiques au site supplémentaires.

Constructeurs

Nom Description
DesignSurface()

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

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

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

Initialise une nouvelle instance de la classe DesignSurface.

Propriétés

Nom Description
ComponentContainer

Obtient l’implémentation IContainer dans l’aire de conception.
DtelLoading

Obtient une valeur indiquant si la liste d’erreurs au moment du design est chargée.
IsLoaded

Obtient une valeur indiquant si l’aire de conception est actuellement chargée.
LoadErrors

Retourne une collection d’erreurs de chargement ou d’une collection void.
ServiceContainer

Obtient le conteneur de service.
View

Obtient l’affichage du concepteur racine.

Méthodes

Nom Description
BeginLoad(DesignerLoader)

Commence le processus de chargement avec 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, String)

Crée un conteneur adapté à l’imbrication de contrôles ou de composants.
CreateNestedContainer(IComponent)

Crée un conteneur adapté à 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 les modifications apportées à l’aire de conception.
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetService(Type)

Obtient un service à partir du conteneur de service.
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(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

Nom Description
Disposed

Se produit lorsque l’aire de conception est supprimée.
Flushed

Se produit lorsqu’un appel est effectué à la Flush() méthode de DesignSurface.
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é le déchargement.
Unloading

Se produit lorsqu’un concepteur est sur le point de décharger.
ViewActivated

Se produit lorsque la Activate() méthode a été appelée sur IDesignerHost.

S’applique à

Voir aussi