Automatyzacja lokalizacji prezentacji w Javie

O czym jest ta strona

Ustaw języki korekty dla tekstu prezentacji PowerPoint i OpenDocument w Javie przy użyciu Aspose.Slides, w tym wartości domyślne i wielojęzyczne akapity.

Przegląd

Aspose.Slides for Java umożliwia konfigurowanie metadanych korekty dla pojedynczych fragmentów tekstu. Użyj IBasePortionFormat.setLanguageId aby określić język korekty, IBasePortionFormat.setSpellCheck aby zezwolić lub wyłączyć sprawdzanie pisowni oraz IBasePortionFormat.setProofDisabled aby kontrolować szerszy stan „bez korekty”. Ponieważ te ustawienia są stosowane na poziomie fragmentu, jeden akapit może zawierać wiele języków i różnych reguł korekty.

Ten artykuł wyjaśnia, jak przypisać język do określonego tekstu, ustawić domyślny język dla nowego tekstu za pomocą LoadOptions.setDefaultTextLanguage, tworzyć wielojęzyczne akapity, wybierać pomiędzy SpellCheck a ProofDisabled oraz zachować zamierzone ustawienia przy użyciu Presentation.joinPortionsWithSameFormatting. Właściwości te przechowują metadane dla aplikacji prezentacji; nie tłumaczą tekstu, nie wykonują sprawdzania pisowni opartego na słowniku ani nie zwracają niepoprawnych słów.

Ustaw język korekty dla tekstu

Utwórz lub wczytaj Presentation, uzyskaj dostęp do wymaganego fragmentu tekstu poprzez IPortion.getPortionFormat, i przypisz jego identyfikator języka. Poniższy przykład tworzy kształt, ustawia brytyjski angielski jako język korekty i zapisuje wynik przy pomocy Presentation.save:

import com.aspose.slides.IAutoShape;
import com.aspose.slides.IPortion;
import com.aspose.slides.ISlide;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import com.aspose.slides.ShapeType;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 320, 80);
    shape.getTextFrame().setText("Set the proofing language for this text.");

    IPortion portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
    portion.getPortionFormat().setLanguageId("en-GB");

    presentation.save("proofing_language.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Ustaw domyślny język dla nowego tekstu

Użyj LoadOptions.setDefaultTextLanguage aby określić język korekty, który Aspose.Slides przypisuje do nowo tworzonego tekstu. To ustawienie jest przydatne, gdy większość lub cały nowy tekst w prezentacji używa tego samego języka. Nie zmienia ono metadanych językowych tekstu, który już posiada explicite określony język.

Poniższy przykład tworzy prezentację, w której nowy tekst używa niemieckich reguł korekty:

import com.aspose.slides.IAutoShape;
import com.aspose.slides.ISlide;
import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import com.aspose.slides.ShapeType;

LoadOptions loadOptions = new LoadOptions();
loadOptions.setDefaultTextLanguage("de-DE");

Presentation presentation = new Presentation(loadOptions);
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 320, 80);
    shape.getTextFrame().setText("Willkommen zur Präsentation");

    presentation.save("default_text_language.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Użyj wielu języków w jednym akapicie

IParagraph zawiera kolekcję fragmentów tekstu. Utwórz oddzielny Portion dla każdego języka i ustaw jego LanguageId niezależnie.

Ten przykład tworzy jeden akapit z fragmentami po angielsku i francusku:

import com.aspose.slides.IAutoShape;
import com.aspose.slides.IParagraph;
import com.aspose.slides.ISlide;
import com.aspose.slides.Portion;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import com.aspose.slides.ShapeType;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 420, 80);
    IParagraph paragraph = shape.getTextFrame().getParagraphs().get_Item(0);
    paragraph.getPortions().clear();

    Portion englishPortion = new Portion("Welcome");
    englishPortion.getPortionFormat().setLanguageId("en-US");
    paragraph.getPortions().add(englishPortion);

    Portion frenchPortion = new Portion(" — Bienvenue");
    frenchPortion.getPortionFormat().setLanguageId("fr-FR");
    paragraph.getPortions().add(frenchPortion);

    presentation.save("multilingual_text.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Włącz lub wyłącz sprawdzanie pisowni dla poszczególnych fragmentów

IPortionFormat dziedziczy wspólne właściwości tekstu zdefiniowane przez IBasePortionFormat. Uzyskaj dostęp do formatu fragmentu poprzez IPortion.getPortionFormat i użyj IBasePortionFormat.setSpellCheck aby kontrolować, czy aplikacja prezentacji może sprawdzać pisownię tego fragmentu. Wartość domyślna to false: true zezwala na sprawdzanie pisowni, natomiast false je wyłącza.

Ustawienie dotyczy pojedynczych fragmentów tekstu. Różne fragmenty w tym samym akapicie mogą więc mieć różne wartości. IBasePortionFormat.setLanguageId i setSpellCheck pełnią uzupełniające się role: setLanguageId określa język korekty, a setSpellCheck decyduje, czy sprawdzanie pisowni jest dozwolone dla fragmentu.

IBasePortionFormat.setProofDisabled również kontroluje korektę, ale reprezentuje szerszy stan „bez korekty” jako NullableBool. Używaj setSpellCheck, gdy potrzebny jest bezpośredni przełącznik Boolean specyficzny dla sprawdzania pisowni. Używaj setProofDisabled, gdy trzeba zachować lub explicite kontrolować metadane „brak korekty” prezentacji, w tym jej stan NotDefined. Jeśli ustawisz obie właściwości, zachowaj ich spójność; nie łącz setSpellCheck(true) z setProofDisabled(NullableBool.True).

Właściwości te konfigurowają metadane korekty używane przez PowerPoint i inne aplikacje prezentacyjne. Aspose.Slides nie wykorzystuje ich do przeprowadzania opartego na słowniku sprawdzania pisowni ani do zwracania listy niepoprawnych słów.

Poniższy kompletny przykład tworzy prezentację wejściową, wczytuje ją, przypisuje różne ustawienia sprawdzania pisowni i języki korekty dwóm fragmentom w tym samym akapicie, zapisuje wynik, ponownie otwiera go i weryfikuje zapisane wartości:

import com.aspose.slides.IAutoShape;
import com.aspose.slides.IParagraph;
import com.aspose.slides.IPortion;
import com.aspose.slides.IPortionCollection;
import com.aspose.slides.ISlide;
import com.aspose.slides.Portion;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import com.aspose.slides.ShapeType;

String inputFile = "spell_check_input.pptx";
String outputFile = "spell_check_settings.pptx";

Presentation sourcePresentation = new Presentation();
try {
    ISlide sourceSlide = sourcePresentation.getSlides().get_Item(0);
    IAutoShape sourceShape = sourceSlide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 420, 80);
    IParagraph sourceParagraph = sourceShape.getTextFrame().getParagraphs().get_Item(0);
    sourceParagraph.getPortions().clear();

    Portion sourceEnglishPortion = new Portion("Check this text. ");
    sourceEnglishPortion.getPortionFormat().setLanguageId("en-US");
    sourceParagraph.getPortions().add(sourceEnglishPortion);

    Portion sourceFrenchPortion = new Portion("Ignorer ce code : ZX-81.");
    sourceFrenchPortion.getPortionFormat().setLanguageId("fr-FR");
    sourceParagraph.getPortions().add(sourceFrenchPortion);

    sourcePresentation.save(inputFile, SaveFormat.Pptx);
} finally {
    sourcePresentation.dispose();
}

