与 HTML 的工作原理类似，动态文本也使用标签。这使您可以在单一的文本元素中合并动态文本和静态文本。将动态文本添加到布局后，您可以修改文本以更改所显示的信息及其显示方式。除了能够提供所显示信息的动态文本标签以外，您还可以使用格式化标签来修改各部分文本的格式。这样，您就可以创建具有混合格式的文本，例如，为句子中的一个词语添加下划线。
使用动态文本标签的文本元素的复杂程度可根据需要进行调整。在某些情况下，您可能仅需要使用一个独立的标签，但在其他情况下，您可能需要将多个标签与静态文本搭配使用。以下是跟踪上一个使用工程的人员的示例：
Last updated on <ITA><dyn type="project" property="dateSaved" format="long"/></ITA> by <ITA><dyn type="user"/></ITA>.
此示例使用静态文本、两个动态文本标签和第一个标签上的修饰符来指定日期格式，并使用两个格式标签将日期和用户名显示为斜体。输出内容将类似于以下内容：上次更新时间：2014 年 6 月 9 日，星期一，更新者为用户名。
注：
仅当当前字型包含该样式时，系统才会应用文本格式化标签。
下文提供了动态文本标签的表格、动态文本的格式信息以及这些标签的使用方法示例。有关格式化标签的列表和示例，请参阅文本格式化标签。
数值
您可以使用 decimalPlaces 属性来修改由返回数值的标签使用的小数位数。例如，<dyn type="mapFrame" name="MapFrameName" property="lowerMid" units="ddm" decimalPlaces="0"/> 会显示为 -95 13 32 58，而 <dyn type="mapFrame" name="Map Map Frame" property="lowerMid" units="ddm" decimalPlaces="2"/> 会显示为 -95 13.29 32 57.68。
空字符串
如果文本元素只包含当前无法解析的动态文本标签，则在选择元素时布局中将显示空边界框。
如果文本元素包含附加静态文本或可解析为一个值的附加动态文本标签，则将显示该文本。例如，如果布局中存在从未被导出的以下文本：上次导出：<dyn type="layout" name="Layout" property="dateExported"/>，其将在页面上显示为上次导出：，直到页面被导出。
但是，如果要在标签解析为空时显示特定文本，则可将 emptyStr="<text>" 添加到动态文本标签。以下述标签为例：
Credits: <dyn type="mapFrame" name="Map Frame" property="credits"/>
如果地图不包含任何制作者名单信息，则布局中的结果将显示为制作者名单：。当没有可用信息时，您可以使用空属性设置默认文本。例如：
Credits: <dyn type="mapFrame" name="<Map Frame Name>" property="credits" emptyStr="Credits for this map were unavailable."/>
布局上的结果为 Credits: Credits for this map were unavailable.
前字符串和后字符串
前字符串和后字符串属性可用于在标签前面或后面添加文本。静态文本相比，使用这些属性的好处是，只有在动态文本标签有值时才会加以显示。以下述标签为例：
Date Exported: <dyn type="layout" name="Layout" property="dateExported" format="short"/>
如果从未导出布局，布局上的结果将为导出日期：。您可以移除静态文本并将添加前字符串和后字符串来说明尚未导出布局，而不是以添加空字符串属性的方式来说明，因此导出日期：将不会显示在页面上。
<dyn type="layout" name="Layout" property="dateExported" format="short" preStr="Last exported on " postStr="."/>
这样，页面上的文本将为空，直到将布局导出为止。如果将布局导出，文本将与以下内容类似：
Last exported on 2/11/2015.
新行
要使用动态文本标签启用新行，请添加新行属性。标签类似于以下内容：
Date Saved <dyn type="project" property="dateSaved" format="short|short" newLine="true"/>
布局上的结果为：
保存日期
1/27/2015 11:20 AM
系统标签
下表列出了系统信息的可用标签：
系统
| 说明 | 示例语法 | 示例输出 |
|---|---|---|
计算机名称 | <dyn type="computer"/> | MYLAPTOP |
当前日期 | <dyn type="date" format=""/> | 2019/4/4 |
当前时间 | <dyn type="time" format=""/> | 10:20 AM |
用户名 | <dyn type="user"/> | 用户 |
注：
从动态文本库的插入选项卡上选择当前时间会插入一段带有当前日期和当前时间标签的文本。格式化文本窗格中的结果为当前时间 <dyn type="mapFrame" name="{0}" property="time" format="short|short"/>。
工程标签
以下标签可用于工程信息：
投影
| 说明 | 示例语法 | 示例输出 |
|---|---|---|
名称 | <dyn type="project" property="name"/> | CityMaps |
路径 | <dyn type="project" property="path"/> | C:\Users\UserName\Documents\ArcGIS\Projects\CityMaps\CityMaps.aprx |
文件夹 | <dyn type="project" property="folder"/> | C:\Users\UserName\Documents\ArcGIS\Projects\CityMaps\ |
保存日期 | <dyn type="project" property="dateSaved" format="short|short"/> | 2019/4/4 11:20 AM |
默认文件夹 | <dyn type="project" property="defaultFolder"/> | C:\Users\UserName\Documents\ArcGIS\Projects\CityMaps\ |
默认地理数据库 | <dyn type="project" property="defaultGeodatabase"/> | C:\Users\UserName\Documents\ArcGIS\Projects\CityMaps\CityMaps.gdb |
默认工具箱 | <dyn type="project" property="defaultToolbox"/> | C:\Users\UserName\Documents\ArcGIS\Projects\CityMaps\CityMaps.tbx |
默认距离单位 | <dyn type="project" property="distUnits"/> | 米 |
默认角度单位 | <dyn type="project" property="angularUnits"/> | 十进制度 |
默认面积单位 | <dyn type="project" property="areaUnits"/> | 平方千米 |
默认页面单位 | <dyn type="project" property="pageUnits"/> | 厘米 |
注：
可以通过更新单位选项来更改默认距离单位、默认角度单位、默认面积单位和默认页面单位。
布局标签
以下标签可用于布局：
布局
| 说明 | 示例语法 | 示例输出 |
|---|---|---|
导出日期 | <dyn type="layout" name="LayoutName" property="dateExported" format= "short|short"/> | 2019/4/4 11:00 AM |
打印日期 | <dyn type="layout" name="LayoutName" property="datePrinted" format= "short|short"/> | 2019/4/4 11:05 AM |
元数据 | 在菜单中选择此选项将插入包含一系列元数据标签的文本元素。有关详细信息，请参阅布局元数据表。 | |
名称 | <dyn type="layout" name="LayoutName" property="name"/> | 城市布局 |
服务图层制作者名单 | <dyn type="layout" name="LayoutName" property="serviceLayerCredits"/> | 来源：Esri、HERE、Garmin、FAO、NOAA、USGS、© OpenStreetMap 贡献者和 GIS 用户社区 |
注：
“服务图层制作者名单”标签将显示页面上所有地图框的制作者名单。
布局元数据
| 说明 | 示例语法 | 示例输出 |
|---|---|---|
标题 | <dyn type="layout" property="metadata" attribute="title"/> | 最小 A3 横向 |
标签 | <dyn type="layout" property="metadata" attribute="tags"/> | 最小，文摘，横向，布局，标题，制作者名单，模板 |
摘要 | <dyn type="layout" property="metadata" attribute="summary"/> | 简单 A3 大小，没有任何边距的横向布局。其中包括地图标题和服务图层制作者名单。 |
说明 | <dyn type="layout" property="metadata" attribute="description"/> | 横向布局非常适合显示国家/地区、城市和州。 |
制作者名单 | <dyn type="layout" property="metadata" attribute="credits"/> | 由制图师于 2019 年设计完成。 |
使用限制 | <dyn type="layout" property="metadata" attribute="uselimit"/> | 仅用于显示目的。 |
地图框标签
地图框标签显示有关地图框及其所包含的地图的信息。
当您创建指定地图框的动态文本标签时，地图框将按照创建标签时所使用的名称进行引用。例如，如果当前默认地图框被命名为 My Map，并且您针对该比例插入了一个动态文本元素，则标签为：<dyn type="mapFrame" name="My Map" property="scale"/>。如果在稍后对地图框进行重命名，则该标签会保留其引用的地图框，但不会进行更新以反映地图框的新名称。
可用的地图框标签如下：
地图框
| 说明 | 示例语法 | 示例输出 |
|---|---|---|
照相机 | 在菜单中选择此选项将插入包含一系列照相机标签的文本元素。有关详细信息，请参阅地图框照相机表。 | |
制作者名单 | <dyn type="mapframe" name="MapFrameName" property="credits"/> | 创建于 2019 年。 |
说明 | <dyn type="mapframe" name="MapFrameName" property="description"/> | 显示 1970 年城市人口的地图。 |
地图单位 | <dyn type="mapFrame" name="MapFrameName" property="mapUnits"/> | 米 |
元数据 | 在菜单中选择此选项将插入包含一系列元数据标签的文本元素。有关详细信息，请参阅地图框元数据表。 | |
名称 | <dyn type="mapFrame" name="MapFrameName" property="name"/> | 地图框 |
地图名称 | <dyn type="mapFrame" name="MapFrameName" property="mapName"/> | 冰岛地图 |
参考比例 | <dyn type="mapFrame" name="MapFrameName" property="referenceScale"/> | 0 |
相对比例 | 1 centimeter equals <dyn type="mapFrame" name="Map Map Frame" property="scale" pageUnits="cm" mapUnits="km" pageValue="1" decimalPlaces="2"/> kilometers 此标签可根据页面修改地图比例。属性 pageUnits 用于设置页面空间中的所需单位（例如英寸或厘米），pageValue 用于设置使用的这些单位的数量。属性 mapUnits 用于设置地图比例的单位。 | 1 厘米等于 0.08 公里 |
旋转 | <dyn type="mapFrame" name="MapFrameName" property="rotation"/> | 90 |
缩放 | <dyn type="mapFrame" name="MapFrameName" property="scale" preStr="1:"/> | 1:8,000 |
中心比例 | <dyn type="mapFrame" name="MapFrameName" property="centerscale" preStr="1:"/> 此标签将计算关联地图框中心纬度和经度的比例。 | 1:6,854 |
空间参考 | 在菜单中选择此选项将插入包含空间参考标签集的文本元素。有关详细信息，请参阅空间参考表。 |
北
| 说明 | 示例语法 | 示例输出 |
|---|---|---|
正北 | <dyn type="mapFrame" name="MapFrameName" property="trueNorth" units="dd" decimalPlaces="1" showDirections="false"/> | 0.2° |
磁北 | <dyn type="mapFrame" name="MapFrameName" property="magneticNorth" units="dd" decimalPlaces="0" showDirections="false"/> | -10° |
地图北 | <dyn type="mapFrame" name="MapFrameName" property="gridNorth" units="dd" decimalPlaces="0" showDirections="false"/> | 0° |
磁偏角 | <dyn type="mapFrame" name="MapFrameName" property="magneticDeclination" units="dd" decimalPlaces="2" showDirections="false"/> 磁偏角是正北和磁北方向之间的角度。 | -9.67° |
收敛 | <dyn type="mapFrame" name="MapFrameName" property="convergence" units="dd" decimalPlaces="2" showDirections="false"/> 收敛角是正北和格网北方向之间的角度。 | 0.22° |
G-M 角 | <dyn type="mapFrame" name="MapFrameName" property="gmAngle" units="dd" decimalPlaces="2" showDirections="false"/> G-M 角是格网北和磁北方向之间的角度。 | -9.89° |
地图框照相机
| 说明 | 示例语法 | 示例输出 |
|---|---|---|
X | <dyn type="mapFrame" name="MapFrameName" property="camera.x" units="dms" decimalPlaces="0"/> | 46°8'3"E |
Y | <dyn type="mapFrame" name="MapFrameName" property="camera.y" units="dms" decimalPlaces="0"/> | 13°4'18"S |
Z | <dyn type="mapFrame" name="MapFrameName" property="camera.z"/> | 2,601,586.4995 |
缩放 | <dyn type="mapFrame" name="MapFrameName" property="camera.scale" preStr="Scale: 1:"/> | 比例：1:12,487,512 |
旋转 | <dyn type="mapFrame" name="MapFrameName" property="camera.rotation"/> | 5.03 |
仰俯角 | <dyn type="mapFrame" name="MapFrameName" property="camera.pitch"/> | -90 |
滚动 | <dyn type="mapFrame" name="MapFrameName" property="camera.roll"/> | -90 |
地图框元数据
| 说明 | 示例语法 | 示例输出 |
|---|---|---|
标题 | <dyn type="mapframe" name="mapFrameName" property="metadata" attribute="title"/> | 1970 年的世界 |
标签 | <dyn type="mapframe" name="mapFrameName" property="metadata" attribute="tags"/> | 人口，地图，1970，世界，历史地图， |
摘要 | <dyn type="mapframe" name="mapFrameName" property="metadata" attribute="summary"/> | 世界人口地图。 |
说明 | <dyn type="mapframe" name="mapFrameName" property="metadata" attribute="description"/> | 显示 1970 年全球城市人口的地图。 |
制作者名单 | <dyn type="mapframe" name="mapFrameName" property="metadata" attribute="credits"/> | 创建于 2019 年。 |
使用限制 | <dyn type="mapframe" name="mapFrameName" property="metadata" attribute="uselimit"/> | 仅用于教学目的。 |
空间参考标签
| 说明 | 示例语法 | 示例输出 |
|---|---|---|
名称 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="name"/> | WGS 1984 UTM Zone 12N |
投影坐标系 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="pcs"/> | WGS 1984 UTM Zone 12N |
地理坐标系 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="gcs"/> | GCS WGS 1984 |
基准面 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="datum"/> | WGS 1984 |
投影 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="projection"/> | 横轴墨卡托投影 |
备注 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="remarks"/> | 基于 OSGB1936 的用户定义地理坐标系 |
中央经线 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="central meridian"/> | -111.0000 |
起始纬度 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="latitude of origin"/> | 0.0000 |
起始经度 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="longitude of origin"/> | 0.0000 |
中心纬度 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="latitude of center"/> | 0.0000 |
中心经度 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="longitude of center"/> | 0.0000 |
第一标准纬线 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="latitude of 1st"/> | 0.0000 |
第二标准纬线 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="latitude of 2nd"/> | 0.0000 |
第一标准经线 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="longitude of 1st"/> | 0.0000 |
第二标准经线 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="longitude of 2nd"/> | 0.0000 |
东偏移量 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="false easting"/> | 500,000.0000 |
北偏移量 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="false northing"/> | 0.0000 |
标准纬线 1 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="standard parallel 1"/> | 0.0000 |
标准纬线 2 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="standard parallel 2"/> | 0.0000 |
比例因子 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="scale factor"/> | 0.9996 |
方位角 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="azimuth"/> | 0.0000 |
单位 | <dyn type="mapFrame" name="MapFrameName" property="sr" srProperty="units"/> | 米 |
地图框 - 坐标
| 说明 | 示例语法 | 示例输出 |
|---|---|---|
居中对齐 | <dyn type="mapFrame" name="MapFrameName" property="center" units="dms" decimalPlaces="0"/> | 80°41'25"W 44°36'4"N |
X | <dyn type="mapFrame" name="MapFrameName" property="center.x" units="dms" decimalPlaces="0"/> | 80°41'25"W |
Y | <dyn type="mapFrame" name="MapFrameName" property="center.y" units="dms" decimalPlaces="0"/> | 44°36'4"N |
左下角 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft" units="dms" decimalPlaces="0"/> | 80°44'54"W 44°34'33"N |
底部中间位置 | <dyn type="mapFrame" name="MapFrameName" property="lowerMid" units="dms" decimalPlaces="0"/> | 80°41'25"W 44°34'32"N |
右下角 | <dyn type="mapFrame" name="MapFrameName" property="lowerRight" units="dms" decimalPlaces="0"/> | 80°37'57"W 44°34'32"N |
中间偏左 | <dyn type="mapFrame" name="MapFrameName" property="midLeft" units="dms" decimalPlaces="0"/> | 80°44'53"W 44°36'5"N |
中间偏右 | <dyn type="mapFrame" name="MapFrameName" property="midRight" units="dms" decimalPlaces="0"/> | 80°37'57"W 44°36'3"N |
左上角 | <dyn type="mapFrame" name="MapFrameName" property="upperLeft" units="dms" decimalPlaces="0"/> | 80°44'53"W 44°37'36"N |
上部中间位置 | <dyn type="mapFrame" name="MapFrameName" property="upperMid" units="dms" decimalPlaces="0"/> | 80°41'25"W 44°37'36"N |
右上角 | <dyn type="mapFrame" name="MapFrameName" property="upperRight" units="dms" decimalPlaces="0"/> | 80°37'56"W 44°37'35"N |
要将坐标分解为多个部分，请将 .x 或 .y 追加到您指定的属性上。可使用下方的格式标签来设置坐标值的显示格式。
十进制度部分
| 格式 | 说明 | 示例语法 | 示例输出 |
|---|---|---|---|
dd | 十进制度 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="dd" decimalPlaces="2" showDirections="True"/> | 122.31W |
dd.deg | 度 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="dd.deg" decimalPlaces="2" showDirections="True"/> | 122.31 |
dd.deg.int | 度（整数） | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="dd.deg.int" decimalPlaces="2" showDirections="True"/> | 122 |
dd.deg.sym | 度数符号 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="dd.deg.sym" decimalPlaces="2" showDirections="True"/> | ° |
dd.dec | 十进制 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="dd.dec" decimalPlaces="2" showDirections="True"/> | 31 |
dd.dir | 方向 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="dd.dir" decimalPlaces="2" showDirections="True"/> | 西 |
度分秒部分
| 格式 | 说明 | 示例语法 | 示例输出 |
|---|---|---|---|
dms | 度分秒 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="dms" decimalPlaces="2" showDirections="False"/> | -122°18'37.82" |
dms.deg | 度 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="dms.deg" decimalPlaces="2" showDirections="True"/> | 122 |
dms.deg.sym | 度数符号 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="dms.deg.sym" decimalPlaces="2" showDirections="True"/> | ° |
dms.min | 分 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft" units="dms.min" decimalPlaces="2" showDirections="True"/> | 18 |
dms.min.sym | 分符号 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="dms.min.sym" decimalPlaces="2" showDirections="True"/> | ' |
dms.sec | 秒 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="dms.sec" decimalPlaces="2" showDirections="True"/> | 37.82 |
dms.sec.sym | 秒符号 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="dms.sec.sym" decimalPlaces="2" showDirections="True"/> | " |
dms.sec.int | 秒（整数） | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft" units="dms.sec.int" decimalPlaces="2" showDirections="True"/> | 37 |
dms.sec.dec | 秒（小数） | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="dms.sec.dec" decimalPlaces="2" showDirections="True"/> | 82 |
dms.dir | 方向 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="dms.dir" showDirections="True"/> | 西 |
十进制分部分
| 格式 | 说明 | 示例语法 | 示例输出 |
|---|---|---|---|
ddm | 十进制分 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="ddm" decimalPlaces="2" showDirections="True"/> | 122°18.63 W |
ddm.deg | 度 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="ddm.deg" decimalPlaces="2" showDirections="True"/> | 122 |
ddm.min | 分 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft.x" units="ddm.min" decimalPlaces="2" showDirections="True"/> | 18.63 |
ddm.min.int | 分（整数） | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft" units="ddm.min.int" decimalPlaces="2" showDirections="True"/> | 18 |
ddm.min.dec | 分（小数） | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft" units="ddm.min.dec" decimalPlaces="2" showDirections="True"/> | 63 |
ddm.deg.sym | 度数符号 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft" units="ddm.deg.sym" decimalPlaces="2" showDirections="True"/> | ° |
ddm.dir | 方向 | <dyn type="mapFrame" name="MapFrameName" property="lowerLeft" units="ddm.dir" decimalPlaces="2" showDirections="True"/> | 西 |
如果地图框包含启用时间的数据，则可以使用动态文本来显示时间信息。
地图框 - 时间
| 说明 | 示例语法 | 示例输出 |
|---|---|---|
开始时间 | <dyn type="mapFrame" name="MapFrameName" property="startTime" format="short|short"/> | 2001/1/1 12:00 AM |
当前时间 | <dyn type="mapFrame" name="MapFrameName" property="time" format="short|short"/> | 1/1/2004 12:00 AM 至 1/1/2006 12:00 AM |
结束时间 | <dyn type="mapFrame" name="MapFrameName" property="endTime" format="short|short"/> | 2010/1/1 12:00 AM |