学习C#调用OpenXml操作word文档的基本用法(33:学习图形类-3)

  本文学习openxml的文本运行类Run的子类型图形类Drawing的子类型浮动式布局类Anchor的主要属性,其命名空间为DocumentFormat.OpenXml.Drawing.Wordprocessing。
  1)DistanceFromTop属性:图形与上边缘文本的距离,类型为UInt32Value,还有DistanceFromBottom、DistanceFromLeft和DistanceFromRight属性,分别代表图形与下边缘文本的距离、与左边缘文本的距离、与右边缘文本的距离;
  2)SimplePos属性:设置是否启用简单位置模式,类型为BooleanValue,该属性决定图形是由直接指定的绝对坐标定位,还是由Word的排版引擎动态计算位置;
  3)SimplePosition属性:设置启用简单位置模式时的简单定位坐标,类型为SimplePosition,主要属性包括X(X轴坐标)、Y(Y轴坐标),数量单位都是 EMU(1 EMU = 1/914400 英寸 = 1/36000 毫米);
  4)RelativeHeight属性:设置浮动图形在垂直方向上的层叠顺序(Z-order),类型为UInt32Value;
  5)BehindDoc属性:设置浮动图形与文档文本的层叠顺序,类型为BooleanValue,值为true将图形放置在文本的下方,文本会覆盖在图形之上,形成背景或水印效果,值为false将图形放置在文本的上方,图形会覆盖在文本之上,形成浮于文字上方的效果;
  6)Locked属性:设置是否锁定定位点,类型为BooleanValue,防止浮动图形的位置被应用程序在编辑时自动改变,通过锁定图形与其锚点(Anchor Point)的关联,确保图形在页面上的绝对位置稳定;
  7)LayoutInCell属性:设置当图形位于表格单元格内时,其定位的计算应基于单元格内容还是整个页面,类型为BooleanValue;
  8)Hidden属性:设置控制浮动图形在文档中的可见性,实现按需显示或隐藏内容,类型为BooleanValue;
  9)AllowOverlap属性:设置是否允许浮动图形与其它对象重叠,类型为BooleanValue;
  10)EditId属性:设置编辑标识符,类型为HexBinaryValue,该属性与Word的修订或审阅功能有关,记录对当前图形所做的特定编辑操作,用于在协同编辑场景下跟踪谁在何时做了什么修改;
  11)AnchorId属性:设置图形的唯一标识符,类型为HexBinaryValue,用于在同一文档中精准定位和引用特定的图形对象;
  12)HorizontalPosition属性:设置水平定位,类型为HorizontalPosition,主要属性包括RelativeFrom(设置水平定位的参考基准,从枚举类HorizontalRelativePositionValues内取值)、HorizontalAlignment(设置水平对齐方式)、PositionOffset(设置图形相对于RelativeFrom参考系的绝对偏移量)、PercentagePositionHeightOffset(设置使用百分比来指定水平偏移量);
  13)VerticalPosition属性:设置垂直定位,类型为VerticalPosition,主要属性包括RelativeFrom(设置垂直定位的参考基准,从枚举类VerticalRelativePositionValues内取值)、VerticalAlignment(设置垂直对齐方式)、PositionOffset(设置图形相对于RelativeFrom参考系的绝对偏移量)、PercentagePositionVerticalOffset(设置使用百分比来指定垂直偏移量);
  14)Extent属性:设置图形尺寸,类型为Extent ,主要包括Cx(长度)、Cy(宽度)两个属性,类型为Int64Value,数值单位为EMU(1 EMU = 1/914400 英寸 = 1/36000 毫米;
  15)EffectExtent属性:设置对象阴影、发光等效果所占用的扩展空间,确保效果不会与其他内容重叠,参考文献3中对该类的说明为"指定应添加到图像的每个边缘 (顶部、底部、左侧、右侧) 的额外范围,以便补偿应用于DrawingML对象的任何绘图效果",类型为EffectExtent,主要包括LeftEdge、TopEdge、RightEdge、BottomEdge等4个属性,类型都是Int64Value,分别用于设置左侧边缘上的附加范围、顶部边缘上的附加范围、右侧边缘上的附加范围、底部边缘上的附加范围。

参考文献

1https://github.com/dotnet/Open-XML-SDK

2https://learn.microsoft.com/zh-cn/office/open-xml/open-xml-sdk

3https://learn.microsoft.com/zh-cn/dotnet/api/documentformat.openxml.wordprocessing.style?view=openxml-3.0.1

4https://blog.csdn.net/i042416/article/details/126228816

相关推荐
IHaveADiscovery4 天前
无痛让AI由Markdown转Word:Pandoc模板了解一下
人工智能·word·markdown
yivifu7 天前
使用lxml操作 Word 的 OpenXML 底层
word·openxml·lxml
梦想出海-Phoebe8 天前
Gemini新增文件编辑功能:PDF、Word、Excel处理体验分享
pdf·word·excel
xbzb9 天前
OpenStack 网络管理(实操):建网络、连路由、浮动 IP 与安全组
网络·安全·openstack·ip·安全组·浮动
开开心心_Every10 天前
快速隐藏程序工具自定义快捷键一键切换
java·开发语言·前端·spring·智能手机·word·intellij-idea
ComPDFKit11 天前
PDF转Word后,每行都成一段?先分清断段、文本框和扫描页
pdf·word
thethefighter11 天前
快速预览Word、WPS秒开,支持空格弹窗
linux·word·wps·快速预览·空格弹窗·nhdeepview
SunnyDays101111 天前
Java 操作 Word 脚注和尾注:添加、读取与删除
java·word
SunnyDays101111 天前
Java 为 Word 添加页码:隐藏封面页码、从指定页开始编号、奇偶页页码设置等
java·word·页码
Eiceblue11 天前
用 Python 给 Word 文档加水印:文字、图片与批量处理
开发语言·vscode·python·word