Presentation presentation = new Presentation(inputFile);
try {
    IAutoShape shape = (IAutoShape) presentation.getSlides().get_Item(0).getShapes().get_Item(0);
    IPortionCollection portions = shape.getTextFrame().getParagraphs().get_Item(0).getPortions();

    IPortion checkedPortion = portions.get_Item(0);
    checkedPortion.getPortionFormat().setLanguageId("en-US");
    checkedPortion.getPortionFormat().setSpellCheck(true);

    IPortion suppressedPortion = portions.get_Item(1);
    suppressedPortion.getPortionFormat().setLanguageId("fr-FR");
    suppressedPortion.getPortionFormat().setSpellCheck(false);

    presentation.save(outputFile, SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Presentation reopenedPresentation = new Presentation(outputFile);
try {
    IAutoShape reopenedShape = (IAutoShape) reopenedPresentation.getSlides().get_Item(0).getShapes().get_Item(0);
    IPortionCollection storedPortions = reopenedShape.getTextFrame().getParagraphs().get_Item(0).getPortions();

    boolean firstPortionStored = storedPortions.getCount() == 2 && 
            "en-US".equals(storedPortions.get_Item(0).getPortionFormat().getLanguageId()) && 
            storedPortions.get_Item(0).getPortionFormat().getSpellCheck();

    boolean secondPortionStored = storedPortions.getCount() == 2 && 
            "fr-FR".equals(storedPortions.get_Item(1).getPortionFormat().getLanguageId()) && 
            !storedPortions.get_Item(1).getPortionFormat().getSpellCheck();

    if (firstPortionStored && secondPortionStored) {
        System.out.println("The proofing settings were stored correctly.");
    } else {
        System.out.println("The proofing settings could not be verified.");
    }
} finally {
    reopenedPresentation.dispose();
}

Presentation.joinPortionsWithSameFormatting łączy sąsiadujące fragmenty, które mają takie samo formatowanie. Różnica w samym SpellCheck nie wystarczy, aby fragmenty pozostały odrębne; po ich połączeniu wynikowy fragment zachowuje wartość SpellCheck pierwszego fragmentu. Jeśli fragmenty wymagają różnych ustawień sprawdzania pisowni, wywołaj joinPortionsWithSameFormatting przed przypisaniem tych ustawień lub sprawdź granice wynikowego fragmentu i ponownie zastosuj ustawienia. Fragmenty z różnymi wartościami LanguageId pozostają odrębne, ponieważ ich formatowanie języka korekty się różni.

FAQ

Czy identyfikator języka tłumaczy tekst?

Nie. IBasePortionFormat.setLanguageId przechowuje metadane korekty dla pisowni i gramatyki; nie zmienia treści tekstu. Przetłumacz tekst osobno, a następnie ustaw odpowiedni identyfikator języka dla każdego przetłumaczonego fragmentu.

Czy język korekty kontroluje czcionki, dzielenie wyrazów lub zawijanie wierszy?

Nie. Identyfikator języka służy wyłącznie do korekty. Renderowanie i układ tekstu zależą głównie od dostępnych czcionek, systemu pisma oraz ustawień ramki tekstowej. Aby zapewnić prawidłowe renderowanie, udostępnij wymagane czcionki, skonfiguruj zastępowanie czcionek lub osadź czcionki w prezentacji.

Czy jeden akapit może używać kilku języków korekty?

Tak. Przypisz każdy język do oddzielnego fragmentu, jak pokazano w przykładzie wielojęzycznego akapitu.

Czy powinienem używać setDefaultTextLanguage czy setLanguageId?

Użyj LoadOptions.setDefaultTextLanguage, gdy chcesz ustawić domyślny język dla nowo tworzonego tekstu. Użyj IBasePortionFormat.setLanguageId, gdy konkretny fragment wymaga explicite określonego języka korekty lub gdy akapit zawiera wiele języków.

Zaawansowane wyodrębnianie tekstu z prezentacji w Javie Tworzenie i stosowanie efektów WordArt w Javie