メインコンテンツ

add

R2026b

テキスト ボックス プレースホルダーへのコンテンツの追加

説明

addedParagraphObj = add(textBoxPlaceholder,paragraph) は、指定されたテキスト ボックスのプレースホルダーにテキストを段落として追加し、段落オブジェクトを返します。

例

例

すべて展開する

スライド タイトルに段落を追加するには、タイトルを表す TextBoxPlaceholder オブジェクトの add メソッドを使用します。この例では、Title and Table スライドを含むプレゼンテーションを作成し、その後、最初のプレゼンテーションから、2 番目のプレゼンテーションを作成します。この例の 2 番目のプレゼンテーションでは、Title and Table スライドのタイトルにコンテンツを追加します。

PPT API クラスに長い完全修飾名を使用せずに済むよう、PPT 名前空間をインポートします。

import mlreportgen.ppt.*

プレゼンテーションを作成し、Title and Table スライドをプレゼンテーションに追加します。

ppt = Presentation("myPPT1.pptx");
open(ppt);
slide = add(ppt,"Title and Table");

タイトルのテキスト ボックス プレースホルダーを見つけて、コンテンツを置き換えます。

contents = find(slide,"Title");
replace(contents(1),"Hello World");

閉じて、プレゼンテーションを生成します。

close(ppt);

生成されたプレゼンテーションのタイトル スライドは次のようになります。

Slide with a single line of text reading “Hello World” positioned near the upper left, with the date and slide number in the lower corners.

最初のプレゼンテーションをテンプレートとして使用し、2 番目のプレゼンテーションを作成します。

ppt = Presentation("myPPT2.pptx","myPPT1.pptx");
open(ppt);

タイトルのテキスト ボックス プレースホルダーを見つけて、タイトルにコンテンツを追加します。

contents = find(ppt,"Title");
add(contents(1)," -- How are You?");

プレゼンテーションを閉じて表示します。

close(ppt);
rptview(ppt)

2 番目のプレゼンテーションでは、テンプレートのプレゼンテーションのコンテンツと追加されたコンテンツがタイトルに含まれています。

Slide showing two lines of text near the upper left: “Hello World” and a second indented line reading “-- How are You?”, with the date and slide number in the lower corners.

入力引数

すべて展開する

テキスト ボックス プレースホルダー。mlreportgen.ppt.TextBoxPlaceholder オブジェクトとして指定します。

テキスト ボックス プレースホルダーに追加する段落。文字ベクトル、string スカラー、または mlreportgen.ppt.Paragraph オブジェクトとして指定します。

出力引数

すべて展開する

追加された段落。mlreportgen.ppt.Paragraph オブジェクトとして返されます。

バージョン履歴

R2015b で導入