在 Android 上从演示文稿获取形状有效属性

在本主题中，我们将讨论 effective 和 local 属性。当我们在这些层级直接设置值时

在部分的幻灯片上设置部分属性；
在布局或母版幻灯片的原型形状文本样式上（如果该部分的文本框形状有的话）；
在演示文稿的全局文本设置中；

这些值称为 local 值。在任何层级，local 值可以被定义或省略。但是当应用程序需要了解该部分应如何显示时，它会使用 effective 值。您可以通过从本地格式调用 getEffective() 方法来获取有效值。

此示例代码展示了如何获取有效值：

Presentation pres = new Presentation("Presentation1.pptx");
try {
    IAutoShape shape = (IAutoShape)pres.getSlides().get_Item(0).getShapes().get_Item(0);

    ITextFrameFormat localTextFrameFormat = shape.getTextFrame().getTextFrameFormat();
    ITextFrameFormatEffectiveData effectiveTextFrameFormat = localTextFrameFormat.getEffective();

    IPortionFormat localPortionFormat = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat();
    IPortionFormatEffectiveData effectivePortionFormat = localPortionFormat.getEffective();
} finally {
    if (pres != null) pres.dispose();
}

获取相机的有效属性

Aspose.Slides for Android via Java 允许开发人员获取相机的有效属性。为此，添加了 ICameraEffectiveData 接口。 ICameraEffectiveData 接口表示一个不可变对象，包含有效的相机属性。 ICameraEffectiveData 接口的实例作为 IThreeDFormatEffectiveData 接口的一部分使用，该接口是 ThreeDFormat 类的 effective values 对。

此示例代码展示了如何获取相机的有效属性：

Presentation pres = new Presentation("Presentation1.pptx");
try {
    IThreeDFormatEffectiveData threeDEffectiveData = pres.getSlides().get_Item(0).getShapes().get_Item(0).getThreeDFormat().getEffective();

    System.out.println("= Effective camera properties =");
    System.out.println("Type: " + threeDEffectiveData.getCamera().getCameraType());
    System.out.println("Field of view: " + threeDEffectiveData.getCamera().getFieldOfViewAngle());
    System.out.println("Zoom: " + threeDEffectiveData.getCamera().getZoom());
} finally {
    if (pres != null) pres.dispose();
}

获取灯光装置的有效属性

Aspose.Slides for Android via Java 允许开发人员获取灯光装置的有效属性。为此，添加了 ILightRigEffectiveData 接口。 ILightRigEffectiveData 接口表示一个不可变对象，包含有效的灯光装置属性。 ILightRigEffectiveData 接口的实例作为 IThreeDFormatEffectiveData 接口的一部分使用，该接口是 ThreeDFormat 类的 effective values 对。

此示例代码展示了如何获取灯光装置的有效属性：

Presentation pres = new Presentation("Presentation1.pptx");
try {
    IThreeDFormatEffectiveData threeDEffectiveData = pres.getSlides().get_Item(0).getShapes().get_Item(0).getThreeDFormat().getEffective();

    System.out.println("= Effective light rig properties =");
    System.out.println("Type: " + threeDEffectiveData.getLightRig().getLightType());
    System.out.println("Direction: " + threeDEffectiveData.getLightRig().getDirection());
} finally {
    if (pres != null) pres.dispose();
}

获取斜面形状的有效属性

Aspose.Slides for Android via Java 允许开发人员获取斜面形状的有效属性。为此，添加了 IShapeBevelEffectiveData 接口。 IShapeBevelEffectiveData 接口表示一个不可变对象，包含有效的形状面部浮雕属性。 IShapeBevelEffectiveData 接口的实例作为 IThreeDFormatEffectiveData 接口的一部分使用，该接口是 ThreeDFormat 类的 effective values 对。

此示例代码展示了如何获取斜面形状的有效属性：

