使用 Python 从演示文稿获取形状的有效属性

概览

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

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

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

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

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]

    local_text_frame_format = shape.text_frame.text_frame_format
    effective_text_frame_format = local_text_frame_format.get_effective()

    paragraph = shape.text_frame.paragraphs[0]
    portion = paragraph.portions[0]
    local_portion_format = portion.portion_format
    effective_portion_format = local_portion_format.get_effective()

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

获取相机的有效属性

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

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

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]
    three_d_effective_data = shape.three_d_format.get_effective()
    camera = three_d_effective_data.camera

    camera_type = camera.camera_type
    field_of_view_angle = camera.field_of_view_angle
    zoom = camera.zoom

    print("= Effective camera properties =")
    print("Type: " + str(camera_type))
    print("Field of view: " + str(field_of_view_angle))
    print("Zoom: " + str(zoom))

获取灯光装置的有效属性

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

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

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]
    three_d_effective_data = shape.three_d_format.get_effective()
    light_rig = three_d_effective_data.light_rig

    light_type = light_rig.light_type
    direction = light_rig.direction

    print("= Effective light rig properties =")
    print("Type: " + str(light_type))
    print("Direction: " + str(direction))

获取形状斜角的有效属性

Aspose.Slides 允许您获取形状斜角的有效属性。IShapeBevelEffectiveData 类型表示一个不可变对象，包含形状斜角面的有效属性。一个 IShapeBevelEffectiveData 实例通过 IThreeDFormatEffectiveData 暴露，该对象为 ThreeDFormat 提供有效值。

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

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]
    three_d_effective_data = shape.three_d_format.get_effective()
    top_bevel = three_d_effective_data.bevel_top

    bevel_type = top_bevel.bevel_type
    bevel_width = top_bevel.width
    bevel_height = top_bevel.height

    print("= Effective shape's top face relief properties =")
    print("Type: " + str(bevel_type))
    print("Width: " + str(bevel_width))
    print("Height: " + str(bevel_height))

获取文本框的有效属性

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

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

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]

    text_frame_format = shape.text_frame.text_frame_format
    effective_text_frame_format = text_frame_format.get_effective()

    anchoring_type = effective_text_frame_format.anchoring_type
    autofit_type = effective_text_frame_format.autofit_type
    text_vertical_type = effective_text_frame_format.text_vertical_type
    margin_left = effective_text_frame_format.margin_left
    margin_top = effective_text_frame_format.margin_top
    margin_right = effective_text_frame_format.margin_right
    margin_bottom = effective_text_frame_format.margin_bottom

    print("Anchoring type: " + str(anchoring_type))
    print("Autofit type: " + str(autofit_type))
    print("Text vertical type: " + str(text_vertical_type))
    print("Margins")
    print("   Left: " + str(margin_left))
    print("   Top: " + str(margin_top))
    print("   Right: " + str(margin_right))
    print("   Bottom: " + str(margin_bottom))

获取文本样式的有效属性

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

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

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]
    text_frame_format = shape.text_frame.text_frame_format
    text_style = text_frame_format.text_style
    effective_text_style = text_style.get_effective()
    level_count = 9

    for level_index in range(level_count):
        effective_style_level = effective_text_style.get_level(level_index)
        depth = effective_style_level.depth
        indent = effective_style_level.indent
        alignment = effective_style_level.alignment
        font_alignment = effective_style_level.font_alignment

        print("= Effective paragraph formatting for style level #" + str(level_index) + " =")

        print("Depth: " + str(depth))
        print("Indent: " + str(indent))
        print("Alignment: " + str(alignment))
        print("Font alignment: " + str(font_alignment))

获取有效的字体高度值

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

import aspose.slides as slides

with slides.Presentation() as presentation:
    auto_shape = presentation.slides[0].shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 400, 75, False)
    auto_shape.add_text_frame("")

    paragraph = auto_shape.text_frame.paragraphs[0]
    paragraph.portions.clear()

    first_portion = slides.Portion("Sample text with first portion")
    second_portion = slides.Portion(" and second portion.")

    paragraph.portions.add(first_portion)
    paragraph.portions.add(second_portion)

    print("Effective font height just after creation:")
    first_portion_font_height = first_portion.portion_format.get_effective().font_height
    second_portion_font_height = second_portion.portion_format.get_effective().font_height
    print("Portion #0: " + str(first_portion_font_height))
    print("Portion #1: " + str(second_portion_font_height))

    default_text_style_level = presentation.default_text_style.get_level(0)
    default_text_style_level.default_portion_format.font_height = 24

    print("Effective font height after setting the presentation default font height:")
    first_portion_font_height = first_portion.portion_format.get_effective().font_height
    second_portion_font_height = second_portion.portion_format.get_effective().font_height
    print("Portion #0: " + str(first_portion_font_height))
    print("Portion #1: " + str(second_portion_font_height))

    paragraph.paragraph_format.default_portion_format.font_height = 40

    print("Effective font height after setting paragraph default font height:")
    first_portion_font_height = first_portion.portion_format.get_effective().font_height
    second_portion_font_height = second_portion.portion_format.get_effective().font_height
    print("Portion #0: " + str(first_portion_font_height))
    print("Portion #1: " + str(second_portion_font_height))

    first_portion.portion_format.font_height = 55

    print("Effective font height after setting portion #0 font height:")
    first_portion_font_height = first_portion.portion_format.get_effective().font_height
    second_portion_font_height = second_portion.portion_format.get_effective().font_height
    print("Portion #0: " + str(first_portion_font_height))
    print("Portion #1: " + str(second_portion_font_height))

    second_portion.portion_format.font_height = 18

    print("Effective font height after setting portion #1 font height:")
    first_portion_font_height = first_portion.portion_format.get_effective().font_height
    second_portion_font_height = second_portion.portion_format.get_effective().font_height
    print("Portion #0: " + str(first_portion_font_height))
    print("Portion #1: " + str(second_portion_font_height))

    presentation.save("SetLocalFontHeightValues.pptx", slides.export.SaveFormat.PPTX)

获取表格的有效填充格式

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

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

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    table = presentation.slides[0].shapes[0]
    first_row = table.rows[0]
    first_column = table.columns[0]
    first_cell = first_row[0]

    table_format_effective = table.table_format.get_effective()
    row_format_effective = first_row.row_format.get_effective()
    column_format_effective = first_column.column_format.get_effective()
    cell_format_effective = first_cell.cell_format.get_effective()

    table_fill_format_effective = table_format_effective.fill_format
    row_fill_format_effective = row_format_effective.fill_format
    column_fill_format_effective = column_format_effective.fill_format
    cell_fill_format_effective = cell_format_effective.fill_format

常见问题

get_effective 会返回快照吗？

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

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

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

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

会，但更改会在下次 get_effective 调用时体现。如果父级格式源被更改或删除，先前获取的有效数据可能已经过时。再次调用 get_effective 后，Aspose.Slides 会重新评估格式树，返回的字体、颜色、大小等值可能会改变。

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

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

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

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

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

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

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

因为本地值已经是最终值（不需要更高层级的继承）。在这种情况下，有效值与本地值相同。

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

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

使用 Python 管理演示文稿中的形状在演示文稿中使用 Python 应用形状动画