テキストフォーマット

ハイライトテキスト

新しいHighlightTextメソッドがITextFrameおよびTextFrameクラスに追加されました。このメソッドは、PowerPoint 2019のテキストハイライトツールに似て、テキストサンプルを使用して背景色でテキストの一部をハイライトすることを可能にします。

以下のコードスニペットは、この機能を使用する方法を示しています：

System::SharedPtr<Presentation> presentation = System::MakeObject<Presentation>(u"SomePresentation.pptx");
// highlighting all words 'important'
(System::DynamicCast<Aspose::Slides::AutoShape> (presentation->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0)))->get_TextFrame()->HighlightText(u"important", System::Drawing::Color::get_LightBlue());
auto options = System::MakeObject<TextHighlightingOptions>();
options->set_WholeWordsOnly(true);
// highlighting all separate 'the' occurrences
(System::DynamicCast <Aspose::Slides::AutoShape>(presentation->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0)))->get_TextFrame()->HighlightText(u"the", System::Drawing::Color::get_Violet(), options);
presentation->Save(u"../out/SomePresentation-out.pptx", Aspose::Slides::Export::SaveFormat::Pptx);
view raw Examples-SlidesCPP-HighlightText-HighlightText.cpp hosted with ❤ by GitHub

正規表現を使用したハイライトテキスト

新しいHighlightRegexメソッドがITextFrameおよびTextFrameクラスに追加されました。このメソッドは、PowerPoint 2019のテキストハイライトツールに似て、正規表現を使用して背景色でテキストの一部をハイライトすることを可能にします。

以下のコードスニペットは、この機能を使用する方法を示しています：

System::SharedPtr<Presentation> presentation = System::MakeObject<Presentation>(u"SomePresentation.pptx");
System::SharedPtr <TextHighlightingOptions> options = System::MakeObject<TextHighlightingOptions>();
// highlighting all words with 10 symbols or longer
(System::DynamicCast <Aspose::Slides::AutoShape>(presentation->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0)))->get_TextFrame()->HighlightRegex(u"\\b[^\\s]{10,}\\b", System::Drawing::Color::get_LightGoldenrodYellow(), options);
presentation->Save(u"../out/SomePresentation-out.pptx", Aspose::Slides::Export::SaveFormat::Pptx);
view raw Examples-SlidesCPP-HighlightTextUsingRegx-HighlightTextUsingRegx.cpp hosted with ❤ by GitHub

テキストの背景色を設定する

Aspose.Slidesは、テキストの背景に対して好みの色を指定することを可能にします。

このC++コードは、全体のテキストに対して背景色を設定する方法を示しています：

{
    auto pres = System::MakeObject<Presentation>();
    System::SharedPtr<IAutoShape> autoShape = pres->get_Slide(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 50.0f, 50.0f, 200.0f, 100.0f);
    auto paragraphs = autoShape->get_TextFrame()->get_Paragraphs();
    paragraphs->Clear();
    System::SharedPtr<Paragraph> para = System::MakeObject<Paragraph>();
    auto portion1 = System::MakeObject<Portion>(u"ブラック");
    portion1->get_PortionFormat()->set_FontBold(NullableBool::True);

    auto portion2 = System::MakeObject<Portion>(u" 赤 ");

    auto portion3 = System::MakeObject<Portion>(u"ブラック");
    portion3->get_PortionFormat()->set_FontBold(NullableBool::True);

    auto paragraphPortions = para->get_Portions();
    paragraphPortions->Add(portion1);
    paragraphPortions->Add(portion2);
    paragraphPortions->Add(portion3);
    paragraphs->Add(para);

    pres->Save(u"text.pptx", SaveFormat::Pptx);
}

{
    auto pres = System::MakeObject<Presentation>(u"text.pptx");
    auto autoShape = System::ExplicitCast<IAutoShape>(pres->get_Slide(0)->get_Shape(0));
    auto portions = autoShape->get_TextFrame()->get_Paragraph(0)->get_Portions();
    for (auto&& portion : portions)
    {
        portion->get_PortionFormat()->get_HighlightColor()->set_Color(System::Drawing::Color::get_Blue());
    }
    pres->Save(u"text-red.pptx", SaveFormat::Pptx);
}

このC++コードは、テキストの一部にのみ背景色を設定する方法を示しています：

