DoEvents Property

Gets or sets a value that controls the processing of events during blocking method calls.

[Visual Basic]
<DescriptionAttribute("Gets or Sets a value that controls the processing of events during blocking method calls.")>
<DefaultValueAttribute()>
<CategoryAttribute("Behavior")>
Public Property DoEvents As Boolean

[C#]
[DescriptionAttribute("Gets or Sets a value that controls the processing of events during blocking method calls.")]
[DefaultValueAttribute()]
[CategoryAttribute("Behavior")]
public bool DoEvents {get; set;}

[C++]
[DescriptionAttribute("Gets or Sets a value that controls the processing of events during blocking method calls.")]
[DefaultValueAttribute()]
[CategoryAttribute("Behavior")]
public: __property bool get_DoEvents();
public: __property void set_DoEvents( 
   bool value
);

[C++/CLI]
[DescriptionAttribute("Gets or Sets a value that controls the processing of events during blocking method calls.")]
[DefaultValueAttribute()]
[CategoryAttribute("Behavior")]
public:
property bool DoEvents {
   bool get();
   void set (bool value);
}

Return Type

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

Platforms: Windows 98, Windows NT 4.0, Windows ME, Windows 2000, Windows XP, Windows Server 2003, Windows Vista

See Also

Dns Class  | Dns Members