Syntax
| Visual Basic (Declaration) | |
|---|---|
<DefaultValueAttribute()> <CategoryAttribute("Behavior")> Public Property DoEvents As Boolean | |
| Visual Basic (Usage) |  Copy Code |
|---|---|
Dim instance As Imap Dim value As Boolean instance.DoEvents = value value = instance.DoEvents | |
| C# | |
|---|---|
[DefaultValueAttribute()] [CategoryAttribute("Behavior")] public bool DoEvents {get; set;} | |
| Managed Extensions for C++ | |
|---|---|
[DefaultValueAttribute()] [CategoryAttribute("Behavior")] public: __property bool get_DoEvents(); public: __property void set_DoEvents( bool value ); | |
| C++/CLI | |
|---|---|
[DefaultValueAttribute()] [CategoryAttribute("Behavior")] public: property bool DoEvents { bool get(); void set ( bool value); } | |
Property Value
true if user-interface events should be processed during synchronous method calls; otherwise, false. The default value is true.Remarks
When performing a synchronous (blocking) method, PowerTCP will process user-interface events (such as window painting) if this property is set to true AND the current thread has an event message queue. If no message queue is present (such as on an ASP page or under any worker thread), the value of this property has no effect. This property is used only for synchronous methods. Object.DoEvents is not needed if using asynchronous methods because the asynchronous method will execute on a different thread, allowing the UI thread to continue working unblocked.
For example, this property is beneficial when an interactive application is being used and the user may want to abort a currently processing operation by clicking an "Abort" button. If Object.DoEvents is set to false, this will not be possible. Set the Object.DoEvents property to true and the application will respond to other events (such as button clicks) during synchronous operations.
Requirements
Target Platforms: Microsoft .NET Framework 2.0