{
    auto pres = System::MakeObject<Presentation>();
    System::SharedPtr<IAutoShape> autoShape = pres->get_Slide(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 50.0f, 50.0f, 200.0f, 100.0f);

    auto paragraphs = autoShape->get_TextFrame()->get_Paragraphs();
    paragraphs->Clear();
    System::SharedPtr<Paragraph> para = System::MakeObject<Paragraph>();
    auto portion1 = System::MakeObject<Portion>(u"ブラック");
    portion1->get_PortionFormat()->set_FontBold(NullableBool::True);

    auto portion2 = System::MakeObject<Portion>(u" 赤 ");

    auto portion3 = System::MakeObject<Portion>(u"ブラック");
    portion3->get_PortionFormat()->set_FontBold(NullableBool::True);

    auto paragraphPortions = para->get_Portions();
    paragraphPortions->Add(portion1);
    paragraphPortions->Add(portion2);
    paragraphPortions->Add(portion3);
    paragraphs->Add(para);

    pres->Save(u"text.pptx", SaveFormat::Pptx);
}

{
    auto pres = System::MakeObject<Presentation>(u"text.pptx");
    auto autoShape = System::ExplicitCast<IAutoShape>(pres->get_Slide(0)->get_Shape(0));

	auto predicate = [](System::SharedPtr<IPortion> portion) -> bool {
        return portion->get_Text().Contains(u"赤");
	};

	auto portions = autoShape->get_TextFrame()->get_Paragraph(0)->get_Portions();
    System::SharedPtr<IPortion> redPortion;
	for (auto&& portion : portions)
        if (predicate(portion))
            redPortion = portion;

    redPortion->get_PortionFormat()->get_HighlightColor()->set_Color(System::Drawing::Color::get_Red());

    pres->Save(u"text-red.pptx", SaveFormat::Pptx);
}

テキスト段落の配置

テキストフォーマットは、あらゆる種類の文書やプレゼンテーションを作成する際の重要な要素の1つです。Aspose.Slides for C++はスライドにテキストを追加することをサポートしていますが、このトピックでは、スライド内のテキスト段落の配置を制御する方法を見ていきます。Aspose.Slides for C++を使用してテキスト段落を配置するには、以下の手順に従ってください。

  1. Presentationクラスのインスタンスを作成します。
  2. インデックスを使用してスライドの参照を取得します。
  3. スライド内のプレースホルダーシェイプにアクセスし、AutoShapeとして型キャストします。
  4. AutoShapeによって公開されたTextFrameから配置が必要な段落を取得します。
  5. 段落を配置します。段落は、右、左、中央、両端揃えに配置できます。
  6. 修正されたプレゼンテーションをPPTXファイルとして書き込みます。

上記の手順の実装は以下に示されています。

// The path to the documents directory.
const String outPath = u"../out/ParagraphsAlignment_out.pptx";
const String templatePath = u"../templates/DefaultFonts.pptx";
// Load the desired the presentation
SharedPtr<Presentation> pres = MakeObject<Presentation>(templatePath);
// Access first slide
SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);
// Accessing the first and second placeholder in the slide and typecasting it as AutoShape
SharedPtr<IShape> shape1 = slide->get_Shapes()->idx_get(0);
SharedPtr<IShape> shape2 = slide->get_Shapes()->idx_get(1);
SharedPtr<AutoShape> ashp1 = DynamicCast<Aspose::Slides::AutoShape>(shape1);
SharedPtr<AutoShape> ashp2 = DynamicCast<Aspose::Slides::AutoShape>(shape2);
SharedPtr<ITextFrame> tf1 = ashp1->get_TextFrame();
SharedPtr<ITextFrame> tf2 = ashp2->get_TextFrame();
// Change the text in both placeholders
tf1->set_Text (u"Center Align by Aspose");
tf2->set_Text(u"Center Align by Aspose");
// Accessing the first Paragraph
SharedPtr<IParagraph> para1 = tf1->get_Paragraphs()->idx_get(0);
SharedPtr<IParagraph> para2 = tf2->get_Paragraphs()->idx_get(0);
// Aligning the text paragraph to center
para1->get_ParagraphFormat()->set_Alignment (TextAlignment::Center);
para2->get_ParagraphFormat()->set_Alignment(TextAlignment::Center);
// Save PPTX to Disk
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);
view raw Examples-SlidesCPP-ParagraphsAlignment-ParagraphsAlignment.cpp hosted with ❤ by GitHub

テキストの透明度を設定する

