ControlDesigner.UsePreviewControl Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un valore che indica se la finestra di progettazione controlli usa un controllo di anteprima temporaneo per generare il markup HTML in fase di progettazione.
protected:
virtual property bool UsePreviewControl { bool get(); };
protected virtual bool UsePreviewControl { get; }
member this.UsePreviewControl : bool
Protected Overridable ReadOnly Property UsePreviewControl As Boolean
Valore della proprietà
true
, se la finestra di progettazione controlli usa una copia temporanea del controllo per l'anteprima in fase di progettazione. In caso contrario false
, se la finestra di progettazione controlli usa la proprietà Component per il controllo contenuto nella finestra di progettazione controlli.
Commenti
Se la UsePreviewControl proprietà è true
, la ViewControl proprietà restituisce una copia temporanea del controllo. Le modifiche apportate al controllo temporaneo non vengono rese persistenti nel documento.
Se la UsePreviewControl proprietà è false
, la ViewControl proprietà restituisce un'istanza della Component proprietà per il controllo . Le modifiche apportate all'istanza del controllo vengono rese persistenti.
L'impostazione SupportsPreviewControl nell'oggetto SupportsPreviewControlAttribute viene utilizzata per impostare il valore della UsePreviewControl proprietà . Pertanto, l'impostazione SupportsPreviewControl determina il tipo di controllo restituito dalla ViewControl proprietà nella classe base ControlDesigner . SupportsPreviewControlAttribute Se non viene specificato nella dichiarazione di Progettazione controlli, il comportamento dell'oggetto ControlDesigner equivale a specificare la SupportsPreviewControl proprietà come false
.
Note per gli eredi
Le finestre di progettazione personalizzate derivate dalla ControlDesigner classe possono eseguire l'override della UsePreviewControl proprietà e ignorare l'oggetto SupportsPreviewControlAttribute . In genere, per indicare che la ViewControl proprietà restituisce sempre una copia temporanea del controllo, eseguire l'override della UsePreviewControl proprietà per restituire true
sempre . Per indicare che la ViewControl proprietà restituisce sempre un'istanza del controllo, eseguire l'override della UsePreviewControl proprietà per restituire false
sempre . Ad esempio, la PreviewControlDesigner classe deriva da ControlDesigner e restituisce true
sempre per la UsePreviewControl proprietà .