Presentation pres = new Presentation("Presentation1.pptx");
try {
    IThreeDFormatEffectiveData threeDEffectiveData = pres.getSlides().get_Item(0).getShapes().get_Item(0).getThreeDFormat().getEffective();

    System.out.println("= Effective shape's top face relief properties =");
    System.out.println("Type: " + threeDEffectiveData.getBevelTop().getBevelType());
    System.out.println("Width: " + threeDEffectiveData.getBevelTop().getWidth());
    System.out.println("Height: " + threeDEffectiveData.getBevelTop().getHeight());
} finally {
    if (pres != null) pres.dispose();
}

获取文本框的有效属性

使用 Aspose.Slides for Android via Java，您可以获取文本框的有效属性。为此，添加了 ITextFrameFormatEffectiveData 接口，包含有效的文本框格式属性。

此示例代码展示了如何获取有效的文本框格式属性：

Presentation pres = new Presentation("Presentation1.pptx");
try {
    IAutoShape shape = (IAutoShape)pres.getSlides().get_Item(0).getShapes().get_Item(0);
    ITextFrameFormatEffectiveData effectiveTextFrameFormat = shape.getTextFrame().getTextFrameFormat().getEffective();

    System.out.println("Anchoring type: " + effectiveTextFrameFormat.getAnchoringType());
    System.out.println("Autofit type: " + effectiveTextFrameFormat.getAutofitType());
    System.out.println("Text vertical type: " + effectiveTextFrameFormat.getTextVerticalType());
    System.out.println("Margins");
    System.out.println("   Left: " + effectiveTextFrameFormat.getMarginLeft());
    System.out.println("   Top: " + effectiveTextFrameFormat.getMarginTop());
    System.out.println("   Right: " + effectiveTextFrameFormat.getMarginRight());
    System.out.println("   Bottom: " + effectiveTextFrameFormat.getMarginBottom());
} finally {
    if (pres != null) pres.dispose();
}

获取文本样式的有效属性

使用 Aspose.Slides for Android via Java，您可以获取文本样式的有效属性。为此，添加了 ITextStyleEffectiveData 接口，包含有效的文本样式属性。

此示例代码展示了如何获取有效的文本样式属性：

Presentation pres = new Presentation("Presentation1.pptx");
try {
    IAutoShape shape = (IAutoShape)pres.getSlides().get_Item(0).getShapes().get_Item(0);
    ITextStyleEffectiveData effectiveTextStyle = shape.getTextFrame().getTextFrameFormat().getTextStyle().getEffective();

    for (int i = 0; i <= 8; i++)
    {
        IParagraphFormatEffectiveData effectiveStyleLevel = effectiveTextStyle.getLevel(i);
        System.out.println("= Effective paragraph formatting for style level #" + i + " =");

        System.out.println("Depth: " + effectiveStyleLevel.getDepth());
        System.out.println("Indent: " + effectiveStyleLevel.getIndent());
        System.out.println("Alignment: " + effectiveStyleLevel.getAlignment());
        System.out.println("Font alignment: " + effectiveStyleLevel.getFontAlignment());
    }
} finally {
    if (pres != null) pres.dispose();
}

获取有效的字体高度值

使用 Aspose.Slides for Android via Java，您可以获取字体高度的有效属性。此处提供的代码显示在不同演示文稿结构层级上设置本地字体高度后，部分的有效字体高度值会发生变化：

