Skip To Content ArcGIS for Developers Sign In Dashboard

DictionarySymbolStyle QML Type

A type of SymbolStyle that is used to obtain unique symbols from a given specification, such as MIL-STD-2525D (mil2525d). More...

Import Statement: import Esri.ArcGISRuntime 100.6
Since: Esri.ArcGISRuntime 100.0
Inherits:

SymbolStyle

Properties

Signals

Methods

Detailed Description

Note: Use this class if you want to obtain, search for, and create renderers for military symbology standards like MIL-STD-2525D. Use SymbolStyle if you simply want to obtain and search for symbols in a style file.

A DictionarySymbolStyle is made up of a *.stylx file (a SQLite database from ArcGIS Pro), which contains the symbol primitives for a given symbology specification (such as mil2525d), as well as a rule engine that parses input fields. The DictionarySymbolStyle assembles new symbols from the input attributes, and can also apply geometry manipulations to the symbols in the case of multipoint geometries.

A DictionarySymbolStyle can be used in conjunction with a DictionaryRenderer, which can be applied to a FeatureLayer or GraphicsOverlay. In addition, the DictionarySymbolStyle can be used by itself. When used by itself, the DictionarySymbolStyle supports two key workflows. The first is to find a symbol with provided attributes values. This is done by creating a QVariantMap of field names and attribute values (as determined by the associated specification), and passing those into fetchSymbolWithKeyMap, which returns a new symbol. In this case, the key is the name of the specification field (e.g. "symbolset" in the case of mil2525d), and the value is value you want associated with that field (e.g "Atmospheric"). You might use this symbol to create a new Graphic.

You can also use a standalone DictionarySymbolStyle to search for symbol primitives. Symbol primitives are the individual symbols that make up more complex and advanced multilayer military symbols. This is achieved using SymbolStyle::searchSymbols. You could create a symbol picker app that searches for all symbols that have the tag "maritime" in it. The search results contain symbols which you could then either use as they are or extract from them different individual symbols to create a new composite symbol.

The currently supported military standards include the following:

Military standardSpecification type stringAssociated style file
MIL-STD-2525B (change 2)mil2525c_b2mil2525c_b2.stylx
MIL-STD-2525Cmil2525c_b2mil2525c_b2.stylx
MIL-STD-2525Dmil2525dmil2525d.stylx

Use the above information in the DictionarySymbolStyle constructor to create a new DictionarySymbolStyle of a given specification.

Note: MIL-STD-2525B (change 2) and MIL-STD-2525C use the same specification type string and style file for creation. By default, MIL-STD-2525C will be used. To force the DictionarySymbolStyle to use MIL-STD-2525B (change 2), you must set the following configurationProperties:

var configProperties = { "legacy_standard" : "mil2525bc2" };

Please consult each standard's specification for details on the standard itself.

Example:

Create a DictionarySymbolStyle with the mil2525d specification:

DictionarySymbolStyle.createFromFile(dataPath + "/styles/arcade_style/mil2525d.stylx")

See also Loadable, Cancelable, DictionaryRenderer, SymbolStyleSearchParameters, and SymbolStyleSearchResult.

Property Documentation

configurations : list<DictionarySymbolStyleConfiguration>

Returns the configuration settings from the custom dictionary style (read-only).

This property is populated after the DictionarySymbolStyle loads.

This QML property was introduced in Esri.ArcGISRuntime 100.6.


dictionaryName : string

Returns the name of the custom Arcade-based dictionary style (read-only).

For older versions of style files, this is an empty string.


symbologyFieldNames : list<string>

Returns the string list of attributes used to construct a symbol from the DictionarySymbolStyle (read-only).

For example, mil2525d would include "identity", "symbolset", "symbolentity", and "modifier1", among many others. The newer Arcade-based styles define such attributes within the .stylx file as a JSON string.


textFieldNames : list<string>

Returns the string list of attributes used to obtain text values for display with a symbol from a DictionarySymbolStyle (read-only).

For example, mil2525d would include "combateffectiveness", "credibility", "reliability", and "staffcomment", among many others. The newer Arcade-based styles define such attributes within the .stylx file as a JSON string.


Signal Documentation

configurationsChanged()

Emitted when the configurations property changes.

This QML signal was introduced in Esri.ArcGISRuntime 100.6.


dictionaryNameChanged()

Emitted when the dictionaryName property changes.

This QML signal was introduced in Esri.ArcGISRuntime 100.6.


symbologyFieldNamesChanged()

Emitted when the symbologyFieldNames property changes.


textFieldNamesChanged()

Emitted when the textFieldNames property changes.


Method Documentation

DictionarySymbolStyle createFromFile(url filePath)

A static method that creates a DictionarySymbolStyle using the given style file.

  • filePath - The path to the styleFile. This style file needs to be created with Pro verson 2.4 or above.

This QML method was introduced in Esri.ArcGISRuntime 100.6.


string fetchSymbolWithKeyMap(jsobject keys)

Retrieves a new symbol, as defined by the input keys.

This asynchronous task is useful for obtaining a single, multi-layer symbol from supplied attributes. This is commonly used to create symbols and graphics on-the-fly. For example, with mil2525d, you may want to obtain a symbol where "symbolset" is 01 ("air"), "entity" is 110100 ("Military (Air) : Fixed-Wing"), "identity" is 3 ("friend"), and so on. All of these key/value pairs can be used to obtain the specific symbol that you need. Once you have that symbol, you can apply it to a Graphic or Renderer, obtain its swatch image, or serialize to JSON. The SymbolStyle::fetchSymbolStatusChanged signal emits once complete, with the SymbolStyle::fetchSymbolStatus being completed, giving access to the resulting symbol.

Note: For mil2525d, symbolset, entity, and identity fields are required to create a symbol. This information, along with the range of valid inputs can be found on the Military Features Data GitHub page.



Feedback on this topic?