在 .NET 中从演示文稿获取形状有效属性

概述

本主题解释了本地与有效属性之间的差异。本地值是直接在特定格式级别上设置的值，例如：

幻灯片上的文本段属性。
当该文本段的文本框形状具有原型形状文本样式时，布局或母版幻灯片上的原型形状文本样式。
演示文稿中的全局文本设置。

本地值可以在任何级别定义或省略。当 Aspose.Slides 需要最终的“实际渲染”格式时，它会解析继承链并返回有效值。您可以通过在本地格式对象上调用 GetEffective 方法来获取它们。

以下示例展示了如何获取有效值。假设第一张幻灯片上的第一个形状是一个带有文本框且至少包含一个文本段的 IAutoShape。

using var presentation = new Presentation("sample.pptx");

var slide = presentation.Slides[0];
var shape = (IAutoShape)slide.Shapes[0];

var localTextFrameFormat = shape.TextFrame.TextFrameFormat;
var effectiveTextFrameFormat = localTextFrameFormat.GetEffective();

var portion = shape.TextFrame.Paragraphs[0].Portions[0];
var localPortionFormat = portion.PortionFormat;
var effectivePortionFormat = localPortionFormat.GetEffective();

有效格式化数据表示在应用继承后计算得到的当前格式。在当前实现中，某些有效数据对象（例如 IPortionFormatEffectiveData）可能会在内部被缓存。在更改父级或继承格式后再次调用 GetEffective 可以刷新缓存的数据，先前获取的对象可能不再表示之前的状态。如果您需要保留有效值以供后续使用，请将所需属性（如字体高度、填充颜色、字体样式或对齐方式）复制到您自己的数据对象中。

获取相机的有效属性

Aspose.Slides 允许您获取相机的有效属性。 ICameraEffectiveData 接口表示一个不可变对象，包含有效的相机属性。一个 ICameraEffectiveData 实例通过 IThreeDFormatEffectiveData 暴露，该接口为 IThreeDFormat 提供有效值。

以下代码示例展示了如何获取相机的有效属性。假设第一张幻灯片上的第一个形状具有 3D 格式。

using var presentation = new Presentation("sample.pptx");

var slide = presentation.Slides[0];
var shape = slide.Shapes[0];

var threeDEffectiveData = shape.ThreeDFormat.GetEffective();

Console.WriteLine("= Effective camera properties =");
Console.WriteLine("Type: " + threeDEffectiveData.Camera.CameraType);
Console.WriteLine("Field of view: " + threeDEffectiveData.Camera.FieldOfViewAngle);
Console.WriteLine("Zoom: " + threeDEffectiveData.Camera.Zoom);

获取灯光装置的有效属性

Aspose.Slides 允许您获取灯光装置的有效属性。 ILightRigEffectiveData 接口表示一个不可变对象，包含有效的灯光装置属性。一个 ILightRigEffectiveData 实例通过 IThreeDFormatEffectiveData 暴露，该接口为 IThreeDFormat 提供有效值。

以下代码示例展示了如何获取灯光装置的有效属性。假设第一张幻灯片上的第一个形状具有 3D 格式。

using var presentation = new Presentation("sample.pptx");

var slide = presentation.Slides[0];
var shape = slide.Shapes[0];

var threeDEffectiveData = shape.ThreeDFormat.GetEffective();

Console.WriteLine("= Effective light rig properties =");
Console.WriteLine("Type: " + threeDEffectiveData.LightRig.LightType);
Console.WriteLine("Direction: " + threeDEffectiveData.LightRig.Direction);

获取形状倒角的有效属性

Aspose.Slides 允许您获取形状倒角的有效属性。 IShapeBevelEffectiveData 接口表示一个不可变对象，包含形状的有效面部凹凸属性。一个 IShapeBevelEffectiveData 实例通过 IThreeDFormatEffectiveData 暴露，该接口为 IThreeDFormat 提供有效值。

以下代码示例展示了如何获取形状顶部倒角的有效属性。假设第一张幻灯片上的第一个形状具有 3D 格式。

using var presentation = new Presentation("sample.pptx");

var slide = presentation.Slides[0];
var shape = slide.Shapes[0];

var threeDEffectiveData = shape.ThreeDFormat.GetEffective();

Console.WriteLine("= Effective shape's top face relief properties =");
Console.WriteLine("Type: " + threeDEffectiveData.BevelTop.BevelType);
Console.WriteLine("Width: " + threeDEffectiveData.BevelTop.Width);
Console.WriteLine("Height: " + threeDEffectiveData.BevelTop.Height);

