Formato del texto de presentación en Python
Visión general
Este artículo muestra cómo dar formato al texto en presentaciones de PowerPoint y OpenDocument mediante Aspose.Slides para Python a través de .NET. Cubre colores de fondo, transparencia, espaciado de caracteres, propiedades de fuente, rotación, espaciado de párrafos, comportamiento de ajuste automático, anclado de texto, tabulaciones y configuración de idioma.
A menos que se indique lo contrario, los ejemplos utilizan sample.pptx. La primera forma en su primera diapositiva es un cuadro de texto, y su primer párrafo contiene el texto que se muestra a continuación. Tanto los índices de diapositiva como de forma son base cero. Los ejemplos que seleccionan porciones en negrita utilizan formato efectivo, incluido el formato de negrita heredado:

Para buscar y resaltar texto literal o coincidencias de expresiones regulares, consulte Buscar y Reemplazar Texto.
Establecer color de fondo del texto
Utilice ParagraphFormat.default_portion_format para establecer el color de resaltado predeterminado de un párrafo, o BasePortionFormat.highlight_color para porciones de texto individuales.
El siguiente ejemplo establece un resaltado gris claro como predeterminado para el primer párrafo. Los colores de resaltado explícitos en porciones individuales tienen prioridad sobre este predeterminado:
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
# Establecer el color de resaltado para todo el párrafo.
paragraph.paragraph_format.default_portion_format.highlight_color.color = draw.Color.light_gray
presentation.save("gray_paragraph.pptx", slides.export.SaveFormat.PPTX)
El resultado:

El siguiente ejemplo de código muestra cómo establecer el color de fondo para porciones de texto con fuente en negrita:
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
for portion in paragraph.portions:
if portion.portion_format.get_effective().font_bold:
# Establecer el color de resaltado para la porción de texto.
portion.portion_format.highlight_color.color = draw.Color.light_gray
presentation.save("gray_text_portions.pptx", slides.export.SaveFormat.PPTX)
El resultado:

Alinear párrafos de texto
Utilice ParagraphFormat.alignment para establecer la alineación del párrafo dentro de un marco de texto. El valor puede ser centrado, alineado a la izquierda, a la derecha, justificado, etc.
El siguiente ejemplo de código muestra cómo alinear el párrafo al centro:
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
# Establecer la alineación del párrafo al centro.
paragraph.paragraph_format.alignment = slides.TextAlignment.CENTER
presentation.save("aligned_paragraph.pptx", slides.export.SaveFormat.PPTX)
El resultado:

Alinear fuentes dentro de una línea
Utilice ParagraphFormat.font_alignment para alinear verticalmente las porciones de texto de diferentes tamaños de fuente dentro de una línea. Esta configuración se aplica a todo el párrafo y controla la alineación dentro de cada una de sus líneas.
El siguiente ejemplo autónomo crea cuatro cuadros de texto etiquetados en una diapositiva. Cada párrafo contiene el mismo texto en 18, 36 y 54 puntos, con una alineación de fuente diferente. Utiliza Arial, desactiva el ajuste automático y el ajuste de línea, y mantiene los marcos de texto lo suficientemente grandes para una sola línea.
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
alignments = [slides.FontAlignment.BASELINE, slides.FontAlignment.TOP, slides.FontAlignment.CENTER, slides.FontAlignment.BOTTOM]
font_sizes = [18, 36, 54]
for i, alignment in enumerate(alignments):
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 30, 20 + i * 130, 660, 120)
shape.fill_format.fill_type = slides.FillType.NO_FILL
shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL
text_frame = shape.text_frame
text_frame.text_frame_format.anchoring_type = slides.TextAnchorType.TOP
text_frame.text_frame_format.autofit_type = slides.TextAutofitType.NONE
text_frame.text_frame_format.wrap_text = slides.NullableBool.FALSE
label = text_frame.paragraphs[0]
label.text = alignment.name.title()
label.paragraph_format.alignment = slides.TextAlignment.LEFT
label.paragraph_format.default_portion_format.font_height = 14
label.paragraph_format.default_portion_format.latin_font = slides.FontData("Arial")
label.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
label.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.gray
paragraph = slides.Paragraph()
paragraph.paragraph_format.font_alignment = alignment
paragraph.paragraph_format.alignment = slides.TextAlignment.LEFT
paragraph.paragraph_format.default_portion_format.latin_font = slides.FontData("Arial")
paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
for font_size in font_sizes:
portion = slides.Portion("Ag ")
portion.portion_format.font_height = font_size
paragraph.portions.add(portion)
text_frame.paragraphs.add(paragraph)
presentation.save("font_alignment.pptx", slides.export.SaveFormat.PPTX)
El resultado:

La alineación de fuente utiliza métricas tipográficas, por lo que los bordes visibles de letras individuales no siempre coinciden exactamente. El ejemplo incluye tanto una letra mayúscula como un descendente para mostrar la diferencia entre la alineación de línea de base y la inferior. La disponibilidad y sustitución de fuentes, los caracteres utilizados y la diferencia de tamaños de fuente afectan el resultado. Las dimensiones del marco, márgenes, espaciado de líneas, ajuste de línea y ajuste automático también influyen en el diseño; utilice las mismas fuentes y configuraciones de diseño al comparar modos.
Esta configuración difiere de ParagraphFormat.alignment, que controla la alineación horizontal del párrafo, y de TextFrameFormat.anchoring_type, que posiciona el bloque de texto verticalmente dentro de su forma. El formato de superíndice y subíndice mediante BasePortionFormat.escapement desplaza las porciones individuales respecto a la línea de base en lugar de establecer la alineación de fuente para las líneas del párrafo.
Establecer transparencia del texto
La transparencia del texto se controla mediante el componente alfa del color asignado a BasePortionFormat.fill_format. En los ejemplos siguientes, alpha = 50 es un valor alfa ARGB en la escala 0‑255, no un porcentaje de transparencia.
El siguiente ejemplo de código muestra cómo aplicar transparencia al párrafo completo:
import aspose.pydrawing as draw
import aspose.slides as slides
alpha = 50
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
# Establecer un relleno negro semitransparente para el texto.
paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.from_argb(alpha, draw.Color.black)
presentation.save("transparent_paragraph.pptx", slides.export.SaveFormat.PPTX)
El resultado:

El siguiente ejemplo de código muestra cómo aplicar transparencia a porciones de texto con fuente en negrita:
import aspose.pydrawing as draw
import aspose.slides as slides
alpha = 50
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
for portion in paragraph.portions:
if portion.portion_format.get_effective().font_bold:
# Establecer la transparencia de la porción de texto.
portion.portion_format.fill_format.fill_type = slides.FillType.SOLID
portion.portion_format.fill_format.solid_fill_color.color = draw.Color.from_argb(alpha, draw.Color.black)
presentation.save("transparent_text_portions.pptx", slides.export.SaveFormat.PPTX)
El resultado:

Establecer espaciado de caracteres del texto
Utilice BasePortionFormat.spacing para ampliar o condensar el espacio entre caracteres en un cuadro de texto. Los ejemplos añaden 3 puntos de espaciado; los valores negativos condensan el texto.
El siguiente código Python muestra cómo ampliar el espaciado de caracteres en el párrafo completo:
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
# Nota: Use valores negativos para comprimir el espaciado de caracteres.
paragraph.paragraph_format.default_portion_format.spacing = 3 # Ampliar el espaciado de caracteres.
presentation.save("character_spacing_in_paragraph.pptx", slides.export.SaveFormat.PPTX)
El resultado:

El siguiente ejemplo de código muestra cómo ampliar el espaciado de caracteres en porciones de texto con fuente en negrita:
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
for portion in paragraph.portions:
if portion.portion_format.get_effective().font_bold:
# Nota: Use valores negativos para comprimir el espaciado de caracteres.
portion.portion_format.spacing = 3 # Ampliar el espaciado de caracteres.
presentation.save("character_spacing_in_text_portions.pptx", slides.export.SaveFormat.PPTX)
El resultado:

Desactivar el kerning para fuentes específicas
En algunos casos, el texto renderizado por Aspose.Slides puede aparecer ligeramente más ajustado que el mismo texto mostrado en PowerPoint. Esto puede ocurrir porque PowerPoint puede ignorar los datos de kerning para determinadas fuentes, incluso cuando la fuente contiene información de kerning válida y el kerning está habilitado en la configuración de PowerPoint.
Para que la salida renderizada se acerque más a la de PowerPoint en esos casos, puede desactivar el kerning para las porciones de texto que usan la fuente afectada. Establezca BasePortionFormat.kerning_minimal_size a un valor mayor que el tamaño real de la fuente. Este ejemplo requiere “presentation.pptx” con un cuadro de texto como primera forma en la primera diapositiva. Comprueba los nombres de fuentes efectivos, incluidas las fuentes heredadas, y establece un umbral de 100 puntos para las porciones que usan Roboto. Esto desactiva el kerning para las porciones coincidentes con un tamaño de fuente inferior a 100 puntos:
import aspose.slides as slides
with slides.Presentation("presentation.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
target_font = "Roboto"
for paragraph in auto_shape.text_frame.paragraphs:
for portion in paragraph.portions:
text_format = portion.portion_format.get_effective()
fonts = (text_format.latin_font, text_format.east_asian_font, text_format.complex_script_font)
uses_target_font = any(font is not None and font.font_name == target_font for font in fonts)
if uses_target_font:
portion.portion_format.kerning_minimal_size = 100
presentation.save("output.pptx", slides.export.SaveFormat.PPTX)
Para el texto coincidente por debajo del umbral, esta configuración evita el kerning y puede ayudar a alinear la representación de Aspose.Slides con la salida visual de PowerPoint para las fuentes afectadas por este comportamiento específico de PowerPoint.
Gestionar propiedades de fuente del texto
Las propiedades de fuente pueden establecerse a nivel de párrafo mediante ParagraphFormat.default_portion_format o en porciones individuales mediante PortionFormat.
El siguiente ejemplo establece la fuente predeterminada del primer párrafo en Times New Roman 12 puntos con formato negrita, cursiva y subrayado punteado. El formato explícito en porciones individuales tiene prioridad sobre estos valores predeterminados.
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
# Establecer las propiedades de fuente del párrafo.
portion_format = paragraph.paragraph_format.default_portion_format
portion_format.font_height = 12
portion_format.font_bold = slides.NullableBool.TRUE
portion_format.font_italic = slides.NullableBool.TRUE
portion_format.font_underline = slides.TextUnderlineType.DOTTED
portion_format.latin_font = slides.FontData("Times New Roman")
presentation.save("font_properties_for_paragraph.pptx", slides.export.SaveFormat.PPTX)
El resultado:

El siguiente ejemplo aplica Times New Roman 13 puntos, formato cursiva y subrayado punteado a las porciones cuyo formato efectivo es negrita:
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
for portion in paragraph.portions:
if portion.portion_format.get_effective().font_bold:
# Establecer las propiedades de fuente para la porción de texto.
portion.portion_format.font_height = 13
portion.portion_format.font_italic = slides.NullableBool.TRUE
portion.portion_format.font_underline = slides.TextUnderlineType.DOTTED
portion.portion_format.latin_font = slides.FontData("Times New Roman")
presentation.save("font_properties_for_text_portions.pptx", slides.export.SaveFormat.PPTX)
El resultado:

Controlar la normalización de altura del texto
Utilice BasePortionFormat.normalise_height al reproducir tipografía de plantilla o investigar diferencias en la altura de los caracteres. En PowerPoint, habilitar la normalización estira o comprime verticalmente los caracteres individuales para darles una altura visible uniforme dentro de la porción de texto. No garantiza alturas de texto iguales entre diferentes fuentes.
Establezca la propiedad en NullableBool.TRUE o FALSE para habilitar o deshabilitar explícitamente la normalización. NullableBool.NOT_DEFINED deja la configuración local sin definir, de modo que la porción hereda su valor, por ejemplo, del default_portion_format del párrafo. No equivale a False. Utilice PortionFormat.get_effective y lea IBasePortionFormatEffectiveData.normalise_height para obtener el valor booleano resuelto.
El siguiente ejemplo autónomo requiere que Arial esté instalado. Crea dos bloques de texto que contienen las mismas letras mayúsculas, minúsculas, descendentes y caracteres acentuados a 54 puntos. Ambos párrafos habilitan la normalización por defecto. La porción superior la desactiva explícitamente; la inferior la hereda. Los tamaños del marco, márgenes y espaciado de párrafo son idénticos, con ajuste automático y ajuste de línea desactivados para mantener la comparación coherente. El ejemplo imprime FALSE: False y NOT_DEFINED: True, luego guarda “text_height_normalization.pptx”.
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
settings = [slides.NullableBool.FALSE, slides.NullableBool.NOT_DEFINED]
for i, setting in enumerate(settings):
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 30, 60 + i * 200, 660, 150)
shape.fill_format.fill_type = slides.FillType.NO_FILL
shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL
text_frame = shape.text_frame
text_frame.text = "Hxgjpq ÅÉ 0123"
text_frame.text_frame_format.autofit_type = slides.TextAutofitType.NONE
text_frame.text_frame_format.wrap_text = slides.NullableBool.FALSE
text_frame.text_frame_format.anchoring_type = slides.TextAnchorType.TOP
text_frame.text_frame_format.margin_top = 0
text_frame.text_frame_format.margin_left = 0
paragraph = text_frame.paragraphs[0]
paragraph.paragraph_format.alignment = slides.TextAlignment.LEFT
paragraph.paragraph_format.space_before = 0
paragraph.paragraph_format.space_after = 0
paragraph.paragraph_format.space_within = 100
paragraph.paragraph_format.default_portion_format.normalise_height = slides.NullableBool.TRUE
portion = paragraph.portions[0]
portion.portion_format.latin_font = slides.FontData("Arial")
portion.portion_format.font_height = 54
portion.portion_format.fill_format.fill_type = slides.FillType.SOLID
portion.portion_format.fill_format.solid_fill_color.color = "black"
portion.portion_format.normalise_height = setting
print(f"{setting.name}: {portion.portion_format.get_effective().normalise_height}")
presentation.save("text_height_normalization.pptx", slides.export.SaveFormat.PPTX)
La comparación a continuación se exportó de la presentación guardada. La fila superior tiene la normalización desactivada (FALSE); la fila inferior hereda la configuración habilitada (NOT_DEFINED → True). Mantenga Arial instalado para reproducir esta apariencia.