この記事では、Aspose.Slidesを使用して任意のテキストシェイプに透明度プロパティを設定する方法を示します。テキストに透明度を設定するには、以下の手順に従ってください：

  1. Presentationクラスのインスタンスを作成します。
  2. スライドの参照を取得します。
  3. シャドウカラーを設定します。
  4. プレゼンテーションをPPTXファイルとして書き込みます。

上記の手順の実装は以下に示されています。

const String templatePath = u"../templates/transparency.pptx";
const String outPath = u"../out/transparency-out.pptx";
SharedPtr<Presentation> pres = MakeObject<Presentation>(templatePath);
SharedPtr<IAutoShape> shape = DynamicCast<IAutoShape>(pres->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0)) ;
SharedPtr<IEffectFormat> effects = shape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->get_PortionFormat()->get_EffectFormat();
SharedPtr<Aspose::Slides::Effects::IOuterShadow> outerShadowEffect = effects->get_OuterShadowEffect();
System::Drawing::Color shadowColor = outerShadowEffect->get_ShadowColor()->get_Color();
// set transparency to zero percent
outerShadowEffect->get_ShadowColor()->set_Color(System::Drawing::Color(shadowColor.FromArgb(255, shadowColor)));
// Save PPTX to Disk
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);
view raw Examples-SlidesCPP-SetTransparencyOfTextInShadow-SetTransparencyOfTextInShadow.cpp hosted with ❤ by GitHub

テキストの文字間隔を設定する

Aspose.Slidesでは、テキストボックス内の文字間の間隔を設定することができます。このようにして、文字間のスペースを広げたり凝縮したりすることで、行またはテキストブロックの視覚密度を調整することができます。

このC++コードは、1行のテキストの間隔を広げ、別の行の間隔を凝縮する方法を示しています：

auto presentation = System::MakeObject<Presentation>(u"in.pptx");

auto slide = presentation->get_Slides()->idx_get(0);
auto textBox1 = System::ExplicitCast<IAutoShape>(slide->get_Shapes()->idx_get(0));
auto textBox2 = System::ExplicitCast<IAutoShape>(slide->get_Shapes()->idx_get(1));

textBox1->get_TextFrame()->get_Paragraph(0)->get_ParagraphFormat()->get_DefaultPortionFormat()->set_Spacing(20.0f); // 拡大
textBox2->get_TextFrame()->get_Paragraph(0)->get_ParagraphFormat()->get_DefaultPortionFormat()->set_Spacing(-2.0f); // 凝縮

presentation->Save(u"out.pptx", SaveFormat::Pptx);

段落のフォントプロパティを管理する

プレゼンテーションには通常、テキストと画像の両方が含まれます。テキストは、特定のセクションや単語を強調するため、または企業スタイルに準拠するために、さまざまな方法でフォーマットできます。テキストフォーマットは、プレゼンテーションコンテンツの見た目と雰囲気を変えるのに役立ちます。この記事では、Aspose.Slides for C++を使用して、スライド上のテキスト段落のフォントプロパティを設定する方法を示します。Aspose.Slides for C++を使用して段落のフォントプロパティを管理するには：

  1. Presentationクラスのインスタンスを作成します。
  2. インデックスを使用してスライドの参照を取得します。
  3. スライド内のプレースホルダーシェイプにアクセスし、AutoShapeに型キャストします。
  4. AutoShapeによって公開されたTextFrameから段落を取得します。
  5. 段落を両端揃えします。
  6. 段落のテキストポーションにアクセスします。
  7. FontDataを使用してフォントを定義し、テキストポーションのフォントをそれに応じて設定します。
    1. フォントを太字に設定します。
    2. フォントをイタリックに設定します。
  8. ポーションオブジェクトによって公開されたFillFormatを使用してフォントカラーを設定します。
  9. 修正されたプレゼンテーションをPPTXファイルとして書き込みます。

上記の手順の実装は以下に示されています。これにより、素朴なプレゼンテーションが取得され、そのうちの1つのスライドのフォントがフォーマットされます。

