RANGE

Used in

Servers

Image Feature

Parent elements

Syntax

<RANGE	Attribute Description Table
*(r)lower="string, numeric, or date"* *(r)upper="string, numeric, or date"* equality="all \| upper \| lower \| none" [lower] label="string" > When parent element is VALUEMAPLABELRENDERER: (r)<CALLOUTMARKERSYMBOL... /> [Or] (r)<CHARTSYMBOL... /> [Or] (r)<RASTERSHIELDSYMBOL... /> [Or] (r)<SHIELDSYMBOL... /> [Or] (r)<TEXTSYMBOL... /> [Or] When parent element is VALUEMAPRENDERER: (r)<GRADIENTFILLSYMBOL... /> [Or] (r)<HASHLINESYMBOL... /> [Or] (r)<RASTERFILLSYMBOL... /> [Or] (r)<RASTERMARKERSYMBOL... /> [Or] (r)<SIMPLELINESYMBOL... /> [Or] (r)<SIMPLEMARKERSYMBOL... /> [Or] (r)<SIMPLEPOLYGONSYMBOL... /> [Or] (r)<TRUETYPEMARKERSYMBOL... /> [Or] </RANGE >
(r): Attribute or child element is required.

Description

Used with VALUEMAPRENDERER and VALUEMAPLABELRENDERER for matching a range of values within a specified field in a database. When a match occurs, the symbol is drawn as specified for each range.

Restrictions

One renderer child element is required for each RANGE element in the value map.
Not valid with ArcMap Server.

Notes

If DATASET layer type is point, then only point symbols can be used. If type is line, then line and point symbols can be used. If type is polygon, then polygon, line, and point symbols can be used.
If there are leading or trailing blanks in a field value, they are trimmed before a comparison is made. For example, a field value of " Hello " is interpreted as "Hello".
For more information on using renderers, see Using ArcXML Renderers.

Attribute Descriptions for RANGE

Attribute	Usage
equality	Defines the upper and lower bounds of each range. If "all" is used, then lower <= value <= upper. If "upper" is used, lower < value <= upper. If "lower" is used, lower <= value < upper.
label	Label for legend.
lower	Lower value of range; can be a numeric, string, or date value.
upper	Upper value of range; can be a numeric, string, or date value.

Examples for RANGE

Example 1: When using VALUEMAPRENDERER.

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <CONFIG>
    <ENVIRONMENT>
      <LOCALE country="US" language="en" variant="" />
      <UIFONT color="0,0,0" name="Arial" size="12" style="regular" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
        <FILTERCOORDSYS id="4326" />
        <FEATURECOORDSYS id="4326"/>
      </PROPERTIES>
      <WORKSPACES>
         <SHAPEWORKSPACE name="shp_ws-0" directory="<path to WORLD ESRIDATA>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="Countries" visible="true" id="100">
        <DATASET name="CNTRY94" type="polygon" workspace="shp_ws-0" />
        <VALUEMAPRENDERER lookupfield="AREA">
        <RANGE lower="0.0" upper="1000000.0" equality="all" label="Small">
          <SIMPLEPOLYGONSYMBOL filltype="solid" fillcolor="255,255,0" boundarywidth="1" />
        </RANGE>
        <RANGE lower="1000000.0" upper="3000000.0" equality="upper" label="Medium">
          <SIMPLEPOLYGONSYMBOL filltype="solid" fillcolor="255,146,0" boundarywidth="2" />
        </RANGE>
        <RANGE lower="3000000.0" upper="10000000.0" equality="upper" label="Large">
          <RASTERMARKERSYMBOL shadow="0,0,0" overlap="true" url="http://arcims2/website/color.gif" image="C:\ArcIMS\WebSite\color.gif" />
        </RANGE>
        <OTHER>
          <SIMPLEPOLYGONSYMBOL filltype="solid" fillcolor="128,128,128" />
        </OTHER>
        </VALUEMAPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: When using VALUEMAPLABELRENDERER.

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <CONFIG>
    <ENVIRONMENT>
      <LOCALE country="US" language="en" variant="" />
      <UIFONT color="0,0,0" name="Arial" size="12" style="regular" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
        <FILTERCOORDSYS id="4326" />
        <FEATURECOORDSYS id="4326"/>
      </PROPERTIES>
      <WORKSPACES>
         <SHAPEWORKSPACE name="shp_ws-0" directory="<path to WORLD ESRIDATA>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="Cities" visible="true" id="1">
        <DATASET name="cities" type="point" workspace="shp_ws-0" />
        <GROUPRENDERER>
          <VALUEMAPLABELRENDERER lookupfield="POPULATION" labelfield="NAME" >
          <RANGE lower="0.0" upper="150000.0">
            <TEXTSYMBOL font="Tahoma" fontstyle="regular" fontsize="10" />
          </RANGE>
          <RANGE lower="150001.0" upper="750000.0">
            <TEXTSYMBOL font="Arial" fontstyle="italic" fontsize="12" glowing="125,125,125" />
          </RANGE>
          <RANGE lower="750001.0" upper="3427180.0">
            <TEXTSYMBOL font="Times New Roman" fontstyle="bolditalic" fontsize="14" glowing="255,255,0" shadow="0,0,0" />
          </RANGE>
          </VALUEMAPLABELRENDERER>
          <SIMPLERENDERER>
            <SIMPLEMARKERSYMBOL color="51,102,51" width="8" />
          </SIMPLERENDERER>
        </GROUPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>