ControlDesigner.UsePreviewControl Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá hodnotu označující, zda návrhář ovládacího prvku používá dočasný náhled ovládací prvek k vygenerování kódu HTML v době návrhu.
protected:
virtual property bool UsePreviewControl { bool get(); };
protected virtual bool UsePreviewControl { get; }
member this.UsePreviewControl : bool
Protected Overridable ReadOnly Property UsePreviewControl As Boolean
Hodnota vlastnosti
true
, pokud návrhář ovládacích prvků používá dočasnou kopii ovládacího prvku pro náhled návrhu; v opačném případě, false
pokud návrhář ovládacích prvků používá Component vlastnost pro ovládací prvek obsažený v návrháři ovládacího prvku.
Poznámky
UsePreviewControl Pokud je true
vlastnost , vrátí ViewControl vlastnost dočasnou kopii ovládacího prvku. Změny dočasného ovládacího prvku se neuchovávají v dokumentu.
UsePreviewControl Pokud je false
vlastnost , ViewControl vrátí vlastnost instanci Component vlastnosti ovládacího prvku. Změny instance ovládacího prvku se zachovají.
Nastavení SupportsPreviewControl v objektu SupportsPreviewControlAttribute se používá k nastavení hodnoty UsePreviewControl vlastnosti. SupportsPreviewControl Proto nastavení určuje typ ovládacího prvku, který je vrácen vlastností ViewControl v základní ControlDesigner třídě. Pokud není zadána SupportsPreviewControlAttribute v deklaraci návrháře ovládacího prvku, ControlDesigner chování objektu je ekvivalentní k určení SupportsPreviewControl vlastnosti jako false
.
Poznámky pro dědice
Vlastní návrháři odvození z ControlDesigner třídy mohou přepsat UsePreviewControl vlastnost a ignorovat SupportsPreviewControlAttribute objekt. Obecně platí, že ViewControl vlastnost vždy vrací dočasnou kopii ovládacího prvku, přepsat UsePreviewControl vlastnost vždy vrátit true
. Chcete-li indikovat, že ViewControl vlastnost vždy vrací instanci ovládacího prvku, přepište UsePreviewControl vlastnost vždy vrátit false
. Třída je například PreviewControlDesigner odvozena od ControlDesigner a vždy vrátí true
pro UsePreviewControl vlastnost.