Main Content

mlreportgen.ppt.Paragraph クラス

名前空間: mlreportgen.ppt

書式設定されたテキスト ブロック (段落)

このページをすべて展開する

説明

mlreportgen.ppt.Paragraph クラスのオブジェクトを使用して、PPT API プレゼンテーションに段落を含めます。段落には、テキストを含めるか、mlreportgen.ppt.Text オブジェクト、mlreportgen.ppt.InternalLink オブジェクト、または mlreportgen.ppt.ExternalLink オブジェクトを含めることができます。

mlreportgen.ppt.Paragraph クラスは handle クラスです。

クラス属性

HandleCompatible
true
ConstructOnLoad
true

クラス属性の詳細については、クラスの属性を参照してください。

作成

説明

paragraphObj = mlreportgen.ppt.Paragraph は、空の段落オブジェクトを作成します。

例

paragraphObj = mlreportgen.ppt.Paragraph(text) は、text で指定されたテキストをもつ mlreportgen.ppt.Text オブジェクトを含む段落を作成します。

paragraphObj = mlreportgen.ppt.Paragraph(pptElementObj) は、pptElementObj で指定されたテキスト、内部リンク、または外部リンクを含む段落を作成します。

入力引数

すべて展開する

段落のテキスト。文字ベクトルまたは string スカラーとして指定します。

段落に含めるプレゼンテーション要素。mlreportgen.ppt.Text オブジェクト、mlreportgen.ppt.InternalLink オブジェクト、または mlreportgen.ppt.ExternalLink オブジェクトとして指定します。

プロパティ

すべて展開する

この段落のテキストに太字を使用するかどうか。true または false として指定します。false に設定すると、標準的な太さのテキストが使用されます。true に設定すると、テキストが太字でレンダリングされます。

この段落のテキストのフォント ファミリ。文字ベクトルまたは string スカラーとして指定します。Microsoft® PowerPoint® のフォント リストに表示されるフォントを指定します。フォントの一覧を表示するには、PowerPoint の [ホーム] タブの [フォント] グループで、フォントの右にある矢印をクリックします。

コンプレックス スクリプト用のフォント ファミリ。文字ベクトルまたは string スカラーとして指定します。アラビア語やアジア言語など、テキストをレンダリングするためにコンプレックス スクリプトを必要とするロケールで代わりに使用するフォント ファミリを指定します。

この段落のテキストのフォント カラー。CSS の色名または 16 進数の RGB 値で構成される文字ベクトルまたは string スカラーとして指定します。

  • CSS の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywords を参照してください。

  • 16 進数の RGB 書式を指定するには、最初の文字として # を使用し、赤、緑、および青の値に 2 桁の 16 進数を使用します。たとえば、'#0000ff' は青を指定します。

ドキュメント要素に使用するフォント サイズ (数値とそれに続く測定単位の略語で構成される)。文字ベクトルまたは string スカラーとして指定します。たとえば、"12pt" は 12 ポイントを指定します。有効な略語を以下に示します。

  • "px" — ピクセル

  • "cm" — センチメートル

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

メモ

FontSize プロパティを設定すると、対応する mlreportgen.dom.FontSize 書式オブジェクトが Style プロパティに追加されます。FontSize プロパティを空の値に設定すると、そのオブジェクトは削除されます。

例: "12pt"

属性:

NonCopyable
true

データ型: char | string

この段落のテキストにイタリックを使用するかどうか。true または false として指定します。true に設定すると、テキストがイタリックでレンダリングされます。

この段落のテキストの取り消し線スタイル。次の値のいずれかとして指定します。

  • 'single' — 一重水平線

  • 'none' — 取り消し線なし

  • 'double' — 二重水平線

この段落のテキストを下付き文字として表示するかどうか。true または false として指定します。true に設定すると、テキストが下付き文字としてレンダリングされます。

この段落のテキストを上付き文字として表示するかどうか。true または false として指定します。true に設定すると、テキストが上付き文字としてレンダリングされます。