La normalización cambia la altura de los caracteres sin modificar el valor asignado a font_height, que especifica el tamaño de fuente en puntos. El space_within del párrafo controla el interlineado, mientras que autofit_type del marco de texto controla cómo el texto o su contenedor se ajusta para encajar. Estas configuraciones sirven a propósitos diferentes y pueden afectar el diseño general de forma independiente. Para más información sobre formato de párrafo y herencia, consulte Gestionar párrafo.
Aplicar y eliminar tachado
Utilice BasePortionFormat.strikethrough_type en una porción de texto para mostrar correcciones, términos cancelados o precios anteriores sin eliminar el texto original. Ajústelo a TextStrikethroughType.SINGLE o DOUBLE para una o dos líneas a través del texto.
Para eliminar el tachado, asigne TextStrikethroughType.NONE. Esto desactiva explícitamente el efecto, incluso si el formato circundante especifica tachado. Por el contrario, TextStrikethroughType.NOT_DEFINED deja la configuración local sin definir, permitiendo que la porción herede el formato, por ejemplo, del párrafo. No garantiza que el tachado se elimine. Utilice PortionFormat.get_effective para leer el formato resultante, incluidos los valores heredados.
El siguiente ejemplo autónomo crea tres comparaciones de precios. Cada párrafo tiene porciones separadas para la etiqueta, el precio anterior y el precio actual, de modo que solo el precio anterior se ve afectado. La primera fila aplica y luego elimina el tachado; las demás filas conservan el tachado simple y el doble. Cambiar esta propiedad preserva el texto y su otro formato, incluida la negrita del precio anterior.
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 620, 220)
shape.fill_format.fill_type = slides.FillType.NO_FILL
shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL
shape.text_frame.paragraphs.clear()
labels = ["None: ", "Single: ", "Double: "]
for label in labels:
paragraph = slides.Paragraph()
paragraph.paragraph_format.alignment = slides.TextAlignment.LEFT
paragraph.paragraph_format.space_after = 20
portion_format = paragraph.paragraph_format.default_portion_format
portion_format.font_height = 28
portion_format.latin_font = slides.FontData("Arial")
portion_format.fill_format.fill_type = slides.FillType.SOLID
portion_format.fill_format.solid_fill_color.color = draw.Color.black
paragraph.portions.add(slides.Portion(label))
previous_price = slides.Portion("$100")
previous_price.portion_format.font_bold = slides.NullableBool.TRUE
paragraph.portions.add(previous_price)
paragraph.portions.add(slides.Portion(" → $80"))
shape.text_frame.paragraphs.add(paragraph)
paragraphs = shape.text_frame.paragraphs
# Aplicar tachado, y luego eliminarlo explícitamente del primer precio anterior.
paragraphs[0].portions[1].portion_format.strikethrough_type = slides.TextStrikethroughType.SINGLE
paragraphs[0].portions[1].portion_format.strikethrough_type = slides.TextStrikethroughType.NONE
paragraphs[1].portions[1].portion_format.strikethrough_type = slides.TextStrikethroughType.SINGLE
paragraphs[2].portions[1].portion_format.strikethrough_type = slides.TextStrikethroughType.DOUBLE
presentation.save("strikethrough.pptx", slides.export.SaveFormat.PPTX)
El resultado, de arriba a abajo: sin tachado, tachado simple y tachado doble.

