ThbTapiLine.Location
Unit: hbTapi

This property holds the current location that is used for address translation. The values are initialized when a line device has been selected successfully. If a location is defined, the Available member has a value of True. While ThbTapiLine is active, the Location is updated automatically when the system location changes, otherwise you have to call the Refresh method.

Example

with hbTapiLine1 do
begin
  DeviceName := 'Sample TSP';
  if Available then
  begin
    if Location.Available then
      Label1.Caption := 'Current location is: ' + LocationName
    else
      MessageDlg('No TAPI system location defined.', mtInformation, [mbOk], 0);
  end;
end;

Location has the following sub-properties:

Available
PermanentLocationID
LocationName
CityCode
CountryCode
CountryID
CountryName
LocalAccessCode
LongDistanceAccessCode

Availability

Design-Time: None / Run-Time: Read

Declaration

property Location: ThbTapiSystemLocation;

See Also

ThbTapiLine.TranslateAddress, ThbTapiLine.TranslateDialog

ThbTapiLine.Available

Type: Boolean

This member indicates if the system location is available and the content of ThbTapiSystemLocation is valid.

ThbTapiLine.PermanentLocationID

Type: DWORD

The permanent identifier that identifies the location.

ThbTapiLine.LocationName

Type: String

A description of the location in a user-friendly manner.

ThbTapiLine.CityCode

Type: String

The city code of the system location.

ThbTapiLine.CountryCode

Type: String

The country code of the system location.

ThbTapiLine.CountryID

Type: DWORD

The country identifier of the country selected for the location.

ThbTapiLine.CountryName

Type: String

A string holding the name of the country.

ThbTapiLine.LocalAccessCode

Type: String

A string containing the access code to be dialed before calls to addresses in the local calling area.

ThbTapiLine.LongDistanceAccessCode

Type: String

A string containing the access code to be dialed before calls to addresses outside the local calling area.