Click or drag to resize
TapiLineOpen Method (Boolean, TapiCallHandler)
Opens the line. After the line is opened, it can be used to monitor incoming calls and/or to place outgoing calls.

Namespace: Traysoft.AddTapi
Assembly: Traysoft.AddTapi (in Traysoft.AddTapi.dll) Version: 6.0.0.1110
Syntax
Copy
public void Open(
	bool monitorIncomingCalls,
	TapiCallHandler callback
)

Parameters

monitorIncomingCalls
Type: SystemBoolean
Indicates whether the line should monitor incoming calls.
callback
Type: Traysoft.AddTapiTapiCallHandler
Callback method that will be called when a call is connected.
Exceptions
ExceptionCondition
TapiExceptionOpen failed because of Telephony API (TAPI) error.
Remarks

The line has to be opened before it can be used to place outgoing calls and receive incoming calls. If the application only makes outgoing calls and does not need to be notified about incoming calls, pass false as the monitorIncomingCalls parameter. AddTapi.NET will monitor incoming calls on the line and fire IncomingCall events if monitorIncomingCalls parameter is true. When monitorIncomingCalls parameter is true, AddTapi.NET will also answer incoming calls if RingsToAnswer is greater than zero.

The callback parameter represents a method in the application that AddTapi.NET will call when a call is connected. This method will be called for all connected calls, incoming and outgoing. This method should perform application-specific call flow processing. Please see TapiCallHandler for more information.

When you use this method, AddTapi.NET automatically selects appropriate media modes based on the capabilities of telephony hardware. Use Open(Boolean, TapiCallHandler, TapiMediaMode) if you want to open the line device for calls with specific media types (modes).

Examples
The following code shows how to open the line to process incoming calls. Error handling has been omitted for clarity.
Copy
TapiApp.Initialize("MyApp");
TapiLine line = TapiApp.Lines[0];
line.Open(true, CallHandler);
line.RingsToAnswer = 1;
...

// This method will be called when incoming call is answered
private void CallHandler(TapiCall call)
{
    call.Play("welcome.wav");
    call.Speak("Press 1 to hear the current time. Press any other button to disconnect.");
    if(call.WaitForDigit(20) == "1")
    {
        call.Speak(DateTime.Now.ToString());
        call.WaitUntilDone(10);
    }
    call.Disconnect();
}
See Also