Presentation pres = new Presentation();
try {
    IAutoShape newShape = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 400, 75, false);
    newShape.addTextFrame("");
    newShape.getTextFrame().getParagraphs().get_Item(0).getPortions().clear();

    IPortion portion0 = new Portion("Sample text with first portion");
    IPortion portion1 = new Portion(" and second portion.");

    newShape.getTextFrame().getParagraphs().get_Item(0).getPortions().add(portion0);
    newShape.getTextFrame().getParagraphs().get_Item(0).getPortions().add(portion1);

    System.out.println("Effective font height just after creation:");
    System.out.println("Portion #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("Portion #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

    pres.getDefaultTextStyle().getLevel(0).getDefaultPortionFormat().setFontHeight(24);
    System.out.println("Effective font height after setting entire presentation default font height:");
    System.out.println("Portion #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("Portion #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

    newShape.getTextFrame().getParagraphs().get_Item(0).getParagraphFormat().getDefaultPortionFormat().setFontHeight(40);
    System.out.println("Effective font height after setting paragraph default font height:");
    System.out.println("Portion #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("Portion #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

    newShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat().setFontHeight(55);
    System.out.println("Effective font height after setting portion #0 font height:");
    System.out.println("Portion #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("Portion #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

    newShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(1).getPortionFormat().setFontHeight(18);
    System.out.println("Effective font height after setting portion #1 font height:");
    System.out.println("Portion #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("Portion #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

    pres.save("SetLocalFontHeightValues.pptx",SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

获取表格的有效填充格式

使用 Aspose.Slides for Android via Java，您可以获取不同表格逻辑部分的有效填充格式。为此，添加了 ICellFormatEffectiveData 接口，包含有效的填充格式属性。请注意：单元格格式始终优先于行格式；行格式优先于列格式；列格式优先于整张表。

Presentation pres = new Presentation("Presentation1.pptx");
try {
    ITable tbl = (ITable)pres.getSlides().get_Item(0).getShapes().get_Item(0);
    ITableFormatEffectiveData tableFormatEffective = tbl.getTableFormat().getEffective();
    IRowFormatEffectiveData rowFormatEffective = tbl.getRows().get_Item(0).getRowFormat().getEffective();
    IColumnFormatEffectiveData columnFormatEffective = tbl.getColumns().get_Item(0).getColumnFormat().getEffective();
    ICellFormatEffectiveData cellFormatEffective = tbl.get_Item(0, 0).getCellFormat().getEffective();

    IFillFormatEffectiveData tableFillFormatEffective = tableFormatEffective.getFillFormat();
    IFillFormatEffectiveData rowFillFormatEffective = rowFormatEffective.getFillFormat();
    IFillFormatEffectiveData columnFillFormatEffective = columnFormatEffective.getFillFormat();
    IFillFormatEffectiveData cellFillFormatEffective = cellFormatEffective.getFillFormat();
} finally {
    if (pres != null) pres.dispose();
}

FAQ

如何判断我得到的是“快照”而不是“实时对象”，以及何时需要重新读取有效属性？ EffectiveData 对象是计算时刻的不可变快照。如果您更改了形状的本地或继承设置，需要再次检索有效数据以获得更新后的值。

更改布局/母版幻灯片会影响已检索的有效属性吗？ 会，但只有在再次读取后才会生效。已经获得的 EffectiveData 对象不会自行更新——在更改布局或母版后请重新请求。

可以通过 EffectiveData 修改值吗？ 不能。EffectiveData 是只读的。请在本地格式对象（形状/文本/3D 等）中进行更改，然后再次获取有效值。

如果属性在形状层级、布局/母版以及全局设置中都未设置，会发生什么？ 有效值将由默认机制（PowerPoint/Aspose.Slides 默认值）决定。该解析后的值将成为 EffectiveData 快照的一部分。

从有效的字体值能否判断是哪一级提供了大小或字体？ 不能直接判断。EffectiveData 返回最终值。若需追溯来源，请检查部分/段落/文本框的本地值以及布局/母版/演示文稿的文本样式，寻找首次出现的显式定义。

为什么 EffectiveData 值有时看起来与本地值相同？ 因为本地值已成为最终值（无需更高层级的继承）。在这种情况下，有效值与本地值相匹配。

何时应使用有效属性，何时仅使用本地属性？ 当您需要在所有继承应用后的“渲染结果”（例如对齐颜色、缩进或尺寸）时使用 EffectiveData。如果您需要在特定层级修改格式，请修改本地属性，然后在需要时重新读取 EffectiveData 以验证结果。

在 Android 上管理演示文稿形状在 Android 上的演示文稿中应用形状动画