ControlDesigner.UsePreviewControl 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得值,其中該值會表示控制項設計工具是否使用暫時預覽控制項以產生設計階段 HTML 標記。
protected:
virtual property bool UsePreviewControl { bool get(); };
protected virtual bool UsePreviewControl { get; }
member this.UsePreviewControl : bool
Protected Overridable ReadOnly Property UsePreviewControl As Boolean
屬性值
如果控制項設計工具針對設計階段預覽使用控制項的暫時副本,則為 true
;否則,如果控制項設計工具針對控制項設計工具中所包含的控制項使用 Component 屬性,則為 false
。
備註
UsePreviewControl如果 屬性為 true
,則 ViewControl 屬性會傳回 控件的暫存複本。 暫存控件的變更不會保存到檔。
UsePreviewControl如果 屬性為 false
,則 ViewControl 屬性會傳回 控件之 屬性的Component實例。 控件實例的變更會保存。
SupportsPreviewControl物件中的SupportsPreviewControlAttribute設定是用來設定 屬性的值UsePreviewControl。 因此,設定SupportsPreviewControl會決定基ControlDesigner類中 屬性所傳ViewControl回的控件類型。
SupportsPreviewControlAttribute如果未在控制項設計工具宣告中指定 ,則ControlDesigner物件行為相當於將 屬性指定SupportsPreviewControl為 false
。
給繼承者的注意事項
衍生自 類別的 ControlDesigner 自訂設計工具可以覆寫 UsePreviewControl 屬性並忽略 SupportsPreviewControlAttribute 物件。 一般而言,若要指出 ViewControl 屬性一律會傳回控件的暫存複本,請覆寫 UsePreviewControl 屬性以一律傳回 true
。 若要指出 ViewControl 屬性一律傳回 控制項的實體,請覆寫 UsePreviewControl 屬性以一律傳回 false
。 例如,類別PreviewControlDesigner衍生自 ControlDesigner ,而且一律會傳UsePreviewControl回 true
屬性。