Gestionar tablas de presentación con Python

Descripción general

Una tabla en PowerPoint es una forma eficiente de presentar información. La información organizada en una cuadrícula de celdas (filas y columnas) es directa y fácil de entender.

Aspose.Slides proporciona la clase Table , la clase Cell y otros tipos relacionados para ayudarle a crear, actualizar y gestionar tablas en cualquier presentación.

Crear tablas desde cero

Esta sección muestra cómo crear una tabla desde cero en Aspose.Slides añadiendo una forma de tabla a una diapositiva, definiendo sus filas y columnas, y estableciendo tamaños precisos. También verá cómo rellenar celdas con texto, ajustar la alineación y los bordes, y personalizar la apariencia de la tabla.

  1. Cree una instancia de la clase Presentation .
  2. Obtenga una referencia a una diapositiva por su índice.
  3. Defina una matriz de anchos de columna.
  4. Defina una matriz de alturas de fila.
  5. Añada una Table a la diapositiva.
  6. Itere sobre cada Cell y formatee sus bordes superior, inferior, derecho e izquierdo.
  7. Combine las dos primeras celdas en la primera fila de la tabla.
  8. Acceda al TextFrame de una Cell .
  9. Añada texto al TextFrame .
  10. Guarde la presentación modificada.

El siguiente ejemplo en Python muestra cómo crear una tabla en una presentación:

import aspose.pydrawing as draw
import aspose.slides as slides

# Instanciar la clase Presentation que representa un archivo de presentación.
with slides.Presentation() as presentation:
    # Acceder a la primera diapositiva.
    slide = presentation.slides[0]

    # Definir anchos de columna y alturas de fila.
    column_widths = [50, 50, 50]
    row_heights = [50, 30, 30, 30, 30]

    # Agregar una forma de tabla a la diapositiva.
    table = slide.shapes.add_table(100, 50, column_widths, row_heights)

    # Establecer el formato de borde para cada celda.
    for row in table.rows:
        for cell in row:
            cell.cell_format.border_top.fill_format.fill_type = slides.FillType.SOLID
            cell.cell_format.border_top.fill_format.solid_fill_color.color = draw.Color.red
            cell.cell_format.border_top.width = 5

            cell.cell_format.border_bottom.fill_format.fill_type = slides.FillType.SOLID
            cell.cell_format.border_bottom.fill_format.solid_fill_color.color= draw.Color.red
            cell.cell_format.border_bottom.width = 5

            cell.cell_format.border_left.fill_format.fill_type = slides.FillType.SOLID
            cell.cell_format.border_left.fill_format.solid_fill_color.color =draw.Color.red
            cell.cell_format.border_left.width = 5

            cell.cell_format.border_right.fill_format.fill_type = slides.FillType.SOLID
            cell.cell_format.border_right.fill_format.solid_fill_color.color = draw.Color.red
            cell.cell_format.border_right.width = 5
        
    # Combinar celdas desde (fila 0, col 0) hasta (fila 1, col 1).
    table.merge_cells(table.rows[0][0], table.rows[1][1], False)

    # Agregar texto a la celda combinada.
    table.rows[0][0].text_frame.text = "Merged Cells"

    # Guardar la presentación en disco.
    presentation.save("table.pptx", slides.export.SaveFormat.PPTX)

Numeración en tablas estándar

En una tabla estándar, la numeración de celdas es simple y basada en cero. La primera celda de una tabla tiene el índice (0, 0) (columna 0, fila 0).

Por ejemplo, en una tabla con 4 columnas y 4 filas, las celdas se numeran de la siguiente manera:

(0, 0) (1, 0) (2, 0) (3, 0)
(0, 1) (1, 1) (2, 1) (3, 1)
(0, 2) (1, 2) (2, 2) (3, 2)
(0, 3) (1, 3) (2, 3) (3, 3)

El siguiente ejemplo en Python muestra cómo referenciar celdas usando esta numeración basada en cero:

for row_index in range(len(table.rows)):
    for column_index in range(len(table.rows[row_index])):
        cell = table.rows[row_index][column_index]
        cell.text_frame.text = f"({column_index}, {row_index})"

Acceder a una tabla existente

Esta sección explica cómo localizar y trabajar con una tabla existente en una presentación usando Aspose.Slides. Aprenderá a encontrar la tabla en una diapositiva, acceder a sus filas, columnas y celdas, y actualizar el contenido o el formato.

  1. Cree una instancia de la clase Presentation .
  2. Obtenga una referencia a la diapositiva que contiene la tabla por su índice.
  3. Itere a través de todos los objetos Shape hasta que encuentre la tabla.
  4. Utilice el objeto Table para trabajar con la tabla.
  5. Guarde la presentación modificada.

El siguiente ejemplo en Python muestra cómo acceder y trabajar con una tabla existente:

import aspose.pydrawing as draw
import aspose.slides as slides

# Instanciar la clase Presentation para cargar un archivo PPTX.
with slides.Presentation("sample.pptx") as presentation:
    # Acceder a la primera diapositiva.
    slide = presentation.slides[0]

    table = None

    # Recorrer las formas y hacer referencia a la primera tabla encontrada.
    for shape in slide.shapes:
        if isinstance(shape, slides.Table):
            table = shape
            break

    # Establecer el texto de la primera celda de la primera fila.
    if table is not None:
        table.rows[0][0].text_frame.text = "Found"

    # Guardar la presentación modificada en disco.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Alinear texto en tablas

