Component.CanRaiseEvents 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 componente pode acionar um evento.
protected:
virtual property bool CanRaiseEvents { bool get(); };
protected virtual bool CanRaiseEvents { get; }
member this.CanRaiseEvents : bool
Protected Overridable ReadOnly Property CanRaiseEvents As Boolean
Valor da propriedade
true
se o componente pode gerar eventos; caso contrário, false
. O padrão é true
.
Comentários
A implementação padrão dessa propriedade sempre retorna true
. As classes que herdam da Component classe devem substituir essa propriedade para fornecer a capacidade de desabilitar a geração de eventos. Por exemplo, na Control classe , se o controle estiver sendo hospedado como um controle ActiveX, a CanRaiseEvents propriedade retornará false
se o controle ActiveX tiver seus eventos congelados.
Notas aos Herdeiros
Se você substituir esse método em uma classe derivada e alterá-lo para retornar false
, a EventHandlerList coleção retornada pela Events propriedade retornará null
para um evento. Os eventos ainda podem ser adicionados e removidos da coleção, mas a propriedade da Item[Object] coleção sempre retornará null
.