// The path to the documents directory.
const String outPath = u"../out/FontProperties_out.pptx";
const String templatePath = u"../templates/DefaultFonts.pptx";
// Load the desired the presentation
SharedPtr<Presentation> pres = MakeObject<Presentation>(templatePath);
// Access first slide
SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);
// Accessing the first and second placeholder in the slide and typecasting it as AutoShape
SharedPtr<IShape> shape1 = slide->get_Shapes()->idx_get(0);
SharedPtr<IShape> shape2 = slide->get_Shapes()->idx_get(1);
SharedPtr<AutoShape> ashp1 = DynamicCast<Aspose::Slides::AutoShape>(shape1);
SharedPtr<AutoShape> ashp2 = DynamicCast<Aspose::Slides::AutoShape>(shape2);
SharedPtr<ITextFrame> tf1 = ashp1->get_TextFrame();
SharedPtr<ITextFrame> tf2 = ashp2->get_TextFrame();
// Accessing the first Paragraph
SharedPtr<IParagraph> para1 = tf1->get_Paragraphs()->idx_get(0);
SharedPtr<IParagraph> para2 = tf2->get_Paragraphs()->idx_get(0);
// Accessing the first portion
SharedPtr<IPortion> port1 = para1->get_Portions()->idx_get(0);
SharedPtr<IPortion> port2 = para2->get_Portions()->idx_get(0);
// Define new fonts
SharedPtr<FontData> fd1 = MakeObject<FontData>(u"Elephant");
SharedPtr<FontData> fd2 = MakeObject<FontData>(u"Castellar");
// Assign new fonts to portion
port1->get_PortionFormat()->set_LatinFont ( fd1);
port2->get_PortionFormat()->set_LatinFont(fd2);
// Set font to Bold
port1->get_PortionFormat()->set_FontBold ( NullableBool::True);
port2->get_PortionFormat()->set_FontBold ( NullableBool::True);
// Set font to Italic
port1->get_PortionFormat()->set_FontItalic( NullableBool::True);
port2->get_PortionFormat()->set_FontItalic ( NullableBool::True);
// Set font color
port1->get_PortionFormat()->get_FillFormat()->set_FillType ( FillType::Solid);
port1->get_PortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color ( Color::get_Purple());
port2->get_PortionFormat()->get_FillFormat()->set_FillType(FillType::Solid);
port2->get_PortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Peru());
// Save PPTX to Disk
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);
view raw Examples-SlidesCPP-FontProperties-FontProperties.cpp hosted with ❤ by GitHub

テキストのフォントファミリーを管理する

ポーションは、段落内の同じフォーマットスタイルを持つテキストを保持するために使用されます。この記事では、Aspose.Slides for C++を使用していくつかのテキストを持つテキストボックスを作成し、特定のフォントやフォントファミリーカテゴリーのさまざまな他のプロパティを定義する方法を示します。テキストボックスを作成し、その中のテキストのフォントプロパティを設定するには：

  1. Presentationクラスのインスタンスを作成します。
  2. インデックスを使用してスライドの参照を取得します。
  3. スライドに長方形タイプのAutoShapeを追加します。
  4. AutoShapeに関連付けられた塗りつぶしスタイルを削除します。
  5. AutoShapeのTextFrameにアクセスします。
  6. TextFrameにテキストを追加します。
  7. TextFrameに関連付けられたポーションオブジェクトにアクセスします。
  8. ポーションに使用するフォントを定義します。
  9. ポーションオブジェクトによって公開された関連プロパティを使用して太字、イタリック、下線、色、高さなどの他のフォントプロパティを設定します。
  10. 修正されたプレゼンテーションをPPTXファイルとして書き込みます。

上記の手順の実装は以下に示されています。

// The path to the documents directory.
const String outPath = u"../out/SetTextFontProperties_out.pptx";
const String templatePath = u"../templates/DefaultFonts_out.pptx";
// Load the desired the presentation
SharedPtr<Presentation> pres = MakeObject<Presentation>();
// Access first slide
SharedPtr<ISlide> sld = pres->get_Slides()->idx_get(0);
// Add an AutoShape of Rectangle type
SharedPtr<IAutoShape> ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150, 75, 150, 50);
// Add TextFrame to the Rectangle
ashp->AddTextFrame(u"Aspose TextBox");
ashp->get_FillFormat()->set_FillType(FillType::NoFill);
// Accessing the text frame
SharedPtr<ITextFrame> txtFrame = ashp->get_TextFrame();
txtFrame->get_TextFrameFormat()->set_AutofitType(TextAutofitType::Shape);
SharedPtr<FontData> destFont = MakeObject<FontData>(u"Times New Roman");
// Create the Paragraph object for text frame
SharedPtr<IParagraph> paragraph = txtFrame->get_Paragraphs()->idx_get(0);
// Create Portion object for paragraph
SharedPtr<IPortion>portion = paragraph->get_Portions()->idx_get(0);
portion->get_PortionFormat()->set_LatinFont(destFont);
// Set font to Bold
portion->get_PortionFormat()->set_FontBold(NullableBool::True);
// Set font to Italic
portion->get_PortionFormat()->set_FontItalic(NullableBool::True);
// Set text to underline
portion->get_PortionFormat()->set_FontUnderline ( TextUnderlineType::Single);
// Set the Height of the Font
portion->get_PortionFormat()->set_FontHeight ( 25);
// Set font color
portion->get_PortionFormat()->get_FillFormat()->set_FillType(FillType::Solid);
portion->get_PortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Blue());
// Save PPTX to Disk
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);
view raw Examples-SlidesCPP-SetTextFontProperties-SetTextFontProperties.cpp hosted with ❤ by GitHub