Esta sección muestra cómo controlar la alineación del texto dentro de las celdas de la tabla usando Aspose.Slides. Aprenderá a establecer la alineación horizontal y vertical para las celdas para mantener su contenido claro y coherente.

  1. Cree una instancia de la clase Presentation .
  2. Obtenga una referencia a la diapositiva por su índice.
  3. Añada un objeto Table a la diapositiva.
  4. Acceda a un objeto Cell de la tabla.
  5. Alinee el texto verticalmente.
  6. Guarde la presentación modificada.

El siguiente ejemplo en Python muestra cómo alinear el texto en una tabla:

import aspose.pydrawing as draw
import aspose.slides as slides

# Crear una instancia de la clase Presentation.
with slides.Presentation() as presentation:
    # Acceder a la primera diapositiva.
    slide = presentation.slides[0]

    # Definir anchos de columna y alturas de fila.
    column_widths = [40, 120, 120, 120]
    row_heights = [100, 100, 100, 100]

    # Agregar una forma de tabla a la diapositiva.
    table = slide.shapes.add_table(100, 50, column_widths, row_heights)
    table.rows[0][0].text_frame.text = "Numbers"
    table.rows[1][0].text_frame.text = "10"
    table.rows[2][0].text_frame.text = "20"
    table.rows[3][0].text_frame.text = "30"

    # Centrar el texto y establecer la orientación vertical.
    cell = table.rows[0][0]
    cell.text_anchor_type = slides.TextAnchorType.CENTER
    cell.text_vertical_type = slides.TextVerticalType.VERTICAL270

    # Guardar la presentación en disco.
    presentation.save("aligned_cell.pptx", slides.export.SaveFormat.PPTX)

Establecer formato de texto a nivel de tabla

Esta sección muestra cómo aplicar formato de texto a nivel de tabla en Aspose.Slides para que cada celda herede un estilo consistente y unificado. Aprenderá a establecer tamaños de fuente, alineaciones y márgenes de forma global.

  1. Cree una instancia de la clase Presentation .
  2. Obtenga una referencia a la diapositiva por su índice.
  3. Añada una Table a la diapositiva.
  4. Establezca el tamaño de la fuente (altura de fuente) para el texto.
  5. Establezca la alineación de párrafo y los márgenes.
  6. Establezca la orientación vertical del texto.
  7. Guarde la presentación modificada.

El siguiente ejemplo en Python muestra cómo aplicar sus opciones de formato preferidas al texto en una tabla:

import aspose.pydrawing as draw
import aspose.slides as slides

# Crea una instancia de la clase Presentation
with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    table = slide.shapes.add_table(20, 20, [100, 50, 30], [30, 50, 30])

    # Establece el tamaño de fuente para todas las celdas de la tabla.
    portion_format = slides.PortionFormat()
    portion_format.font_height = 25
    table.set_text_format(portion_format)

    # Establece texto alineado a la derecha y un margen derecho para todas las celdas de la tabla.
    paragraph_format = slides.ParagraphFormat()
    paragraph_format.alignment = slides.TextAlignment.RIGHT
    paragraph_format.margin_right = 20
    table.set_text_format(paragraph_format)

    # Establece la orientación vertical del texto para todas las celdas de la tabla.
    text_frame_format = slides.TextFrameFormat()
    text_frame_format.text_vertical_type = slides.TextVerticalType.VERTICAL
    table.set_text_format(text_frame_format)

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

Aplicar estilos de tabla incorporados

Aspose.Slides le permite formatear tablas usando estilos predefinidos directamente en el código. El ejemplo muestra cómo crear una tabla, aplicar un estilo incorporado y guardar el resultado, una forma eficiente de garantizar un formato consistente y profesional.

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    table = slide.shapes.add_table(10, 10, [100, 150], [5, 5, 5])

    table.style_preset = slides.TableStylePreset.DARK_STYLE1

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

Bloquear relación de aspecto de tablas

La relación de aspecto de una forma es la proporción de sus dimensiones. Aspose.Slides proporciona la propiedad aspect_ratio_locked, que permite bloquear la relación de aspecto para tablas y otras formas.

El siguiente ejemplo en Python muestra cómo bloquear la relación de aspecto para una tabla:

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    table = slide.shapes.add_table(20, 20, [100, 50, 30], [30, 50, 30])

    print(f"Lock aspect ratio set: {table.shape_lock.aspect_ratio_locked}")
    table.shape_lock.aspect_ratio_locked = not table.shape_lock.aspect_ratio_locked
    print(f"Lock aspect ratio set: {table.shape_lock.aspect_ratio_locked}")

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

FAQ

¿Puedo habilitar la dirección de lectura de derecha a izquierda (RTL) para una tabla completa y el texto en sus celdas?

Sí. La tabla expone una propiedad right_to_left y los párrafos tienen ParagraphFormat.right_to_left. Usar ambas garantiza el orden RTL correcto y la representación adecuada dentro de las celdas.

¿Cómo puedo evitar que los usuarios muevan o redimensionen una tabla en el archivo final?

Utilice shape locks para desactivar mover, redimensionar, seleccionar, etc. Estos bloqueos también se aplican a las tablas.

¿Se admite insertar una imagen dentro de una celda como fondo?

Sí. Puede establecer un picture fill para una celda; la imagen cubrirá el área de la celda según el modo elegido (estirado o mosaico).

Administrar filas y columnas en tablas de PowerPoint usando Python