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
屬性。