この段落のテキストの下線スタイル。次の値のいずれかとして指定します。

値説明
"single"一重線の下線
"double"二重線の下線
"heavy"太線の下線
"words"単語にのみ下線を引く (空白は除外)
"dotted"点線の下線
"dottedheavy"太点線の下線
"dash"破線の下線
"dashheavy"太破線の下線
"dashlong"長破線の下線
"dashlongheavy"長太破線の下線
"dotdash"一点鎖線の下線
"dotdashheavy"太一点鎖線の下線
"dotdotdash"二点鎖線の下線
"dotdotdashheavy"太二点鎖線の下線
"wavy"波線の下線
"wavyheavy"太波線の下線
"wavydouble"二重波線の下線
"none"下線なし

この段落のテキストの水平方向の配置。次の値のいずれかとして指定します。

  • 'center' — 中央揃え

  • 'left' — 左揃え

  • 'right' — 右揃え

  • 'justified' — 左揃えおよび右揃え (単語の間隔を均等にする)

  • 'distributed' — 左揃えおよび右揃え (文字の間隔を均等にする)

  • 'thaiDistributed' — 左揃えおよび右揃えされたタイ語テキスト (文字の間隔を均等にする)

  • 'justifiedLow' — アラビア語テキストの行端揃え

この段落のインデント レベル。[1,9] の範囲内の整数として指定します。値 1 は、インデントのない最上位の段落を示します。

段落の書式設定。PPT 書式オブジェクトの cell 配列として指定します。

Style プロパティの既存の値と追加する書式オブジェクトを含む cell 配列を連結して、書式オブジェクトを追加します。例:

para = mlreportgen.ppt.Paragraph('my paragraph');
para.Style = [para.Style {Bold(true),FontColor('red')}];

プレゼンテーションの書式設定方法を参照してください。

この PPT API オブジェクトの子要素。PPT API オブジェクトの cell 配列として指定します。

属性:

NonCopyable
true

このオブジェクトの親。PPT オブジェクトとして指定します。

属性:

SetAccess
private
NonCopyable
true

この PPT API オブジェクトのタグ。文字ベクトルまたは string スカラーとして指定します。セッション固有タグは、このオブジェクト作成の一環として生成されます。生成されたタグの形式は CLASS:ID という形式です。ここで、CLASS はオブジェクト クラスです。ID はオブジェクトの Id プロパティの値です。

独自のタグ値を指定すると、プレゼンテーションの生成中に問題が発生した箇所を容易に特定できるようになります。

属性:

NonCopyable
true

データ型: char | string

この PPT API オブジェクトの ID。文字ベクトルまたは string スカラーとして指定します。セッション固有 ID は、オブジェクト作成の一環として生成されます。ID を指定して、生成された ID を置き換えることができます。

属性:

NonCopyable
true

データ型: char | string

メソッド

すべて展開する

例

すべて折りたたむ

2 つのスライドをもつプレゼンテーションを作成します。

import mlreportgen.ppt.*;

ppt = Presentation('myParagraphPresentation.pptx');
open(ppt);

add(ppt,'Title Slide');
add(ppt,'Title and Content');

タイトルに使用する mlreportgen.ppt.Paragraph オブジェクトを作成します。テキストを赤い太字にします。

p = Paragraph('My Title');
p.Bold = true;
p.FontColor = 'red';

最初のスライドのタイトルを段落に置き換えます。

contents = find(ppt,'Title');
replace(contents(1),p);

2 番目のスライドのコンテンツの段落を作成します。

p1 = Paragraph('My slide content');
append(p1,' for the second slide');

コンテンツを p1 段落に置き換えます。

replace(ppt,'Content',p1);

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

close(ppt);
rptview(ppt);

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

Slide has a red and bold title. Slide has one bullet "My slide content for the second slide

バージョン履歴

R2015b で導入

参考

| | | |

トピック