形状有效属性

在本主题中，我们将讨论有效和局部属性。当我们在这些级别直接设置值时

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

这些值被称为局部值。在任何级别上，局部值都可以定义或省略。但是，当应用程序需要知道部分应该是什么样子时，它使用有效值。您可以通过使用局部格式的**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 Java 允许开发者获取相机的有效属性。为此，Aspose.Slides 中添加了ICameraEffectiveData接口。 ICameraEffectiveData接口表示一个不可变对象，包含有效的相机属性。 ICameraEffectiveData接口的实例作为IThreeDFormatEffectiveData接口的一部分，该接口是ThreeDFormat类的有效值对。

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

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

    System.out.println("= 有效的相机属性 =");
    System.out.println("类型: " + threeDEffectiveData.getCamera().getCameraType());
    System.out.println("视野: " + threeDEffectiveData.getCamera().getFieldOfViewAngle());
    System.out.println("缩放: " + threeDEffectiveData.getCamera().getZoom());
} finally {
    if (pres != null) pres.dispose();
}

获取光源设备的有效属性

Aspose.Slides for Java 允许开发者获取光源设备的有效属性。为此，Aspose.Slides 中添加了ILightRigEffectiveData接口。 ILightRigEffectiveData接口表示一个不可变对象，包含有效的光源设备属性。 ILightRigEffectiveData接口的实例作为IThreeDFormatEffectiveData接口的一部分，该接口是ThreeDFormat类的有效值对。

以下示例代码演示了如何获取光源设备的有效属性：

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

    System.out.println("= 有效的光源设备属性 =");
    System.out.println("类型: " + threeDEffectiveData.getLightRig().getLightType());
    System.out.println("方向: " + threeDEffectiveData.getLightRig().getDirection());
} finally {
    if (pres != null) pres.dispose();
}

获取斜角形状的有效属性

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

以下示例代码演示了如何获取斜角形状的有效属性：

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

    System.out.println("= 有效形状的顶部浮雕属性 =");
    System.out.println("类型: " + threeDEffectiveData.getBevelTop().getBevelType());
    System.out.println("宽度: " + threeDEffectiveData.getBevelTop().getWidth());
    System.out.println("高度: " + threeDEffectiveData.getBevelTop().getHeight());
} finally {
    if (pres != null) pres.dispose();
}

获取文本框的有效属性

使用 Aspose.Slides for Java，您可以获取文本框的有效属性。为此，Aspose.Slides 中添加了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("锚定类型: " + effectiveTextFrameFormat.getAnchoringType());
    System.out.println("自动调整类型: " + effectiveTextFrameFormat.getAutofitType());
    System.out.println("文本垂直类型: " + effectiveTextFrameFormat.getTextVerticalType());
    System.out.println("边距");
    System.out.println("   左边: " + effectiveTextFrameFormat.getMarginLeft());
    System.out.println("   上边: " + effectiveTextFrameFormat.getMarginTop());
    System.out.println("   右边: " + effectiveTextFrameFormat.getMarginRight());
    System.out.println("   下边: " + effectiveTextFrameFormat.getMarginBottom());
} finally {
    if (pres != null) pres.dispose();
}

获取文本样式的有效属性

使用 Aspose.Slides for Java，您可以获取文本样式的有效属性。为此，Aspose.Slides 中添加了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("= 第 #" + i + " 样式级别的有效段落格式 =");

        System.out.println("深度: " + effectiveStyleLevel.getDepth());
        System.out.println("缩进: " + effectiveStyleLevel.getIndent());
        System.out.println("对齐: " + effectiveStyleLevel.getAlignment());
        System.out.println("字体对齐: " + effectiveStyleLevel.getFontAlignment());
    }
} finally {
    if (pres != null) pres.dispose();
}

获取有效字体高度值

使用 Aspose.Slides for 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("第一个部分的示例文本");
    IPortion portion1 = new Portion(" 和第二个部分。");

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

    System.out.println("创建后有效字体高度：");
    System.out.println("部分 #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("部分 #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

    pres.getDefaultTextStyle().getLevel(0).getDefaultPortionFormat().setFontHeight(24);
    System.out.println("设置整个演示文稿默认字体高度后有效字体高度：");
    System.out.println("部分 #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("部分 #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

    newShape.getTextFrame().getParagraphs().get_Item(0).getParagraphFormat().getDefaultPortionFormat().setFontHeight(40);
    System.out.println("设置段落默认字体高度后有效字体高度：");
    System.out.println("部分 #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("部分 #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

    newShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat().setFontHeight(55);
    System.out.println("设置部分 #0 字体高度后有效字体高度：");
    System.out.println("部分 #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("部分 #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

    newShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(1).getPortionFormat().setFontHeight(18);
    System.out.println("设置部分 #1 字体高度后有效字体高度：");
    System.out.println("部分 #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("部分 #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

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

获取表格的有效填充格式

使用 Aspose.Slides for Java，您可以获取不同表格逻辑部分的有效填充格式。为此，Aspose.Slides 中添加了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();
}

形状操作形状动画