Creating Event Handlers in Delphi and C++Builder Applications

3.1. Creating the Event Handler Function

3.2. Attaching Event Controls to Event Sources

3.3. Detaching Event Controls From Event Sources

Before you start creating event handlers, you need to prepare the Event control that you will use for event handling.

1. Open your test project in TestComplete, and open your Event control for editing. To do this, right-click the Event control in the Project Explorer and choose Edit from the context menu.

2. In the Event Control editor, add the desired events to the Event control. The steps you need to perform depend on the events to be handled. See Adding Events to Event Controls for complete information.

3. In the TLB Description edit box at the top of the Event Control editor, specify some descriptive text for your Event control. This text will identify the control among other ActiveX objects in the system.

   

4. Select File | Save from the TestComplete main menu to save the changes.

To create an event handler:

• Drop the Event control on a form.

• Select the control on the form and switch to the Object Inspector.

• Double-click on the desired event in the Events page.

Delphi (C++Builder) will create the event handler procedure and display it in the editor.

To make your Event control respond to events of TestComplete or ActiveX objects, you should establish a link between the control and TestComplete (or between the control and the desired object). We call this attaching an Event control to the event source. You should attach the control to every object, whose events you are going to handle. The Event control can only process the TestComplete engine’s events or events of an ActiveX object if it has been attached to them.

To attach an Event control to TestComplete or desired object, use the following methods of the Event control:

• EventControl.AttachToTestComplete() - Establishes the link to the TestComplete engine. Call this method if you need to handle TestComplete events.

• EventControl.AttachTo(Obj) - Attaches the Event control to any object specified by the Obj parameter. This object must implement the IDispatch interface. Use this methods to handle events of ActiveX objects that reside outside of TestComplete.

  Note:

  The AttachTo method is available if your Event control contains events of external ActiveX objects. If the control only contains TestComplete events, the method is unavailable.

It may be convenient  to attach an Event control to the desired event source after your C# Connected Application has been started. You can call the AttachToTestComplete and AttachTo methods within the OnLoad event handler of the application’s main form. For instance, to handle events of the Document object of Microsoft Word, follow these steps:

• Add Microsoft Word’s events to the list of project events. See Adding Events to Event Controls for more information on this.

• Attach the Event control to TestComplete by calling the EventControl.AttachToTestComplete method.

• Attach the Event control to each Microsoft Word’s Document object, whose events you would like to handle. That is, call EventControl.AttachTo(DocumentObject) for each Document object:

  Delphi

  C++Builder

  Delphi

  var
    WordAppObject, DocObject1, DocObject2 : OleVariant;
  begin
    // Attaching Event control to TestComplete
    EventControl1.AttachToTestComplete();
    
    // Getting references to Microsoft Word and Document objects
    WordAppObject := Sys.OleObject('Word.Application');
    DocObject1 := WordAppObject.Documents.Item(1);
    DocObject2 := WordAppObject.Documents.Item(2);
    
    // Attaching to Microsoft Word and Document objects
    EventControl1.AttachTo(DocObject1);
    EventControl1.AttachTo(DocObject2);
    EventControl1.AttachTo(WordAppObject);
    ...
  end;

  C++Builder

  // Attaching Event control to TestComplete
  EventControl1.AttachToTestComplete();
   
  // Getting references to Microsoft Word and Document objects
  varWordAppObject = Sys["OleObject"]("Word.Application");
  var DocObject1 = WordAppObject["Documents"]["Item"](1);
  var DocObject2 = WordAppObject["Documents"]["Item"](2);
   
  // Attaching to Microsoft Word and Document objects
  EventControl1->AttachTo(DocObject1);
  EventControl1->AttachTo(DocObject2);
  EventControl1->AttachTo(WordAppObject);