获取文本框的有效属性

使用 Aspose.Slides，您可以获取文本框的有效属性。 ITextFrameFormatEffectiveData 接口包含有效的文本框格式属性。

以下代码示例展示了如何获取有效的文本框格式属性。假设第一张幻灯片上的第一个形状是一个带有文本框的 IAutoShape。

using var presentation = new Presentation("sample.pptx");

var slide = presentation.Slides[0];
var shape = (IAutoShape)slide.Shapes[0];

var textFrameFormat = shape.TextFrame.TextFrameFormat;
var effectiveTextFrameFormat = textFrameFormat.GetEffective();

Console.WriteLine("Anchoring type: " + effectiveTextFrameFormat.AnchoringType);
Console.WriteLine("Autofit type: " + effectiveTextFrameFormat.AutofitType);
Console.WriteLine("Text vertical type: " + effectiveTextFrameFormat.TextVerticalType);
Console.WriteLine("Margins");
Console.WriteLine("   Left: " + effectiveTextFrameFormat.MarginLeft);
Console.WriteLine("   Top: " + effectiveTextFrameFormat.MarginTop);
Console.WriteLine("   Right: " + effectiveTextFrameFormat.MarginRight);
Console.WriteLine("   Bottom: " + effectiveTextFrameFormat.MarginBottom);

获取文本样式的有效属性

使用 Aspose.Slides，您可以获取文本样式的有效属性。 ITextStyleEffectiveData 接口包含有效的文本样式属性。

以下代码示例展示了如何获取有效的文本样式属性。假设第一张幻灯片上的第一个形状是一个带有文本框的 IAutoShape。

using var presentation = new Presentation("sample.pptx");

var slide = presentation.Slides[0];
var shape = (IAutoShape)slide.Shapes[0];

var effectiveTextStyle = shape.TextFrame.TextFrameFormat.TextStyle.GetEffective();
var levelCount = 9;

for (var levelIndex = 0; levelIndex < levelCount; levelIndex++)
{
    var effectiveStyleLevel = effectiveTextStyle.GetLevel(levelIndex);
    Console.WriteLine("= Effective paragraph formatting for style level #" + levelIndex + " =");

    Console.WriteLine("Depth: " + effectiveStyleLevel.Depth);
    Console.WriteLine("Indent: " + effectiveStyleLevel.Indent);
    Console.WriteLine("Alignment: " + effectiveStyleLevel.Alignment);
    Console.WriteLine("Font alignment: " + effectiveStyleLevel.FontAlignment);
}

获取有效的字体高度值

使用 Aspose.Slides，您可以获取有效的字体高度。以下代码演示了在演示文稿结构的不同层级上设置本地字体高度后，文本段的有效字体高度如何变化。

using var presentation = new Presentation();

var slide = presentation.Slides[0];
var autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 400, 75, false);
autoShape.AddTextFrame("");

var paragraph = autoShape.TextFrame.Paragraphs[0];
paragraph.Portions.Clear();

var firstPortion = new Portion("Sample text with first portion");
var secondPortion = new Portion(" and second portion.");

paragraph.Portions.Add(firstPortion);
paragraph.Portions.Add(secondPortion);

var firstPortionFormatEffectiveData = firstPortion.PortionFormat.GetEffective();
var secondPortionFormatEffectiveData = secondPortion.PortionFormat.GetEffective();

Console.WriteLine("Effective font height just after creation:");
Console.WriteLine("Portion #0: " + firstPortionFormatEffectiveData.FontHeight);
Console.WriteLine("Portion #1: " + secondPortionFormatEffectiveData.FontHeight);

presentation.DefaultTextStyle.GetLevel(0).DefaultPortionFormat.FontHeight = 24;
firstPortionFormatEffectiveData = firstPortion.PortionFormat.GetEffective();
secondPortionFormatEffectiveData = secondPortion.PortionFormat.GetEffective();

Console.WriteLine("Effective font height after setting the presentation default font height:");
Console.WriteLine("Portion #0: " + firstPortionFormatEffectiveData.FontHeight);
Console.WriteLine("Portion #1: " + secondPortionFormatEffectiveData.FontHeight);

paragraph.ParagraphFormat.DefaultPortionFormat.FontHeight = 40;
firstPortionFormatEffectiveData = firstPortion.PortionFormat.GetEffective();
secondPortionFormatEffectiveData = secondPortion.PortionFormat.GetEffective();

