学习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

相关推荐
_清风来叙1 小时前
【软件】Word软件不支持显示emoji表情包如何解决
电脑·word
CallmeFoureyes9 小时前
使用 C# 提取 Word 文档中的表格数据
开发语言·c#·word
AI刀刀1 天前
豆包智能体对话导出后,如何构建长期归档与高效检索体系?
android·人工智能·word·excel·ai导出鸭
Jazz_z1 天前
通过 Java 实现 Word 转 TXT
java·c#·word
小弥儿2 天前
无需安装WPS 和 Office!开源 OfficeCLI,Claude/Copilot 可直接调用,自动生成编辑Word/PPT/Excel
word·powerpoint·excel
AI导出鸭PC端2 天前
豆包智能体停运在即,历史对话如何一键导出为 Word 或 PDF?
人工智能·pdf·word·豆包·ai导出鸭
asdzx673 天前
C# 通过模板生成 Word 文档:文本与图片占位符替换完整攻略
开发语言·c#·word
Metaphor6923 天前
使用 Python 在 Word 文档中添加批注
python·word
lang201509283 天前
Apache POI Word(docx) 实战教程:从入门到精通表格合并、图片插入与文档合并
java·开发语言·word
Sour3 天前
产品说明书翻译成英文怎么保留排版?PDF、Word、外贸资料处理清单
pdf·word