The TranslateDialog method displays an application-modal dialog box that allows the user to change the current location of a phone number about to be dialed, adjust location and calling card parameters, and see the effect.

The Address parameter is a string containing a phone number that is used, in the lower portion of the dialog box, to show the effect of the user's changes on the location parameters. The number must be in canonical format; if noncanonical, the phone number portion of the dialog box is not displayed. This parameter can be left empty, in which case the phone number portion of the dialog box is not displayed.

OwnerWnd is a handle to a window to which the dialog box is to be attached. Can be a zero value to indicate that any window created during the function should have no owner window.

Declaration

procedure TranslateDialog(Address: String; OwnerWnd: HWND = 0);

Remarks

Using this method causes the TAPI lineTranslateDialog function to be called.

Errors

Using this function may cause an EhbTapiError exception . Possible errors are:

LINEERR_BADDEVICEID, LINEERR_INVALPARAM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALPOINTER, LINEERR_INIFILECORRUPT, LINEERR_NODRIVER, LINEERR_INUSE, LINEERR_NOMEM, LINEERR_INVALADDRESS, LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED.

See Also

ThbTapiLine.Location, ThbTapiLine.TranslateAddress