NavigationPanelOptions.XCoordinatePattern Property

Gets or sets the pattern of the string representation of the X coordinate.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v18.2.dll

Declaration

C#

[DefaultValue("")]
public string XCoordinatePattern { get; set; }

VB.NET

<DefaultValue("")>
Public Property XCoordinatePattern As String

Property Value

Type	Default	Description
String	String.Empty	A string value that is the pattern.

Property Paths

You can access this nested property as listed below:

Object Type	Path to XCoordinatePattern
MapControl	.NavigationPanelOptions.XCoordinatePattern

Remarks

To specify the pattern for the Geographical coordinate, use the following predefined values.

Pattern	Description
{CP}	Displays a cardinal point.
{D:Number_of_decimal_places}	Displays a degree value. The number of decimal places can be unspecified.
{M:Number_of_decimal_places}	Displays a minute value. The number of decimal places can be unspecified.
{S:Number_of_decimal_places}	Displays a second value. The number of decimal places can be unspecified.

To specify the pattern for the Cartesian coordinate, use the following predefined values.

Pattern	Description
{F:Number_of_decimal_places}	Displays a coordinate value. The number of decimal places can be unspecified.
{MU}	Displays the abbreviation of measure unit name.

Example

This example demonstrates how to change the text of map point coordinates displayed in the navigation panel using latitude and longitude format patterns.

To do this, specify a string that will represent the pattern displayed within a coordinate label in the map navigation panel using NavigationPanelOptions.XCoordinatePattern and NavigationPanelOptions.YCoordinatePattern properties.

In this example, you can format the values of map point coordinates using a predefined list of patterns from the combo box. In the combo box, you can also specify a custom pattern using standard specifiers together with placeholders. For example: “{CP}{D}°{M}’{S:2}’’ “, where CP – is a cardinal point; D – is a degree; M - is a minute; S – is a second. Note that the precision specifier (“2”) indicates the desired number of decimal places.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-format-values-of-map-point-coordinates-displayed-in-the-navigation-panel-e5015

Form1.cs

using DevExpress.XtraEditors;
using System;
using System.Windows.Forms;

namespace MapCoordinatePatterns {

    public partial class Form1 : Form {

        string[] patterns = new string[] {
            "{D:1}°{CP}",
            "{CP}{D:6}°",
            "{D}°{M:2}\'{CP}",
            "{CP}{D}°{M:2}\'",
            "{D}°{M}\'{S:4}\'\'{CP}",            
            "{CP}{D}°{M}\'{S:4}\'\'",
            "Coordinates: {D}°{M}\'{S:2}\'\'{CP}"
        };

        public Form1() {
            InitializeComponent();
            PopulateComboBox(cbXCoordinatePattern);
            PopulateComboBox(cbYCoordinatePattern);
        }

        private void PopulateComboBox(ComboBoxEdit comboBox) {
            comboBox.Properties.Items.AddRange(patterns);
            comboBox.EditValue = comboBox.Properties.Items[0];
        }
        private void OnXCoordinatePatternSelectedIndexChanged(object sender, EventArgs e) {
            map.NavigationPanelOptions.XCoordinatePattern = cbXCoordinatePattern.EditValue as String;
        }

        private void OnYCoordinatePatternSelectedIndexChanged(object sender, EventArgs e) {
            map.NavigationPanelOptions.YCoordinatePattern = cbYCoordinatePattern.EditValue as String;
        }
    }
}

Form1.vb

Imports DevExpress.XtraEditors
Imports System
Imports System.Windows.Forms

Namespace MapCoordinatePatterns

    Partial Public Class Form1
        Inherits Form

        Private patterns() As String = { "{D:1}°{CP}", "{CP}{D:6}°", "{D}°{M:2}'{CP}", "{CP}{D}°{M:2}'", "{D}°{M}'{S:4}''{CP}", "{CP}{D}°{M}'{S:4}''", "Coordinates: {D}°{M}'{S:2}''{CP}" }

        Public Sub New()
            InitializeComponent()
            PopulateComboBox(cbXCoordinatePattern)
            PopulateComboBox(cbYCoordinatePattern)
        End Sub

        Private Sub PopulateComboBox(ByVal comboBox As ComboBoxEdit)
            comboBox.Properties.Items.AddRange(patterns)
            comboBox.EditValue = comboBox.Properties.Items(0)
        End Sub
        Private Sub OnXCoordinatePatternSelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs) Handles cbXCoordinatePattern.SelectedIndexChanged
            map.NavigationPanelOptions.XCoordinatePattern = TryCast(cbXCoordinatePattern.EditValue, String)
        End Sub

        Private Sub OnYCoordinatePatternSelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs) Handles cbYCoordinatePattern.SelectedIndexChanged
            map.NavigationPanelOptions.YCoordinatePattern = TryCast(cbYCoordinatePattern.EditValue, String)
        End Sub
    End Class
End Namespace

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the XCoordinatePattern property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-customize-an-appearance-of-the-map-controls-navigation-panel-t202116/CS/NavigationPanelOptions/Form1.cs#L12

private void Form1_Load(object sender, EventArgs e) {
    mapControl1.NavigationPanelOptions.XCoordinatePattern = "{CP}{D}.{M}.{S:4}";
    mapControl1.NavigationPanelOptions.YCoordinatePattern = "{CP}{D}.{M}.{S:4}";

how-to-format-values-of-map-point-coordinates-displayed-in-the-navigation-panel-e5015/CS/MapCoordinatePatterns/Form1.cs#L30

private void OnXCoordinatePatternSelectedIndexChanged(object sender, EventArgs e) {
    map.NavigationPanelOptions.XCoordinatePattern = cbXCoordinatePattern.EditValue as String;
}

VB.NET

how-to-customize-an-appearance-of-the-map-controls-navigation-panel-t202116/VB/NavigationPanelOptions/Form1.vb#L14

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
    mapControl1.NavigationPanelOptions.XCoordinatePattern = "{CP}{D}.{M}.{S:4}"
    mapControl1.NavigationPanelOptions.YCoordinatePattern = "{CP}{D}.{M}.{S:4}"

how-to-format-values-of-map-point-coordinates-displayed-in-the-navigation-panel-e5015/VB/MapCoordinatePatterns/Form1.vb#L23

Private Sub OnXCoordinatePatternSelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs) Handles cbXCoordinatePattern.SelectedIndexChanged
    map.NavigationPanelOptions.XCoordinatePattern = TryCast(cbXCoordinatePattern.EditValue, String)
End Sub