Skip to main content
All docs
V24.2

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TdxAzureMapGeolocationProviderOnResponse Type

The procedural type for Azure Maps Geolocation server response events.

#Declaration

Delphi
TdxAzureMapGeolocationProviderOnResponse = procedure(ASender: TdxMapControlAzureMapGeolocationProvider; AResponse: TdxAzureMapGeolocationRequestResponse; var ADestroyResponse: Boolean) of object;

#Parameters

Name Type Description
ASender TdxMapControlAzureMapGeolocationProvider

Provides access to the Azure Maps Geocode information component that raised the server response event.

AResponse TdxAzureMapGeolocationRequestResponse

Provides access to a container populated with information returned by a server.

ADestroyResponse Boolean

Specifies if the response event handler automatically destroys the information container accessible through the AResponse parameter. The event handler creates a new server response information container every time the event occurs.

True
Default. The AResponse container is destroyed automatically once the application exits the current event handler. You do not need to manage the response information container manually.
False

Use this option if you need to use the returned information container outside the server response event handler.

Important

Call the Free procedure (in Delphi) or use the delete keyword (in C++Builder) to destroy TdxAzureMapGeolocationRequestResponse class instances manualy if you set the ADestroyResponse parameter to False. Otherwise, memory leaks will occur.

#Remarks

Response events allow you to receive and process a server response after an asynchronous query.

#Code Example: Obtain Country ISO Code by IP Address Asynchronously

The code example in this section demonstrates a procedure that sends a query to an Azure Maps Geolocation server and an OnResponse event handler that receives and processes the server response.

uses
  dxAzureMapInformationProviders,  // Declares TdxMapControlAzureMapGeolocationProvider
  dxMessageDialog;  // Declares the dxMessageDlg global function
// ...

procedure TMyForm.SendGeolocationQuery(const AIPAddress: string);
var
  AQueryParams: IdxAzureMapGeolocationQueryParams;
begin
  AQueryParams := dxMapControl1AzureMapGeolocationProvider1.CreateQueryParams;
  AQueryParams.IP := AIPAddress;
  dxMapControl1AzureMapGeolocationProvider1.ExecuteAsync(AQueryParams);
end;

procedure TMyForm.dxMapControl1AzureMapGeolocationProvider1Response(
  ASender: TdxMapControlAzureMapGeolocationProvider;
  AResponse: TdxAzureMapGeolocationRequestResponse; var ADestroyResponse: Boolean);
begin
  if AResponse <> nil then
  begin
    if AResponse.IsSuccess then
      dxMessageDlg('Country Code: ' + AResponse.CountryRegion.IsoCode, TMsgDlgType.mtInformation, [mbOK], 0);
    else if Assigned(AResponse.ErrorInfo) then
      dxMessageDlg(AResponse.ErrorInfo.Message, TMsgDlgType.mtError, [mbOK], 0);
  end;
end;

#Direct TdxAzureMapGeolocationProviderOnResponse Type Reference

The TdxMapControlAzureMapGeocodeProvider.OnResponse event references the TdxAzureMapGeolocationProviderOnResponse procedural type.

See Also