Aspose.Slides FOSS
C++
Cum să formatați textul în C++

Cum să formatați textul în C++

Aspose.Slides FOSS pentru C++ oferă formatare de text cu granulație fină prin clasa PortionFormat. Un Portion este cea mai mică unitate independentă de text; se mapă la o singură rulă de formatare într-un paragraf. Acest ghid arată cum să aplicați formatarea îngroșată, cursivă, dimensiunea fontului și culoarea textului într-o prezentare.

Ghid pas cu pas

Pasul 1: Construiește și leagă biblioteca 

git clone https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
cd Aspose.Slides-FOSS-for-Cpp && mkdir build && cd build
cmake .. && cmake --build .

Pasul 2: Adăugați o formă cu un cadru de text

Înainte de a formata textul, adăugați o formă și setați conținutul său text prin shape.text_frame()->set_text().

#include <Aspose/Slides/Foss/presentation.h>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs;
    auto& slide = prs.slides()[0];
    auto& shape = slide.shapes().add_auto_shape(
        asf::ShapeType::RECTANGLE, 50, 50, 500, 150);
    shape.text_frame()->set_text("Default text: will be formatted");
    prs.save("output.pptx", asf::SaveFormat::PPTX);
    return 0;
}

Pasul 3: Accesați TextFrame

shape.text_frame() returnează un pointer către TextFrame al formei. Utilizaţi -> pentru a apela metode pe acesta.

auto* tf = shape.text_frame();          // pointer to the shape's text frame
tf->set_text("your text here");

Un TextFrame conține Paragraph obiecte (tf->paragraphs()). Fiecare Paragraph conține Portion obiecte (paragraph.portions()).

Pasul 4: Aplică formatarea îngroșată și cursivă

Utilizați portion_format().set_font_bold() și portion_format().set_font_italic(). Aceste metode acceptă NullableBool::TRUE, NullableBool::FALSE sau NullableBool::NOT_DEFINED (moștenite de la master).

#include <Aspose/Slides/Foss/presentation.h>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs;
    auto& slide = prs.slides()[0];
    auto& shape = slide.shapes().add_auto_shape(
        asf::ShapeType::RECTANGLE, 50, 50, 500, 150);
    shape.text_frame()->set_text("Bold and italic text");
    auto* tf = shape.text_frame();

    auto& fmt = tf->paragraphs()[0].portions()[0].portion_format();
    fmt.set_font_bold(asf::NullableBool::TRUE);
    fmt.set_font_italic(asf::NullableBool::TRUE);

    prs.save("bold-italic.pptx", asf::SaveFormat::PPTX);
    return 0;
}

Pasul 5: Setează dimensiunea și culoarea fontului

Setează portion_format().set_font_height() pentru dimensiune (în puncte) și folosește fill_format() pentru culoare.

#include <Aspose/Slides/Foss/presentation.h>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs;
    auto& slide = prs.slides()[0];
    auto& shape = slide.shapes().add_auto_shape(
        asf::ShapeType::RECTANGLE, 50, 50, 500, 150);
    shape.text_frame()->set_text("Large corporate-blue heading");
    auto* tf = shape.text_frame();

    auto& fmt = tf->paragraphs()[0].portions()[0].portion_format();
    fmt.set_font_height(32);                               // 32pt font
    fmt.set_font_bold(asf::NullableBool::TRUE);
    fmt.fill_format().set_fill_type(asf::FillType::SOLID);
    fmt.fill_format().solid_fill_color().set_color(
        asf::Color::from_argb(255, 0, 70, 127));

    prs.save("colored-text.pptx", asf::SaveFormat::PPTX);
    return 0;
}

Color::from_argb(alpha, red, green, blue) acceptă valori 0‑255 pentru fiecare canal.

Pasul 6: Mai multe porțiuni într-un paragraf

Un singur paragraf poate conține mai multe porțiuni cu formatare diferită. Adăugați un nou Portion la colecția portions() a unui paragraf:

#include <Aspose/Slides/Foss/presentation.h>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs;
    auto& slide = prs.slides()[0];
    auto& shape = slide.shapes().add_auto_shape(
        asf::ShapeType::RECTANGLE, 50, 50, 600, 100);
    shape.text_frame()->set_text(""); // start with empty text
    auto* tf = shape.text_frame();

    auto& paragraph = tf->paragraphs()[0];

    // First portion: normal text
    auto& portion1 = paragraph.portions()[0];
    portion1.set_text("Normal text followed by ");
    portion1.portion_format().set_font_height(20);

    // Second portion: bold red text
    asf::Portion portion2;
    portion2.set_text("bold red text");
    portion2.portion_format().set_font_height(20);
    portion2.portion_format().set_font_bold(asf::NullableBool::TRUE);
    portion2.portion_format().fill_format().set_fill_type(asf::FillType::SOLID);
    portion2.portion_format().fill_format().solid_fill_color().set_color(
        asf::Color::from_argb(255, 200, 0, 0));
    paragraph.portions().add(portion2);

    prs.save("mixed-format.pptx", asf::SaveFormat::PPTX);
    return 0;
}

Probleme comune și soluții

Textul apare negru chiar și după setarea culorii

Asigurați-vă că fill_format().set_fill_type(FillType::SOLID) este setat înainte de a atribui culoarea. Fără setarea tipului de umplere, schimbarea culorii poate să nu aibă efect.

NullableBool::TRUE vs true

portion_format().set_font_bold() așteaptă NullableBool::TRUE, nu C++ true. Transmiterea directă a true nu va compila sau va avea un comportament nedefinit în funcție de rezoluția suprasarcinii.

Fontul nu apare în fișierul salvat

Metoda set_latin_font() setează familia de fonturi Latin. Dacă nu este setată, se folosește fontul temei de prezentare. Fonturile personalizate trebuie să fie încorporate sau disponibile pe mașina de vizualizare.

Întrebări frecvente

Cum pot schimba familia de fonturi?

Set portion_format().set_latin_font():

fmt.set_latin_font(asf::FontData("Arial"));

FontData acceptă numele familiei de fonturi ca un șir.

Cum să setez alinierea paragrafelor?

Folosiți paragraph_format().set_alignment():

tf.paragraphs()[0].paragraph_format().set_alignment(asf::TextAlignment::CENTER);

Valori acceptate: LEFT, CENTER, RIGHT, JUSTIFY.

Cum să setez spațierea dintre linii?

Utilizați paragraph_format().set_space_before() (puncte înainte de paragraf) sau paragraph_format().set_space_after() (puncte după paragraf):

tf.paragraphs()[0].paragraph_format().set_space_before(12); // 12pt before
tf.paragraphs()[0].paragraph_format().set_space_after(6);   // 6pt after

Vezi și

 Română