ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • 帮助
  • Sign Out
ArcGIS Desktop

ArcGIS Online

专为贵组织打造的制图平台

ArcGIS Desktop

全面的专业性 GIS

ArcGIS Enterprise

面向企业的 GIS

ArcGIS Developers

用于构建位置感知应用程序的工具

ArcGIS Solutions

适用于行业的免费模板地图和应用程序

ArcGIS Marketplace

获取适用于组织的应用程序和数据

  • 文档
  • 支持
Esri
  • 登录
user
  • 我的个人资料
  • 登出

ArcMap

  • 主页
  • 入门
  • 地图
  • 分析
  • 管理数据
  • 工具
  • 扩展模块

MapsurroundElement

  • 描述
  • 讨论
  • 属性
  • 代码示例

描述

用于访问能够在页面布局中重新定位以及识别父数据框的属性。

讨论

MapsurroundElement 对象是与数据框有关联的页面元素。例如,指北针和数据框之间是一对一关系。地图整饰要素也包括文本比例尺和图示比例尺。属性 parentDataFrameName 可以帮助您找到与特定数据框相关联的元素。图例元素也是地图整饰要素的一个实例,但由于具有附加属性,因此它是一个独立的元素类型。ListLayoutElements 函数将返回页面布局元素对象的 Python 列表。随后需要遍历列表中的每个项目,或指定一个索引号以引用具体的页面元素对象。要返回只有 MapsurroundElements 的列表,element_type 参数应使用 MAPSURROUND_ELEMENT 常量。您可使用通配符根据元素名对搜索过程进行优化。

建议您为每个页面布局元素赋予唯一的名称,以便在使用 arcpy 脚本时便于区分。元素位置 X 和 Y 以元素的锚点位置为基础;元素的锚点位置可通过 ArcMap 中“元素属性”对话框的大小和位置选项卡进行设置。

属性

属性说明数据类型
elementHeight
(可读写)

元素的高度(以页面单位计)。分配或报告的单位为页面单位。

Double
elementPositionX
(可读写)

数据框元素的锚点位置的 x 位置。分配或报告的单位为页面单位。

Double
elementPositionY
(可读写)

数据框元素的锚点位置的 y 位置。分配或报告的单位为页面单位。

Double
elementWidth
(可读写)

元素的宽度(以页面单位计)。分配或报告的单位为页面单位。

Double
name
(可读写)

元素的名称。

String
parentDataFrameName
(只读)

用于表示相关元素的 DataFrame 名称的字符串。

String
type
(只读)

返回任何给定页面布局元素的元素类型。

  • DATAFRAME_ELEMENT —数据框元素
  • GRAPHIC_ELEMENT —图形元素
  • LEGEND_ELEMENT —图例元素
  • MAPSURROUND_ELEMENT —地图整饰要素元素
  • PICTURE_ELEMENT —图片元素
  • TEXT_ELEMENT —文本元素
String

代码示例

MapsurroundElement 示例

以下脚本将会找到名为 ScaleBar 的地图整饰要素元素并更改其位置。

import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
scaleBar = arcpy.mapping.ListLayoutElements(mxd, "MAPSURROUND_ELEMENT", "ScaleBar")[0]
df = arcpy.mapping.ListDataFrames(mxd, scaleBar.parentDataFrameName)[0]
scaleBar.elementPositionX = df.elementPositionX + (df.elementWidth / 2)
mxd.save()
del mxd

ArcGIS Desktop

  • 主页
  • 文档
  • 支持

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

关于 Esri

  • 关于我们
  • 招贤纳士
  • Esri 博客
  • 用户大会
  • 开发者峰会
Esri
分享您的想法。
Copyright © 2021 Esri. | 隐私政策 | 法律声明