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
。