解读:Aspose.Slides for .NET v19.8全新发布!什么是获取有效值的最佳方法?

Aspose.Slides for .NET是独特的演示处理API,使应用程序能够读取,编写,修改和转换PowerPoint演示文稿。Aspose.Slides for .NET更新至最新版v19.8,引入了用于获得有效值的新API,从而获取“本地”值和“有效”值。

Aspose.Slides for .NET是独特的演示处理API,使应用程序能够读取,编写,修改和转换PowerPoint演示文稿。作为独立的API,它提供了管理PowerPoint关键功能的功能,例如管理文本,形状,表格和动画,向幻灯片添加音频和视频,预览幻灯片等等。

Aspose.Slides for .NET更新至最新版v19.8,引入了用于获得有效值的新API,从而获取“本地”值和“有效”值。下面我们一起来了解一下具体内容吧!>>欢迎下载Aspose.Slides for .NET v19.8体验

什么是“本地”和“有效”值/strong>

新的功能支持通过IPortion.PortionFormat在不同级别的表示结构层次结构中设置文本部分的属性。以下是其中一些:

  1. 在部分幻灯片的部分属性中
  2. 在布局或主幻灯片上的原型形状文本样式
  3. 在演示文稿全局文本设置中

对于任何这些级别,直接在此级别设置的值称为“本地”。在任何级别,可以定义或省略“本地”值。但最后,当应用程序(使用Aspose.Slides甚至PowerPoint本身构建)需要知道该部分应该是什么样的时候(在图像导出或在屏幕上绘图时),它使用“有效”值 – 完全使用层次结构构建的已定义值集,可能的值覆盖最低层的每个级别以及硬编码到PowerPoint中的默认值。

“有效数据”对象本质上是不可变的-它们仅用于获取最终的组合信息。“本地数据“”对象是可变的-它们用于设置属性。

获得有效值的最佳方法是什么/strong>

启动Aspose.Slides v19.8所需要的只是从您希望获得有效值的本地格式调用GetEffective()方法。下面列举个例子说明:

using (Presentation pres = new Presentation("MyPresentation.pptx")){    IAutoShape shape = pres.Slides[0].Shapes[0] as IAutoShape;     ITextFrameFormat localTextFrameFormat = shape.TextFrame.TextFrameFormat;    ITextFrameFormatEffectiveData effectiveTextFrameFormat = localTextFrameFormat.GetEffective();     IPortionFormat localPortionFormat = shape.TextFrame.Paragraphs[0].Portions[0].PortionFormat;    IPortionFormatEffectiveData effectivePortionFormat = localPortionFormat.GetEffective();}

注意:

GetEffective()方法已添加到ITextFrameFormat、ITextStyle、IParagraphFormat、IPortionFormat、IFillFormat、ILineFormat、IEffectFormat、IThreeDFormat、ITableFormat、IRowFormat、IColumnFormat、ICellFormat、IBackground 和ITheme接口。

AccessibleEffectiveData和BaseEffectiveData类

这两个类都是抽象的,并在内部用于维护系统的统一有效值。AccessibleEffectiveData类是具有自己的继承层次结构的格式的有效数据类的基类。BaseEffectiveData类是AccessibleEffectiveData的基类,也是所有有效数据类的基类,它们没有自己的继承层次结构,并且作为更复杂的有效数据类的一部分。

以下是在不同的表示结构级别上设置本地字体高度值后,演示部分的有效字体高度值的代码。

using (Presentation pres = new Presentation()){    IAutoShape newShape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 400, 75, false);    newShape.AddTextFrame("");    newShape.TextFrame.Paragraphs[0].Portions.Clear();     IPortion portion0 = new Portion("Sample text with first portion");    IPortion portion1 = new Portion(" and second portion.");     newShape.TextFrame.Paragraphs[0].Portions.Add(portion0);    newShape.TextFrame.Paragraphs[0].Portions.Add(portion1);     Console.WriteLine("Effective font height just after creation:");    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);     pres.DefaultTextStyle.GetLevel(0).DefaultPortionFormat.FontHeight = 24;    Console.WriteLine("Effective font height after setting entire presentation default font height:");    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);     newShape.TextFrame.Paragraphs[0].ParagraphFormat.DefaultPortionFormat.FontHeight = 40;    Console.WriteLine("Effective font height after setting paragraph default font height:");    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);     newShape.TextFrame.Paragraphs[0].Portions[0].PortionFormat.FontHeight = 55;    Console.WriteLine("Effective font height after setting portion #0 font height:");    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);     newShape.TextFrame.Paragraphs[0].Portions[1].PortionFormat.FontHeight = 18;    Console.WriteLine("Effective font height after setting portion #1 font height:");    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);} // Output:// Effective font height just after creation:// Portion #0: 18// Portion #1: 18// Effective font height after setting entire presentation default font height:// Portion #0: 24// Portion #1: 24// Effective font height after setting paragraph default font height:// Portion #0: 40// Portion #1: 40// Effective font height after setting portion #0 font height:// Portion #0: 55// Portion #1: 40// Effective font height after setting portion #1 font height:// Portion #0: 55// Portion #1: 18

*想要购买Aspose正版授权的朋友可以联系客服哦~


ASPOSE技术交流QQ群()已开通,各类资源及时分享,欢迎交流讨论!

标签:

声明:本站部分文章及图片源自用户投稿,如本站任何资料有侵权请您尽早请联系jinwei@zod.com.cn进行处理,非常感谢!

上一篇 2019年8月1日
下一篇 2019年8月1日

相关推荐

发表回复

登录后才能评论