NestedContainer 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 l'implémentation de base pour l'interface INestedContainer qui permet aux conteneurs d'avoir un composant propriétaire.
public ref class NestedContainer : System::ComponentModel::Container, IDisposable, System::ComponentModel::IContainer, System::ComponentModel::INestedContainer
public ref class NestedContainer : System::ComponentModel::Container, IDisposable, System::ComponentModel::INestedContainer
public ref class NestedContainer : System::ComponentModel::Container, System::ComponentModel::INestedContainer
public class NestedContainer : System.ComponentModel.Container, IDisposable, System.ComponentModel.IContainer, System.ComponentModel.INestedContainer
public class NestedContainer : System.ComponentModel.Container, IDisposable, System.ComponentModel.INestedContainer
public class NestedContainer : System.ComponentModel.Container, System.ComponentModel.INestedContainer
type NestedContainer = class
inherit Container
interface IContainer
interface IDisposable
interface INestedContainer
type NestedContainer = class
inherit Container
interface INestedContainer
interface IContainer
interface IDisposable
Public Class NestedContainer
Inherits Container
Implements IContainer, IDisposable, INestedContainer
Public Class NestedContainer
Inherits Container
Implements IDisposable, INestedContainer
Public Class NestedContainer
Inherits Container
Implements INestedContainer
- Héritage
- Implémente
Remarques
La NestedContainer classe est une implémentation simple de l’interface INestedContainer , qui définit un composant qui contient logiquement zéro ou plusieurs autres composants et appartient à un composant parent. Le comportement des conteneurs imbriqués diffère d’une norme Container de plusieurs façons, notamment les suivantes :
Les caractéristiques du site telles que DesignMode et GetService sont routées via le site du composant propriétaire.
La propriété du Name site est un nom qualifié qui inclut le nom du composant propriétaire suivi d’un point (.) et le nom du composant enfant.
GetService prend en charge le INestedContainer as a service.
Lorsque le composant propriétaire est supprimé, le conteneur est également supprimé.
En outre, les concepteurs traitent différemment les conteneurs imbriqués. Un hôte de concepteur ne s’intéresse qu’à un seul conteneur, celui associé à l’hôte. Par conséquent, les événements d’ajout et de suppression de composant ne sont pas déclenchés lorsqu’un composant est ajouté ou supprimé d’un conteneur imbriqué. Toutefois, étant donné que les services transitent par le conteneur imbriqué, les événements de modification de composant sont déclenchés lorsqu’un composant d’un conteneur imbriqué est modifié.
Cette disparité dans le suivi des événements a également un impact sur la fonctionnalité d’annulation, qui est étroitement liée à la sérialisation. Le moteur d’annulation standard utilise IReferenceService pour suivre les modifications apportées aux composants. Si le moteur d’annulation ne peut pas identifier un nom pour un composant via le service de référence, le moteur ignore les modifications apportées à ce composant. Ce service reconnaît automatiquement les modifications apportées aux composants autonomes uniquement s’ils sont exposés en tant que propriétés publiques en lecture seule du même nom dans leurs propriétaires. Sinon, le développeur doit transmettre les événements de modification de composant au propriétaire. Par exemple, si la propriété d’un Text
composant imbriqué est refaite surface sur son composant propriétaire en tant que Address
propriété, lorsque la Text
propriété est modifiée, une modification de propriété doit être effectuée par programmation pour la propriété correspondante Address
, sinon cette modification ne sera pas suivie par annulation.
Constructeurs
NestedContainer(IComponent) |
Initialise une nouvelle instance de la classe NestedContainer. |
Propriétés
Components |
Obtient tous les composants du Container. (Hérité de Container) |
Owner |
Obtient le composant propriétaire pour ce conteneur imbriqué. |
OwnerName |
Obtient le nom du composant propriétaire. |
Méthodes
Add(IComponent) |
Ajoute le Component spécifié à Container. Le composant est sans nom. (Hérité de Container) |
Add(IComponent, String) |
Ajoute le Component spécifié à Container et lui assigne un nom. (Hérité de Container) |
CreateSite(IComponent, String) |
Crée un site pour le composant dans le conteneur. |
Dispose() |
Libère toutes les ressources utilisées par Container. (Hérité de Container) |
Dispose(Boolean) |
Libère les ressources utilisées par le conteneur imbriqué. |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetService(Type) |
Obtient l'objet service du type spécifié (si disponible). |
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) |
Remove(IComponent) |
Supprime un composant de Container. (Hérité de Container) |
RemoveWithoutUnsiting(IComponent) |
Supprime un composant de Container sans affecter à Site la valeur |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
ValidateName(IComponent, String) |
Détermine si le nom du composant est unique pour ce conteneur. (Hérité de Container) |