Automatizar la localización de presentaciones en .NET

De qué trata esta página

Establezca los idiomas de corrección para el texto de presentaciones PowerPoint y OpenDocument en .NET con Aspose.Slides, incluidos los valores predeterminados y los párrafos multilingües.

Visión general

Aspose.Slides para .NET le permite configurar los metadatos de corrección para porciones de texto individuales. Utilice IBasePortionFormat.LanguageId para identificar el idioma de corrección, BasePortionFormat.SpellCheck para permitir o suprimir la comprobación ortográfica, y BasePortionFormat.ProofDisabled para controlar el estado más amplio de “no corregir”. Como estos ajustes se aplican a nivel de porción, un párrafo puede contener varios idiomas y diferentes reglas de corrección.

Este artículo explica cómo asignar un idioma a un texto específico, establecer el idioma predeterminado para texto nuevo con LoadOptions.DefaultTextLanguage, crear párrafos multilingües, elegir entre SpellCheck y ProofDisabled, y preservar la configuración deseada al usar Presentation.JoinPortionsWithSameFormatting. Estas propiedades almacenan metadatos para las aplicaciones de presentación; no traducen el texto, no realizan comprobación ortográfica basada en diccionarios, ni devuelven palabras mal escritas.

Establecer el idioma de corrección para el texto

Cree o cargue una Presentation, acceda a la porción de texto requerida a través de IPortion.PortionFormat, y asigne su identificador de idioma. El siguiente ejemplo crea una forma, establece el inglés británico como idioma de corrección y guarda el resultado con Presentation.Save:

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 320, 80);
shape.TextFrame.Text = "Set the proofing language for this text.";

var portion = shape.TextFrame.Paragraphs[0].Portions[0];
portion.PortionFormat.LanguageId = "en-GB";

presentation.Save("proofing_language.pptx", SaveFormat.Pptx);

Establecer el idioma predeterminado para texto nuevo

Utilice LoadOptions.DefaultTextLanguage para especificar el idioma de corrección que Aspose.Slides asigna al texto creado recientemente. Esta configuración es útil cuando la mayor parte o todo el texto nuevo en una presentación utiliza el mismo idioma. No modifica los metadatos de idioma del texto que ya tiene un idioma explícito.

El siguiente ejemplo crea una presentación cuyo texto nuevo utiliza las reglas de corrección alemanas:

using Aspose.Slides;
using Aspose.Slides.Export;

var loadOptions = new LoadOptions
{
    DefaultTextLanguage = "de-DE"
};

using var presentation = new Presentation(loadOptions);
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 320, 80);
shape.TextFrame.Text = "Willkommen zur Präsentation";

presentation.Save("default_text_language.pptx", SaveFormat.Pptx);

Utilizar varios idiomas en un mismo párrafo

Un IParagraph contiene una colección de porciones de texto. Cree una Portion separada para cada idioma y establezca su LanguageId de forma independiente.

Este ejemplo crea un párrafo con porciones en inglés y francés:

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 420, 80);
var paragraph = shape.TextFrame.Paragraphs[0];
paragraph.Portions.Clear();

var englishPortion = new Portion("Welcome");
englishPortion.PortionFormat.LanguageId = "en-US";
paragraph.Portions.Add(englishPortion);

var frenchPortion = new Portion(" — Bienvenue");
frenchPortion.PortionFormat.LanguageId = "fr-FR";
paragraph.Portions.Add(frenchPortion);

presentation.Save("multilingual_text.pptx", SaveFormat.Pptx);

Habilitar o suprimir la comprobación ortográfica para porciones individuales

IPortionFormat hereda las propiedades comunes de texto definidas por IBasePortionFormat. Acceda al formato de una porción a través de IPortion.PortionFormat y establezca BasePortionFormat.SpellCheck para controlar si una aplicación de presentación puede comprobar la ortografía de esa porción. El valor predeterminado es false: true permite la comprobación ortográfica, mientras que false la suprime.

Este ajuste se aplica a porciones de texto individuales. Por lo tanto, diferentes porciones en el mismo párrafo pueden usar valores distintos. BasePortionFormat.LanguageId y SpellCheck cumplen propósitos complementarios: LanguageId identifica el idioma de corrección, mientras que SpellCheck determina si se permiten las comprobaciones ortográficas para la porción.

BasePortionFormat.ProofDisabled también controla la corrección, pero representa el estado más amplio de “no corregir” como un NullableBool. Utilice SpellCheck cuando necesite un conmutador booleano directo específicamente para las comprobaciones ortográficas. Utilice ProofDisabled cuando necesite preservar o controlar explícitamente los metadatos de “no corregir” de la presentación, incluido su estado NotDefined. Si establece ambas propiedades, mantenga sus valores coherentes; no combine SpellCheck = true con ProofDisabled = NullableBool.True.