Establecer rotación del texto
Utilice TextFrameFormat.text_vertical_type para establecer una orientación de texto predefinida dentro de una forma.
El siguiente ejemplo de código establece la orientación del texto en la forma en TextVerticalType.VERTICAL270, que rota el texto 90 grados en sentido antihorario:
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
auto_shape.text_frame.text_frame_format.text_vertical_type = slides.TextVerticalType.VERTICAL270
presentation.save("text_rotation.pptx", slides.export.SaveFormat.PPTX)
El resultado:

Establecer rotación personalizada para marcos de texto
Utilice TextFrameFormat.rotation_angle para establecer un ángulo de rotación personalizado para un TextFrame.
El siguiente ejemplo de código rota el marco de texto 3 grados en el sentido de las agujas del reloj dentro de la forma:
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
auto_shape.text_frame.text_frame_format.rotation_angle = 3
presentation.save("custom_text_rotation.pptx", slides.export.SaveFormat.PPTX)
El resultado:

Establecer espaciado entre líneas de los párrafos
Aspose.Slides proporciona ParagraphFormat.space_after, ParagraphFormat.space_before, y ParagraphFormat.space_within para controlar el espaciado de párrafos. Estas propiedades se utilizan de la siguiente manera:
- Utilice un valor positivo para especificar el espaciado de línea como porcentaje de la altura de la línea.
- Utilice un valor negativo para especificar el espaciado de línea en puntos.
El siguiente ejemplo establece el espaciado dentro del primer párrafo al 200 % de la altura de la línea (interlineado doble):
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
paragraph.paragraph_format.space_within = 200
presentation.save("line_spacing.pptx", slides.export.SaveFormat.PPTX)
El resultado:

Controlar el ajuste de línea
Las reglas de ajuste de línea de los párrafos son útiles en bloques de texto estrechos y presentaciones que combinan texto latino y asiático oriental. Las siguientes propiedades pertenecen a ParagraphFormat, por lo que se aplican a todo un párrafo:
- latin_line_break controla las reglas de ajuste de línea latinas. En texto mixto, cambiarla también puede modificar dónde se ajusta el texto y la puntuación asiática oriental adyacente.
- east_asian_line_break controla las reglas de ajuste de línea asiáticas orientales, incluidas las restricciones de caracteres al comienzo y al final de una línea.
Estas reglas no sustituyen a TextFrameFormat.wrap_text, que habilita el ajuste automático dentro de un marco de texto. Influyen en el diseño cuando ocurre el ajuste; no insertan caracteres de salto de línea. Un salto de línea explícito fuerza una nueva línea dentro del párrafo independientemente del ancho disponible.
El siguiente ejemplo autónomo crea un bloque de texto estrecho que contiene texto chino y latino. Establece ambas propiedades de ajuste de línea explícitamente y guarda “line_breaking.pptx”. Para experimentar con cualquiera de las reglas, cambie el valor de esa propiedad manteniendo fijas las demás configuraciones. El ejemplo usa Arial 24 puntos y SimSun con un ancho de marco de 160 puntos y márgenes horizontales del marco de texto en cero. TextFrameFormat.autofit_type se establece en TextAutofitType.NONE para que el tamaño del texto y las dimensiones del marco permanezcan fijos.
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 160, 300)
shape.fill_format.fill_type = slides.FillType.NO_FILL
text_frame = shape.text_frame
text_frame.text_frame_format.wrap_text = slides.NullableBool.TRUE
text_frame.text_frame_format.autofit_type = slides.TextAutofitType.NONE
text_frame.text_frame_format.margin_left = 0
text_frame.text_frame_format.margin_right = 0
paragraph = text_frame.paragraphs[0]
paragraph.text = "中文排版测试,PowerPoint 中文演示。"
paragraph_format = paragraph.paragraph_format
paragraph_format.alignment = slides.TextAlignment.LEFT
paragraph_format.default_portion_format.font_height = 24
paragraph_format.default_portion_format.latin_font = slides.FontData("Arial")
paragraph_format.default_portion_format.east_asian_font = slides.FontData("SimSun")
paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
paragraph_format.latin_line_break = slides.NullableBool.FALSE
paragraph_format.east_asian_line_break = slides.NullableBool.TRUE
presentation.save("line_breaking.pptx", slides.export.SaveFormat.PPTX)
Controlar la puntuación colgante
ParagraphFormat.hanging_punctuation permite que la puntuación elegible se extienda más allá del borde derecho de la línea de texto en lugar de ocupar la línea siguiente. Se aplica a todo el párrafo y es diferente de una sangría colgante.
El siguiente ejemplo autónomo habilita la puntuación colgante en un marco de texto de 100 puntos de ancho y guarda “hanging_punctuation.pptx”. Con Arial 24 puntos y márgenes horizontales del marco de texto en cero, el punto final permanece después de “sentence” y se extiende más allá del borde derecho del texto. Establezca la propiedad en NullableBool.FALSE para comparar: con estos ajustes, el punto ocupa una línea separada. El ajuste de línea está habilitado y el ajuste automático desactivado para mantener el ancho disponible fijo.
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 100, 200)
shape.fill_format.fill_type = slides.FillType.NO_FILL
text_frame = shape.text_frame
text_frame.text_frame_format.wrap_text = slides.NullableBool.TRUE
text_frame.text_frame_format.autofit_type = slides.TextAutofitType.NONE
text_frame.text_frame_format.margin_left = 0
text_frame.text_frame_format.margin_right = 0
paragraph = text_frame.paragraphs[0]
paragraph.text = "Simple text, next sentence."
paragraph_format = paragraph.paragraph_format
paragraph_format.alignment = slides.TextAlignment.LEFT
paragraph_format.default_portion_format.font_height = 24
paragraph_format.default_portion_format.latin_font = slides.FontData("Arial")
paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
paragraph_format.hanging_punctuation = slides.NullableBool.TRUE
presentation.save("hanging_punctuation.pptx", slides.export.SaveFormat.PPTX)
No todas las marcas de puntuación pueden colgar. El resultado visible depende de las condiciones de fuente y diseño: cambiar la fuente, el ancho disponible, los márgenes o la configuración de ajuste automático puede eliminar la diferencia visible.
Establecer tipo de ajuste automático para marcos de texto
TextFrameFormat.autofit_type determina cómo se comporta el texto cuando supera los límites de su contenedor. Úselo para controlar si el texto se reduce, se desborda o si la forma se redimensiona automáticamente. El siguiente ejemplo configura la forma para redimensionarse y ajustarse al texto y guarda el resultado en “autofit_type.pptx”.
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
auto_shape.text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE
presentation.save("autofit_type.pptx", slides.export.SaveFormat.PPTX)
Para contar líneas después del ajuste automático y ver cómo el ancho del texto o de la forma cambia el resultado, consulte Contar líneas renderizadas. El número de líneas por sí solo no indica si el texto se desborda del contenedor.
Establecer ancla de los marcos de texto
TextFrameFormat.anchoring_type define cómo se posiciona verticalmente el texto dentro de una forma, por ejemplo, en la parte superior, intermedia o inferior. El siguiente ejemplo ancla el texto en la parte inferior de la primera forma y guarda el resultado en “text_anchor.pptx”.
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
auto_shape.text_frame.text_frame_format.anchoring_type = slides.TextAnchorType.BOTTOM
presentation.save("text_anchor.pptx", slides.export.SaveFormat.PPTX)
Establecer tabulación del texto
Utilice ParagraphFormat.default_tab_size y ParagraphFormat.tabs para configurar los tabuladores en un párrafo. El siguiente ejemplo establece el intervalo de tabulación predeterminado en 100 puntos y añade un tabulador alineado a la izquierda en 30 puntos. Estas configuraciones afectan al texto que contiene caracteres de tabulación.
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
paragraph.paragraph_format.default_tab_size = 100
paragraph.paragraph_format.tabs.add(30, slides.TabAlignment.LEFT)
presentation.save("paragraph_tabs.pptx", slides.export.SaveFormat.PPTX)
El resultado:

Establecer idioma de revisión
Aspose.Slides proporciona BasePortionFormat.language_id, que permite establecer el idioma de revisión para una porción de texto. El idioma de revisión determina el idioma utilizado para la comprobación ortográfica y gramatical en PowerPoint.
El siguiente ejemplo requiere “presentation.pptx” con un cuadro de texto como primera forma en la primera diapositiva y al menos un párrafo. Sustituye el contenido del primer párrafo por “1。”, establece SimSun como su fuente y asigna el idioma de revisión chino simplificado (zh-CN). Guarda el resultado en “proofing_language.pptx”:
import aspose.slides as slides
with slides.Presentation("presentation.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
paragraph = auto_shape.text_frame.paragraphs[0]
paragraph.portions.clear()
font = slides.FontData("SimSun")
text_portion = slides.Portion()
text_portion.portion_format.complex_script_font = font
text_portion.portion_format.east_asian_font = font
text_portion.portion_format.latin_font = font
# Establecer el idioma de revisión a chino simplificado.
text_portion.portion_format.language_id = "zh-CN"
text_portion.text = "1。"
paragraph.portions.add(text_portion)
presentation.save("proofing_language.pptx", slides.export.SaveFormat.PPTX)
Copiar metadatos de idioma
Al copiar texto multilingüe desde una plantilla, preserve tanto BasePortionFormat.language_id como BasePortionFormat.alternative_language_id. El siguiente ejemplo autónomo crea una porción de origen con inglés de EE. UU como idioma y francés como idioma alternativo y copia el texto y los identificadores a una porción en una nueva presentación.
import aspose.slides as slides
source = slides.Portion("Hello! Bonjour!")
source.portion_format.language_id = "en-US"
source.portion_format.alternative_language_id = "fr-FR"
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 400, 80)
paragraph = shape.text_frame.paragraphs[0]
paragraph.portions.clear()
destination = slides.Portion()
destination.text = source.text
destination.portion_format.language_id = source.portion_format.language_id
# Si la fuente no tiene idioma alternativo, None borra el valor del destino.
destination.portion_format.alternative_language_id = source.portion_format.alternative_language_id
paragraph.portions.add(destination)
presentation.save("copied_language_metadata.pptx", slides.export.SaveFormat.PPTX)
Para probar un origen sin idioma alternativo, omita la asignación de "fr-FR". El identificador alternativo será entonces None, y la misma instrucción de copia preserva su ausencia sin introducir un valor predeterminado, incluso si el destino tenía previamente un idioma alternativo asignado.
Estos identificadores almacenan metadatos de idioma. Preservarlos no determina qué diccionario selecciona PowerPoint para la revisión ortográfica o gramatical.
Establecer idioma predeterminado
Utilice LoadOptions.default_text_language para definir el idioma predeterminado del texto creado al cargar o crear una presentación. El siguiente ejemplo crea una presentación con inglés de EE. UU como idioma de texto predeterminado, añade un cuadro de texto y muestra en‑US para su primera porción de texto.
import aspose.slides as slides
load_options = slides.LoadOptions()
load_options.default_text_language = "en-US"
with slides.Presentation(load_options) as presentation:
slide = presentation.slides[0]
# Añadir una nueva forma rectangular con texto.
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 150, 50)
shape.text_frame.text = "Sample text"
# Comprobar el idioma de la primera porción.
portion = shape.text_frame.paragraphs[0].portions[0]
print(portion.portion_format.language_id)
Establecer estilo de texto predeterminado
Para aplicar formato de texto predeterminado a nivel de presentación, utilice Presentation.default_text_style.
El siguiente ejemplo establece una fuente en negrita de 14 puntos como predeterminada para los párrafos de nivel superior en una nueva presentación y la guarda en “default_text_style.pptx”. El texto puede heredar estos valores predeterminados a menos que un formato más específico los sobrescriba.
import aspose.slides as slides
with slides.Presentation() as presentation:
# Obtener el formato de párrafo de nivel superior.
paragraph_format = presentation.default_text_style.get_level(0)
if paragraph_format is not None:
paragraph_format.default_portion_format.font_height = 14
paragraph_format.default_portion_format.font_bold = slides.NullableBool.TRUE
presentation.save("default_text_style.pptx", slides.export.SaveFormat.PPTX)
Extraer texto con el efecto de mayúsculas
En PowerPoint, aplicar el efecto de fuente All Caps hace que el texto aparezca en mayúsculas en la diapositiva aunque se haya escrito originalmente en minúsculas. Cuando recupera una porción de texto con Aspose.Slides, la biblioteca devuelve el texto tal como se introdujo. Para que coincida con el texto mostrado, compruebe TextCapType y convierta la cadena devuelta a mayúsculas cuando el valor sea ALL.
Este ejemplo requiere “sample2.pptx” con un cuadro de texto como primera forma en la primera diapositiva. Su primer párrafo contiene una primera porción con “Hello, Aspose!” y el efecto All Caps aplicado, como se muestra a continuación.