テキストのフォントサイズを設定する

Aspose.Slidesは、段落内の既存のテキストに対して好みのフォントサイズを選択し、後で段落に追加される可能性のある他のテキストに対しても選択することを可能にします。

このC++コードは、段落内のテキストのフォントサイズを設定する方法を示しています：

auto presentation = System::MakeObject<Presentation>(u"example.pptx");

// 最初のシェイプを取得します。
auto shape = presentation->get_Slide(0)->get_Shape(0);
if (System::ObjectExt::Is<IAutoShape>(shape))
{
    auto autoShape = System::ExplicitCast<IAutoShape>(shape);

    // 最初の段落を取得します。
    auto paragraph = autoShape->get_TextFrame()->get_Paragraph(0);
    // 段落内のすべてのテキストポーションのデフォルトフォントサイズを20ptに設定します。
    paragraph->get_ParagraphFormat()->get_DefaultPortionFormat()->set_FontHeight(20.0f);
    // 段落内の現在のテキストポーションのフォントサイズを20ptに設定します。
    for (auto&& portion : paragraph->get_Portions())
    {
        portion->get_PortionFormat()->set_FontHeight(20.0f);
    }
}

presentation->Save(u"output.pptx", SaveFormat::Pptx);

テキストの回転を設定する

Aspose.Slides for C++は、開発者がテキストを回転させることを可能にします。テキストは、水平、垂直、270度垂直、WordArt垂直、東アジア垂直、モンゴル垂直、またはWordArt右から左に表示を指定できます。任意のTextFrameのテキストを回転させるには、以下の手順に従ってください。

  1. Presentationクラスのインスタンスを作成します。
  2. 最初のスライドにアクセスします。
  3. スライドに任意のシェイプを追加します。
  4. TextFrameにアクセスします。
  5. テキストを回転させます。
  6. ファイルをディスクに保存します。
For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C
// The path to the documents directory.
const String outPath = u"../out/RotatingText.pptx";
const String templatePath = u"../templates/DefaultFonts.pptx";
const String ImagePath = u"../templates/Tulips.jpg";
// Load the desired the presentation
SharedPtr<Presentation> pres = MakeObject<Presentation>();
// Access first slide
SharedPtr<ISlide> sld = pres->get_Slides()->idx_get(0);
// Add an AutoShape of Rectangle type
SharedPtr<IAutoShape> ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150, 75, 150, 50);
// Add TextFrame to the Rectangle
ashp->AddTextFrame(u"");
ashp->get_FillFormat()->set_FillType(FillType::NoFill);
// Accessing the text frame
SharedPtr<ITextFrame> txtFrame = ashp->get_TextFrame();
txtFrame->get_TextFrameFormat()->set_TextVerticalType(TextVerticalType::Vertical270);
// Create the Paragraph object for text frame
SharedPtr<IParagraph> paragraph = txtFrame->get_Paragraphs()->idx_get(0);
// Create Portion object for paragraph
SharedPtr<IPortion>portion = paragraph->get_Portions()->idx_get(0);
portion->set_Text (u"A quick brown fox jumps over the lazy dog. A quick brown fox jumps over the lazy dog.");
portion->get_PortionFormat()->get_FillFormat()->set_FillType(FillType::Solid);
portion->get_PortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black());
// Save PPTX to Disk
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);
view raw Examples-SlidesCPP-RotatingText-RotatingText.cpp hosted with ❤ by GitHub