Estas propiedades configuran los metadatos de corrección utilizados por PowerPoint y otras aplicaciones de presentación. Aspose.Slides no los usa para ejecutar comprobaciones ortográficas basadas en diccionarios ni para devolver una lista de palabras mal escritas.

El siguiente ejemplo completo crea una presentación de entrada, la carga, asigna diferentes configuraciones de comprobación ortográfica e idiomas de corrección a dos porciones del mismo párrafo, guarda el resultado, lo vuelve a abrir y verifica los valores almacenados:

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

const string inputFile = "spell_check_input.pptx";
const string outputFile = "spell_check_settings.pptx";

using (var sourcePresentation = new Presentation())
{
    var sourceSlide = sourcePresentation.Slides[0];
    var sourceShape = sourceSlide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 420, 80);
    var sourceParagraph = sourceShape.TextFrame.Paragraphs[0];
    sourceParagraph.Portions.Clear();

    var sourceEnglishPortion = new Portion("Check this text. ");
    sourceEnglishPortion.PortionFormat.LanguageId = "en-US";
    sourceParagraph.Portions.Add(sourceEnglishPortion);

    var sourceFrenchPortion = new Portion("Ignorer ce code : ZX-81.");
    sourceFrenchPortion.PortionFormat.LanguageId = "fr-FR";
    sourceParagraph.Portions.Add(sourceFrenchPortion);

    sourcePresentation.Save(inputFile, SaveFormat.Pptx);
}

using (var presentation = new Presentation(inputFile))
{
    var shape = (IAutoShape)presentation.Slides[0].Shapes[0];
    var portions = shape.TextFrame.Paragraphs[0].Portions;

    var checkedPortion = portions[0];
    checkedPortion.PortionFormat.LanguageId = "en-US";
    checkedPortion.PortionFormat.SpellCheck = true;

    var suppressedPortion = portions[1];
    suppressedPortion.PortionFormat.LanguageId = "fr-FR";
    suppressedPortion.PortionFormat.SpellCheck = false;

    presentation.Save(outputFile, SaveFormat.Pptx);
}

using var reopenedPresentation = new Presentation(outputFile);
var reopenedShape = (IAutoShape)reopenedPresentation.Slides[0].Shapes[0];
var storedPortions = reopenedShape.TextFrame.Paragraphs[0].Portions;

var firstPortionStored = storedPortions.Count == 2 &&
    storedPortions[0].PortionFormat.LanguageId == "en-US" &&
    storedPortions[0].PortionFormat.SpellCheck;

var secondPortionStored = storedPortions.Count == 2 &&
    storedPortions[1].PortionFormat.LanguageId == "fr-FR" &&
    !storedPortions[1].PortionFormat.SpellCheck;

if (firstPortionStored && secondPortionStored)
{
    Console.WriteLine("The proofing settings were stored correctly.");
}
else
{
    Console.WriteLine("The proofing settings could not be verified.");
}

Presentation.JoinPortionsWithSameFormatting combina porciones adyacentes que tengan el mismo formato. Una diferencia únicamente en SpellCheck no mantiene esas porciones separadas; después de combinarlas, la porción resultante conserva el valor SpellCheck de la primera porción. Si las porciones necesitan configuraciones de comprobación ortográfica diferentes, llame a JoinPortionsWithSameFormatting antes de asignar esas configuraciones, o inspeccione los límites de las porciones resultantes y vuelva a aplicar las configuraciones posteriormente. Las porciones con valores diferentes de LanguageId permanecen separadas porque el formato del idioma de corrección difiere.

Preguntas frecuentes

¿El identificador de idioma traduce el texto?

No. IBasePortionFormat.LanguageId almacena metadatos de corrección para la ortografía y la gramática; no altera el contenido del texto. Traduce el texto por separado y, a continuación, establezca el identificador de idioma apropiado para cada porción traducida.

¿El idioma de corrección controla fuentes, guiones o ajuste de línea?

No. El identificador de idioma es para la corrección. La representación y el diseño del texto dependen principalmente de las fuentes, el sistema de escritura y la configuración del marco de texto. Para una representación fiable, proporcione las fuentes necesarias, configure la sustitución de fuentes o incorpore fuentes en la presentación.

¿Puede un párrafo usar varios idiomas de corrección?

Sí. Asigne cada idioma a una porción separada, como se muestra en el ejemplo del párrafo multilingüe.

¿Debo usar DefaultTextLanguage o LanguageId?

Utilice LoadOptions.DefaultTextLanguage cuando desee un valor predeterminado para el texto recién creado. Utilice IBasePortionFormat.LanguageId cuando una porción específica necesite un idioma de corrección explícito o cuando un párrafo contenga varios idiomas.

Extracción avanzada de texto de presentaciones en .NET Crear y aplicar efectos WordArt en .NET