El código de ejemplo a continuación muestra cómo extraer el texto con el efecto All Caps aplicado:
import aspose.slides as slides
with slides.Presentation("sample2.pptx") as presentation:
slide = presentation.slides[0]
auto_shape = slide.shapes[0]
text_portion = auto_shape.text_frame.paragraphs[0].portions[0]
print("Original text:", text_portion.text)
text_format = text_portion.portion_format.get_effective()
if text_format.text_cap_type == slides.TextCapType.ALL:
text = text_portion.text.upper()
print("All-Caps effect:", text)
Salida:
Original text: Hello, Aspose!
All-Caps effect: HELLO, ASPOSE!
FAQ
¿Cómo modificar el texto en una tabla de una diapositiva?
Para modificar el texto en una tabla de una diapositiva, utilice Table. Recorrer las celdas y actualice cada celda mediante Cell.text_frame y el formato de párrafo mediante Paragraph.paragraph_format.
¿Cómo aplicar un color degradado al texto en una diapositiva de PowerPoint?
Para aplicar un color degradado al texto, utilice BasePortionFormat.fill_format. Establezca FillFormat.fill_type en FillType.GRADIENT y configure las paradas de degradado, la dirección y la transparencia.
Funcionalidad relacionada: Formato de texto dentro de diapositivas.