Compartilhar via


ControlDesigner.UsePreviewControl Propriedade

Definição

Obtém um valor que indica se o designer de controle usa um controle de visualização temporário para gerar a marcação HTML de tempo de design.

protected:
 virtual property bool UsePreviewControl { bool get(); };
protected virtual bool UsePreviewControl { get; }
member this.UsePreviewControl : bool
Protected Overridable ReadOnly Property UsePreviewControl As Boolean

Valor da propriedade

true, se o designer de controle usar uma cópia temporária do controle para visualização em tempo de design; caso contrário, , falsese o designer de controle usar a Component propriedade para o controle contido no designer de controle.

Comentários

Se a UsePreviewControl propriedade for true, a ViewControl propriedade retornará uma cópia temporária do controle. As alterações no controle temporário não são persistentes no documento.

Se a UsePreviewControl propriedade for false, a ViewControl propriedade retornará uma instância da Component propriedade para o controle . As alterações na instância do controle são persistentes.

A SupportsPreviewControl configuração no SupportsPreviewControlAttribute objeto é usada para definir o valor da UsePreviewControl propriedade . Portanto, a SupportsPreviewControl configuração determina o tipo de controle retornado pela ViewControl propriedade na classe base ControlDesigner . Se o SupportsPreviewControlAttribute não for especificado na declaração do designer de controle, o comportamento do ControlDesigner objeto será equivalente a especificar a SupportsPreviewControl propriedade como false.

Notas aos Herdeiros

Designers personalizados derivados da ControlDesigner classe podem substituir a UsePreviewControl propriedade e ignorar o SupportsPreviewControlAttribute objeto. Em geral, para indicar que a ViewControl propriedade sempre retorna uma cópia temporária do controle, substitua a UsePreviewControl propriedade para sempre retornar true. Para indicar que a ViewControl propriedade sempre retorna uma instância do controle , substitua a UsePreviewControl propriedade para sempre retornar false. Por exemplo, a PreviewControlDesigner classe deriva do ControlDesigner e sempre retorna true para a UsePreviewControl propriedade .

Aplica-se a

Confira também