ShapeTitleOptions.Pattern Property

Gets or sets a pattern that is used to specify a name for each shape title.

Namespace: DevExpress.Xpf.Map

Assembly: DevExpress.Xpf.Map.v18.2.dll

Declaration

C#

public string Pattern { get; set; }

VB.NET

Public Property Pattern As String

Property Value

Type	Description
String	A String value that defines the text of shape titles.

Property Paths

You can access this nested property as listed below:

Show 13 property paths

Object Type	Path to Pattern
MapBubble	.TitleOptions.Pattern
MapChartItemBase	.TitleOptions.Pattern
MapDot	.TitleOptions.Pattern
MapEllipse	.TitleOptions.Pattern
MapLine	.TitleOptions.Pattern
MapPath	.TitleOptions.Pattern
MapPie	.TitleOptions.Pattern
MapPolygon	.TitleOptions.Pattern
MapPolyline	.TitleOptions.Pattern
MapRectangle	.TitleOptions.Pattern
MapShape	.TitleOptions.Pattern
MapShapeBase	.TitleOptions.Pattern
VectorLayer	.ShapeTitleOptions.Pattern

Remarks

Attributes can be used to specify the title pattern of a map shape. To use an attribute in the pattern, specify its value in braces. For instance, to use an attribute with the name Name, set {Name} to the Pattern property.

Example

The following example demonstrates how to customize the map shape title.

To customize a title, do the following.

• Create a ShapeTitleOptions object.
• Specify the ShapeTitleOptions.Pattern and ShapeTitleOptions.Template properties.
• Assign the object to the MapShapeBase.TitleOptions property of the map shape.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-customize-the-appearance-of-a-map-shape-title-e4221.

MainWindow.xaml

<dxm:ShapeTitleOptions x:Key="titleOptions" 
                       Pattern="{}{Name}" Visible="True">
    <dxm:ShapeTitleOptions.Template>
        <DataTemplate>
            <TextBlock Text="{Binding Text}"
                       Foreground="Blue" Margin="0,0,0,20"/>
        </DataTemplate>
    </dxm:ShapeTitleOptions.Template>
</dxm:ShapeTitleOptions>
                    <dxm:MapDot Location="51.507222, -0.1275" Size="10" Fill="Red" 
                                TitleOptions="{StaticResource titleOptions}">
                        <dxm:MapDot.Attributes>
                            <dxm:MapItemAttribute Name="Name" Value="London"/>
                        </dxm:MapDot.Attributes>
                    </dxm:MapDot>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Pattern 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-the-appearance-of-a-map-shape-title-e4221/VB/WpfMapControl_ShapeTitleOptions/MainWindow.xaml#L13

<dxm:ShapeTitleOptions x:Key="titleOptions"
                       Pattern="{}{Name}" Visible="True">
    <dxm:ShapeTitleOptions.Template>

how-to-load-shapes-from-a-sql-geometry-datasource-t180275/VB/SqlGeometryDataAdapterExample/MainWindow.xaml#L11

<dxm:VectorLayer.ShapeTitleOptions>
    <dxm:ShapeTitleOptions Pattern="{}{TextCol}"
                           Visible="True"/>

how-to-add-a-custom-title-to-a-map-vector-element-e4220/VB/DXMap_UseTitleOptions/MainWindow.xaml#L19

<dxm:MapDot.TitleOptions>
    <dxm:ShapeTitleOptions Visible="True" Pattern="Chicago" />
</dxm:MapDot.TitleOptions>