Visual Basic (Declaration) | |
---|---|
Public Sub DisableEvents() |
Visual Basic (Usage) | Copy Code |
---|---|
|
C# | |
---|---|
public void DisableEvents() |
C++/CLI | |
---|---|
public: void DisableEvents(); |
Calling DisableEvents will increment an internal counter. When the internal counter is 0, the Changed events will be raised for changes to the RasterImage.
When the internal counter is != 0, Changed will not be raised. Therefore, for each call to DisableEvents, there should be a corresponding call to EnableEvents in order to restore the raising of events.
You can temporary disable the Changed event when performing multiple operations on a RasterImage object then re-enabling it once the operations are done. This way, any listeners to the Changed event will be notified only once thus optimizing the performance.
Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family