Component.CanRaiseEvents Property

Definition

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

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

Property Value

Boolean

true se o componente pode gerar eventos; caso contrário, false.true if the component can raise events; otherwise, false. O padrão é true.The default is true.

Remarks

A implementação padrão dessa propriedade sempre retorna true.The default implementation of this property always returns true. As classes que herdam da classe Component devem substituir essa propriedade para fornecer a capacidade de desabilitar a geração de eventos.Classes that inherit from the Component class should override this property to provide the ability to disable the raising of events. Por exemplo, na classe Control, se o controle estiver sendo hospedado como um controle ActiveX, a propriedade CanRaiseEvents retornará false se o controle ActiveX tiver seus eventos congelados.For example, in the Control class, if the control is being hosted as an ActiveX control, the CanRaiseEvents property returns false if the ActiveX control has its events frozen.

Notes to Inheritors

Se você substituir esse método em uma classe de derivação e alterá-lo para retornar false, a coleção de EventHandlerList retornada pela propriedade Events retornará null para um evento.If you override this method in a deriving class and change it to return false, the EventHandlerList collection returned by the Events property returns null for an event. Os eventos ainda podem ser adicionados e removidos da coleção, mas a propriedade de Item[Object] da coleção sempre retornará null.Events can still be added and removed from the collection, but the collection's Item[Object] property will always return null.

Applies to

See also