プレゼンテーションのタブとEffectiveTabs

  • EffectiveTabs.ExplicitTabCount (私たちのケースでは2)プロパティはTabs.Countに等しいです。
  • EffectiveTabsコレクションには、すべてのタブ（Tabsコレクションとデフォルトタブ）が含まれます。
  • EffectiveTabs.ExplicitTabCount (私たちのケースでは2)プロパティはTabs.Countに等しいです。
  • EffectiveTabs.DefaultTabSize (294)プロパティは、デフォルトタブ間の距離（例では3と4）を示します。
  • EffectiveTabs.GetTabByIndex(index)は、index = 0で最初の明示的なタブ(Position = 731)を返し、index = 1で2番目のタブ(Position = 1241)を返します。index = 2で次のタブを取得しようとすると、最初のデフォルトタブ(Position = 1470)が返されます。
  • EffectiveTabs.GetTabAfterPosition(pos)は、テキストの後に次のタブを取得するために使用されます。たとえば、テキストが"Helloworld!“の場合。このようなテキストをレンダリングするには、“world!“を描画する開始位置を知っておく必要があります。最初に、“Hello"のピクセル単位の長さを計算し、この値でGetTabAfterPositionを呼び出します。次のタブ位置を取得して"world!“を描画します。

段落の行間

Aspose.Slidesは、段落の行間を管理できるParagraphFormatのプロパティを提供します：SpaceAfter、SpaceBefore、およびSpaceWithin。これらの3つのプロパティは、次のように使用されます：

  • 段落の行間をパーセントで指定するには、正の値を使用します。
  • 段落の行間をポイントで指定するには、負の値を使用します。

たとえば、SpaceBeforeプロパティを-16に設定することで、段落に16ポイントの行間を適用できます。

特定の段落の行間を指定する方法は次のとおりです：

  1. いくつかのテキストを含むAutoShapeを含むプレゼンテーションをロードします。
  2. インデックスを介してスライドの参照を取得します。
  3. TextFrameにアクセスします。
  4. 段落にアクセスします。
  5. 段落のプロパティを設定します。
  6. プレゼンテーションを保存します。

このC++コードは、段落の行間を指定する方法を示しています：

// ドキュメントディレクトリへのパス
System::String dataDir = GetDataPath();

// Presentationクラスのインスタンスを作成
auto presentation = System::MakeObject<Presentation>(dataDir + u"Fonts.pptx");

// インデックスを介してスライドの参照を取得
auto sld = presentation->get_Slides()->idx_get(0);

// TextFrameにアクセス
auto tf1 = (System::ExplicitCast<IAutoShape>(sld->get_Shapes()->idx_get(0)))->get_TextFrame();

// 段落にアクセス
auto para = tf1->get_Paragraphs()->idx_get(0);

// 段落のプロパティを設定
para->get_ParagraphFormat()->set_SpaceWithin(80.0f);
para->get_ParagraphFormat()->set_SpaceBefore(40.0f);
para->get_ParagraphFormat()->set_SpaceAfter(40.0f);

// プレゼンテーションを保存
presentation->Save(dataDir + u"LineSpacing_out.pptx", SaveFormat::Pptx);

テキストフレームのオートフィットタイププロパティを設定する

このトピックでは、テキストフレームのさまざまなフォーマットプロパティを探ります。この記事では、テキストフレームのオートフィットタイププロパティ、テキストのアンカー、プレゼンテーション内のテキストの回転を設定する方法について説明します。Aspose.Slides for C++では、任意のテキストフレームのオートフィットタイププロパティを設定することができます。オートフィットタイプは、ノーマルまたはシェイプに設定できます。ノーマルに設定されている場合、シェイプはそのままで、テキストはシェイプが変更されることなく調整されます。しかし、オートフィットタイプがシェイプに設定されている場合、シェイプは必要なテキストのみが含まれるように変更されます。テキストフレームのオートフィットタイププロパティを設定するには、以下の手順に従ってください。

  1. Presentationクラスのインスタンスを作成します。
  2. 最初のスライドにアクセスします。
  3. スライドに任意のシェイプを追加します。
  4. TextFrameにアクセスします。
  5. TextFrameのオートフィットタイプを設定します。
  6. ファイルをディスクに保存します。
