ControlDesigner.UsePreviewControl Propriété
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.
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.
protected:
virtual property bool UsePreviewControl { bool get(); };protected virtual bool UsePreviewControl { get; }member this.UsePreviewControl : boolProtected Overridable ReadOnly Property UsePreviewControl As BooleanValeur de propriété
true si le concepteur de contrôles utilise une copie temporaire du contrôle pour l’aperçu au moment du design ; sinon, false, si le concepteur de contrôles utilise la propriété Component pour le contrôle contenu dans le concepteur de contrôles.
Remarques
Si la UsePreviewControl propriété est true, la ViewControl propriété retourne une copie temporaire du contrôle. Les modifications apportées au contrôle temporaire ne sont pas conservées dans le document.
Si la UsePreviewControl propriété est false, la ViewControl propriété retourne une instance de la Component propriété pour le contrôle. Les modifications apportées à l’instance du contrôle sont conservées.
Le SupportsPreviewControl paramètre dans l’objet SupportsPreviewControlAttribute est utilisé pour définir la valeur de la UsePreviewControl propriété . Par conséquent, le SupportsPreviewControl paramètre détermine le type de contrôle retourné par la ViewControl propriété dans la classe de base ControlDesigner . Si le SupportsPreviewControlAttribute n’est pas spécifié dans la déclaration du concepteur de contrôles, le comportement de l’objet ControlDesigner équivaut à spécifier la SupportsPreviewControl propriété en tant que false.
Notes pour les héritiers
Les concepteurs personnalisés dérivés de la ControlDesigner classe peuvent remplacer la UsePreviewControl propriété et ignorer l’objet SupportsPreviewControlAttribute . En règle générale, pour indiquer que la ViewControl propriété retourne toujours une copie temporaire du contrôle, remplacez la UsePreviewControl propriété par toujours retourner true. Pour indiquer que la ViewControl propriété retourne toujours une instance du contrôle, remplacez la UsePreviewControl propriété par toujours retourner false. Par exemple, la PreviewControlDesigner classe dérive de et ControlDesigner retourne true toujours pour la UsePreviewControl propriété .
