How to: Create a Custom Search Panel

• Jun 07, 2019
• 2 minutes to read

Important

On May 21, 2024, Microsoft announced that Bing Maps for Enterprise and its API will be discontinued. Azure Maps will be a single unified enterprise mapping platform available from Microsoft.

To obtain and display map data from Azure Maps, we implemented the following providers:

• AzureMapDataProvider
• AzureSearchDataProvider
• AzureRouteDataProvider
• AzureGeocodeDataProvider
• AzureTrafficIncidentDataProvider
• AzureRouteIsochroneDataProvider

For information on how to migrate your app from Bing Maps to Azure Maps, see the following help topic: DevExpress Map Control for WPF: Migrate from Bing Maps to Azure Maps.

If you already have a Bing Maps for Enterprise license, you can keep using the current API. You must transition to the new API by June 30, 2025 (for free/basic licenses) or June 30, 2028 (for enterprise licenses). New licenses will no longer be available after June 30, 2025. Bing Maps will not work with our map controls without a license after that date.

This example demonstrates how to create a custom search panel.

• Build a custom search panel. In this example, the panel contains two text edits (for the Location and Keywords) and the Search button.
• To implement searching, create a InformationLayer object to the MapControl.Layers collection and assign a BingSearchDataProvider object to the InformationLayer.DataProvider property.
• To search a location, the BingSearchDataProvider.Search method should be called. In this example, this method is called in the Search button click event handler.

View Example

MainWindow.xaml

    <dxm:InformationLayer.DataProvider>
        <dxm:BingSearchDataProvider x:Name="searchProvider" 
                                    ShowSearchPanel="False"
                                    BingKey="{Binding Source={StaticResource bingKey}}"
                                    SearchCompleted="searchProvider_SearchCompleted">
            <dxm:BingSearchDataProvider.SearchOptions>
                <dxm:BingSearchOptions x:Name="options"
                                       AutocorrectQuery="{Binding ElementName=cbAutocorrect, Path=IsChecked}"
                                       DistanceUnit="{Binding ElementName=lbDistanceUnits, Path=SelectedValue}"
                                       ResultsCount="{Binding ElementName=tbCount, Path=Value}">
                </dxm:BingSearchOptions>
            </dxm:BingSearchDataProvider.SearchOptions>
        </dxm:BingSearchDataProvider>
    </dxm:InformationLayer.DataProvider>
<Button Grid.Row="2" Margin="4" Click="bSearch_Click">Search</Button>

MainWindow.xaml.vb

Private Sub bSearch_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    tbSearchResult.Text = ""
    searchProvider.Search(tbLocation.Text)
End Sub

MainWindow.xaml.cs

private void bSearch_Click(object sender, RoutedEventArgs e) {
    tbSearchResult.Text = "";
    searchProvider.Search(tbLocation.Text);
}