RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TDispatchConnection.SetConnected Method

Sets the Connected property.

Pascal
procedure SetConnected(Value: Boolean); override;
C++
virtual __fastcall SetConnected(Boolean Value);

SetConnected is the protected implementation of the Connected property. It establishes a connection to the Application server if Value is true, and disconnects from the application server if Value is false. 

If Value is false, SetConnected generates a BeforeDisconnect event, closes the connection, and generates an AfterDisconnect event. 

If Value is true, SetConnected performs the following actions: 

 

  1. If LoginPrompt is true, and the connection is not already open, SetConnected generates an OnGetUsername event, and uses that to initialize a login dialog. It displays the login dialog, and aborts the connection if the user cancels. 

  2. It generates a BeforeConnect event. 

  3. It opens the connection. 

  4. It generates an AfterConnect event. 

  5. If LoginPrompt is true, and the connection opened successfully, SetConnected generates an OnLogin event.

 

Copyright(C) 2008 CodeGear(TM). All Rights Reserved.
What do you think about this topic? Send feedback!