Partager via


ControlDesigner.UsePreviewControl Propriété

Définition

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 : bool
Protected Overridable ReadOnly Property UsePreviewControl As Boolean

Valeur 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é .

S’applique à

Voir aussi