ControlDesigner.UsePreviewControl Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 : boolProtected Overridable ReadOnly Property UsePreviewControl As BooleanValor 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 .