Console.WriteLine("Effective font height after setting paragraph default font height:");
Console.WriteLine("Portion #0: " + firstPortionFormatEffectiveData.FontHeight);
Console.WriteLine("Portion #1: " + secondPortionFormatEffectiveData.FontHeight);

firstPortion.PortionFormat.FontHeight = 55;
firstPortionFormatEffectiveData = firstPortion.PortionFormat.GetEffective();
secondPortionFormatEffectiveData = secondPortion.PortionFormat.GetEffective();

Console.WriteLine("Effective font height after setting portion #0 font height:");
Console.WriteLine("Portion #0: " + firstPortionFormatEffectiveData.FontHeight);
Console.WriteLine("Portion #1: " + secondPortionFormatEffectiveData.FontHeight);

secondPortion.PortionFormat.FontHeight = 18;
firstPortionFormatEffectiveData = firstPortion.PortionFormat.GetEffective();
secondPortionFormatEffectiveData = secondPortion.PortionFormat.GetEffective();

Console.WriteLine("Effective font height after setting portion #1 font height:");
Console.WriteLine("Portion #0: " + firstPortionFormatEffectiveData.FontHeight);
Console.WriteLine("Portion #1: " + secondPortionFormatEffectiveData.FontHeight);

presentation.Save("SetLocalFontHeightValues.pptx", SaveFormat.Pptx);

获取表格的有效填充格式

使用 Aspose.Slides，您可以获取不同表格部件的有效填充格式。 IFillFormatEffectiveData 接口包含有效的填充格式属性。单元格格式的优先级高于行格式，行格式高于列格式，列格式高于整表格式。

因此，在绘制表格单元格时使用 ICellFormatEffectiveData 属性。以下代码示例展示了如何获取不同表格部件的有效填充格式。假设第一张幻灯片上的第一个形状是一个 ITable。

using var presentation = new Presentation("sample.pptx");

var slide = presentation.Slides[0];
var table = (ITable)presentation.Slides[0].Shapes[0];

var tableFormatEffective = table.TableFormat.GetEffective();
var rowFormatEffective = table.Rows[0].RowFormat.GetEffective();
var columnFormatEffective = table.Columns[0].ColumnFormat.GetEffective();
var cellFormatEffective = table[0, 0].CellFormat.GetEffective();

var tableFillFormatEffective = tableFormatEffective.FillFormat;
var rowFillFormatEffective = rowFormatEffective.FillFormat;
var columnFillFormatEffective = columnFormatEffective.FillFormat;
var cellFillFormatEffective = cellFormatEffective.FillFormat;

常见问题

GetEffective 会返回快照吗？

并非总是如此。有效数据表示在应用继承后计算得到的格式，但某些有效数据对象可能在内部被缓存。随后调用 GetEffective 可能会重新计算格式并刷新缓存数据，因此先前获取的对象不应视为持久快照。

何时需要重新读取有效属性？

在更改本地格式、父级样式、布局格式、母版格式或演示文稿级默认值后，请再次调用 GetEffective。下一次调用会重新评估格式层次并返回当前的有效结果。

更改或删除布局/母版幻灯片会影响已检索的有效属性吗？

会，但更改会在下一次 GetEffective 调用时体现。如果父级格式源被更改或删除，先前获取的有效数据可能已过时。再次调用 GetEffective 后，Aspose.Slides 将重新评估格式树， resulting fonts, colors, sizes, or other values may change.

我可以通过有效数据对象修改值吗？

不能。有效数据对象只暴露计算后的值。请在本地格式对象中进行更改，然后再次获取有效值。

如果在形状级别、布局/母版以及全局设置中都未设置属性，会怎样？

有效值由默认机制决定，包括 PowerPoint 和 Aspose.Slides 的默认值。解析得到的值会成为当前有效数据的一部分。

从有效的字体值能否判断是哪个层级提供的大小或字体？

不能直接判断。有效数据只返回最终值。若要找出来源，请检查文本段、段落、文本框以及布局、母版和演示文稿级别的本地值，查看首次出现显式定义的位置。

为什么有效值有时看起来与本地值相同？

因为本地值恰好是最终值（没有更高级别的继承需要）。在这种情况下，有效值与本地值相匹配。

何时使用有效属性，何时仅使用本地属性？

在需要“实际渲染”结果（即所有继承已应用后的最终值）时使用有效数据，例如对齐颜色、缩进或尺寸。如果需要在后续格式更改后保持这些值，请将所需属性复制到自己的对象中。若要在特定层级修改格式，请更改本地属性，然后在需要时再次读取有效数据以验证结果。

在 .NET 中管理演示文稿形状在 .NET 中对演示文稿应用形状动画