For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C
// The path to the documents directory.
const String outPath = u"../out/SetAutofitOftextframe_out.pptx";
const String templatePath = u"../templates/DefaultFonts.pptx";
const String ImagePath = u"../templates/Tulips.jpg";
// Load the desired the presentation
SharedPtr<Presentation> pres = MakeObject<Presentation>();
// Access first slide
SharedPtr<ISlide> sld = pres->get_Slides()->idx_get(0);
// Add an AutoShape of Rectangle type
SharedPtr<IAutoShape> ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150, 75, 150, 50);
// Add TextFrame to the Rectangle
ashp->AddTextFrame(u"");
ashp->get_FillFormat()->set_FillType(FillType::NoFill);
// Accessing the text frame
SharedPtr<ITextFrame> txtFrame = ashp->get_TextFrame();
txtFrame->get_TextFrameFormat()->set_AutofitType(TextAutofitType::Shape);
// Create the Paragraph object for text frame
SharedPtr<IParagraph> paragraph = txtFrame->get_Paragraphs()->idx_get(0);
// Create Portion object for paragraph
SharedPtr<IPortion>portion = paragraph->get_Portions()->idx_get(0);
portion->set_Text(u"A quick brown fox jumps over the lazy dog. A quick brown fox jumps over the lazy dog.");
portion->get_PortionFormat()->get_FillFormat()->set_FillType(FillType::Solid);
portion->get_PortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black());
// Save PPTX to Disk
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);
view raw Examples-SlidesCPP-SetAutofitOftextframe-SetAutofitOftextframe.cpp hosted with ❤ by GitHub

テキストフレームのアンカーを設定する

Aspose.Slides for C++では、任意のTextFrameのアンカーを設定することができます。TextAnchorTypeは、シェイプ内でそのテキストがどこに配置されるかを指定します。TextAnchorTypeは、トップ、センター、ボトム、両端揃えまたは分配に設定できます。任意のTextFrameのアンカーを設定するには、以下の手順に従ってください：

  1. Presentationクラスのインスタンスを作成します。
  2. 最初のスライドにアクセスします。
  3. スライドに任意のシェイプを追加します。
  4. TextFrameにアクセスします。
  5. TextFrameのTextAnchorTypeを設定します。
  6. ファイルをディスクに保存します。
For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C
// The path to the documents directory.
const String outPath = u"../out/SetAnchorOfTextFrame_out.pptx";
const String templatePath = u"../templates/DefaultFonts.pptx";
const String ImagePath = u"../templates/Tulips.jpg";
// Load the desired the presentation
SharedPtr<Presentation> pres = MakeObject<Presentation>();
// Access first slide
SharedPtr<ISlide> sld = pres->get_Slides()->idx_get(0);
// Add an AutoShape of Rectangle type
SharedPtr<IAutoShape> ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150, 75, 150, 50);
// Add TextFrame to the Rectangle
ashp->AddTextFrame(u"");
ashp->get_FillFormat()->set_FillType(FillType::NoFill);
// Accessing the text frame
SharedPtr<ITextFrame> txtFrame = ashp->get_TextFrame();
txtFrame->get_TextFrameFormat()->set_AnchoringType ( TextAnchorType::Bottom);
// txtFrame->get_TextFrameFormat()->set_TextVerticalType(TextVerticalType::Vertical270);
// Create the Paragraph object for text frame
SharedPtr<IParagraph> paragraph = txtFrame->get_Paragraphs()->idx_get(0);
// Create Portion object for paragraph
SharedPtr<IPortion>portion = paragraph->get_Portions()->idx_get(0);
portion->set_Text(u"A quick brown fox jumps over the lazy dog. A quick brown fox jumps over the lazy dog.");
portion->get_PortionFormat()->get_FillFormat()->set_FillType(FillType::Solid);
portion->get_PortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black());
// Save PPTX to Disk
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);
view raw Examples-SlidesCPP-SetAnchorOfTextFrame-SetAnchorOfTextFrame.cpp hosted with ❤ by GitHub

テキストフレームのカスタム回転角度を設定する

Aspose.Slides for C++は、テキストフレームのカスタム回転角度の設定をサポートします。このトピックでは、Aspose.SlidesでRotationAngleプロパティを設定する方法を説明します。新しいプロパティRotationAngleは、IChartTextBlockFormatおよびITextFrameFormatインターフェイスに追加され、テキストフレームのカスタム回転角度を設定できるようになりました。RotationAngleプロパティを設定するには、以下の手順に従ってください：

  1. Presentationクラスのインスタンスを作成します。
  2. スライドにチャートを追加します。
  3. RotationAngleプロパティを設定します。
  4. プレゼンテーションをPPTXファイルとして書き込みます。

