ControlDesigner.UsePreviewControl Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera wartość wskazującą, czy projektant kontrolek używa tymczasowej kontrolki podglądu do generowania znacznika HTML w czasie projektowania.
protected:
virtual property bool UsePreviewControl { bool get(); };
protected virtual bool UsePreviewControl { get; }
member this.UsePreviewControl : bool
Protected Overridable ReadOnly Property UsePreviewControl As Boolean
Wartość właściwości
true
, jeśli projektant kontrolek używa tymczasowej kopii kontrolki do podglądu w czasie projektowania; w przeciwnym razie , false
jeśli projektant kontrolek używa Component właściwości dla kontrolki zawartej w projektancie kontrolek.
Uwagi
UsePreviewControl Jeśli właściwość ma true
wartość , ViewControl właściwość zwraca tymczasową kopię kontrolki. Zmiany w kontrolce tymczasowej nie są utrwalane w dokumencie.
UsePreviewControl Jeśli właściwość ma false
wartość , ViewControl właściwość zwraca wystąpienie Component właściwości dla kontrolki. Zmiany w wystąpieniu kontrolki są utrwalane.
Ustawienie SupportsPreviewControl w SupportsPreviewControlAttribute obiekcie służy do ustawiania wartości UsePreviewControl właściwości. W związku z tym SupportsPreviewControl ustawienie określa typ kontrolki zwracanej przez ViewControl właściwość w klasie bazowej ControlDesigner . Jeśli właściwość SupportsPreviewControlAttribute nie jest określona w deklaracji projektanta kontrolek, ControlDesigner zachowanie obiektu jest równoważne określeniu SupportsPreviewControl właściwości jako false
.
Uwagi dotyczące dziedziczenia
Projektanci niestandardowi, którzy pochodzą z ControlDesigner klasy, mogą zastąpić UsePreviewControl właściwość i zignorować SupportsPreviewControlAttribute obiekt. Ogólnie rzecz biorąc, aby wskazać, że ViewControl właściwość zawsze zwraca tymczasową kopię kontrolki, należy zastąpić UsePreviewControl właściwość , aby zawsze zwracała wartość true
. Aby wskazać, że ViewControl właściwość zawsze zwraca wystąpienie kontrolki, zastąpij UsePreviewControl właściwość , aby zawsze zwracała wartość false
. Na przykład PreviewControlDesigner klasa pochodzi z ControlDesigner klasy i zawsze zwraca true
wartość dla UsePreviewControl właściwości .