以下の例では、RotationAngleプロパティを設定します。

For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C
// The path to the documents directory.
const String outPath = u"../out/CustomRotationAngleTextframe_out.pptx";
// Load the desired the presentation
SharedPtr<Presentation> pres = MakeObject<Presentation>();
// Access first slide
SharedPtr<ISlide> sld = pres->get_Slides()->idx_get(0);
// Add an AutoShape of Rectangle type
SharedPtr<IChart> chart = sld->get_Shapes()->AddChart(ChartType::ClusteredColumn, 50, 50, 500, 300);
SharedPtr<IChartSeries> series = chart->get_ChartData()->get_Series()->idx_get(0);
series->get_Labels()->get_DefaultDataLabelFormat()->set_ShowValue(true);
series->get_Labels()->get_DefaultDataLabelFormat()->get_TextFormat()->get_TextBlockFormat()->set_RotationAngle(65);
chart->set_HasTitle (true);
chart->get_ChartTitle()->AddTextFrameForOverriding(u"Custom title")->get_TextFrameFormat()->set_RotationAngle ( -30);
// Save PPTX to Disk
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);
view raw Examples-SlidesCPP-CustomRotationAngleTextframe-CustomRotationAngleTextframe.cpp hosted with ❤ by GitHub

校正言語を設定する

Aspose.Slidesは、PowerPoint文書に対して校正言語を設定できるようにするLanguageIdプロパティを提供しています。校正言語は、PowerPointでスペルや文法がチェックされる言語です。

このC++コードは、PowerPointの校正言語を設定する方法を示します：

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(pptxFileName);
System::SharedPtr<AutoShape> autoShape = System::ExplicitCast<AutoShape>(pres->get_Slide(0)->get_Shape(0));

System::SharedPtr<IParagraph> paragraph = autoShape->get_TextFrame()->get_Paragraph(0);
System::SharedPtr<IPortionCollection> portions = paragraph->get_Portions();
portions->Clear();

System::SharedPtr<Portion> newPortion = System::MakeObject<Portion>();

System::SharedPtr<IFontData> font = System::MakeObject<FontData>(u"SimSun");
System::SharedPtr<IPortionFormat> portionFormat = newPortion->get_PortionFormat();
portionFormat->set_ComplexScriptFont(font);
portionFormat->set_EastAsianFont(font);
portionFormat->set_LatinFont(font);

portionFormat->set_LanguageId(u"zh-CN");
// 校正言語のIDを設定します。

newPortion->set_Text(u"1。");
portions->Add(newPortion);

デフォルト言語を設定する

このC++コードは、PowerPointプレゼンテーション全体のデフォルト言語を設定する方法を示します：

System::SharedPtr<LoadOptions> loadOptions = System::MakeObject<LoadOptions>();
loadOptions->set_DefaultTextLanguage(u"en-US");

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(loadOptions);

// テキストを含む新しい長方形シェイプを追加
System::SharedPtr<IAutoShape> shp = pres->get_Slide(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 50.0f, 50.0f, 150.0f, 50.0f);
System::SharedPtr<ITextFrame> textFrame = shp->get_TextFrame();
textFrame->set_Text(u"新しいテキスト");

// 最初のポーションの言語をチェック
System::Console::WriteLine(textFrame->get_Paragraph(0)->get_Portion(0)->get_PortionFormat()->get_LanguageId());

デフォルトテキストスタイルを設定する

プレゼンテーションのすべてのテキスト要素に一度に同じデフォルトのテキストフォーマットを適用する必要がある場合は、IPresentationインターフェイスからget_DefaultTextStyleメソッドを使用して好みのフォーマットを設定できます。以下のコード例は、新しいプレゼンテーション内のすべてのスライドのテキストに対してデフォルトの太字フォント（14pt）を設定する方法を示しています。

auto presentation = MakeObject<Presentation>();

// 最上位の段落フォーマットを取得します。
auto paragraphFormat = presentation->get_DefaultTextStyle()->GetLevel(0);

if (paragraphFormat != NULL) {
    paragraphFormat->get_DefaultPortionFormat()->set_FontHeight(14);
    paragraphFormat->get_DefaultPortionFormat()->set_FontBold(NullableBool::True);
}

presentation->Save(u"DefaultTextStyle.pptx", SaveFormat::Pptx);
presentation->Dispose();
C++でPowerPointの段落を管理する アニメーションテキスト