mlreportgen.ppt.InternalLink クラス

名前空間: mlreportgen.ppt
スーパークラス: mlreportgen.ppt.Text

プレゼンテーション内のスライドへのハイパーリンク

説明

mlreportgen.ppt.InternalLink クラスのオブジェクトを使用して、プレゼンテーション内のあるスライドから別のスライドにリンクします。

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

クラス属性

ConstructOnLoad	true
HandleCompatible	true

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

作成

説明

internalLinkObj = mlreportgen.ppt.InternalLink は、空の InternalLink オブジェクトを作成します。

internalLinkObj = mlreportgen.ppt.InternalLink(targetSlideName,linkText) は、Targetプロパティが targetSlideName に設定され、Contentプロパティが linkText に設定された InternalLink オブジェクトを作成します。

internalLinkObj = mlreportgen.ppt.InternalLink(targetSlideIndex,linkText) は、Targetプロパティが targetSlideIndex に設定され、Contentプロパティが linkText に設定された InternalLink オブジェクトを作成します。

プロパティ

Target — ハイパーリンクのターゲット スライド

[] (既定値) | 整数 | 文字ベクトル | string スカラー

ハイパーリンクのターゲット スライド。整数、文字ベクトル、または string スカラーとして指定します。整数は、ターゲット スライドのインデックスを示すために使用します。文字ベクトルまたは string スカラーは、ターゲット スライドの名前を示すために使用します。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

Content — リンク テキスト

"" (既定値) | 文字ベクトル | string スカラー

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

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

Bold — リンク テキストに太字を使用するかどうか

[] (既定値) | 1 (true) | 0 (false)

リンク テキストに太字を使用するかどうか。logical の 1 (true) または 0 (false) として指定します。指定内容は以下のとおりです。

• 1 (true) — リンク テキストを太字でレンダリングする。

• 0 (false) — リンク テキストを標準的な太さでレンダリングする。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: logical

Font — リンク テキストのフォント ファミリ

[] (既定値) | 文字ベクトル | string スカラー

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

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

ComplexScriptFont — コンプレックス スクリプト用のフォント ファミリ

[] (既定値) | 文字ベクトル | string スカラー

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

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

FontColor — リンク テキストのフォント カラー

[] (既定値) | 文字ベクトル | string スカラー

リンク テキストのフォント カラー。CSS の色名または 16 進数の RGB 値を含む文字ベクトルまたは string スカラーとして指定します。

形式	値
CSS の色名	CSS の色名を指定します。CSS の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywords を参照してください。
16 進数の RGB 値	"#RRGGBB" の形式を使用します。最初の文字として # を使用し、赤、緑、および青の値に 2 桁の 16 進数を使用します。大文字と小文字のいずれも使用できます。

例: "red" は、CSS の色名を使用して赤色を指定します。

例: "#0000ff" は、16 進数の RGB 値を使用して青色を指定します。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

FontSize — リンク テキストのフォント サイズ

[] (既定値) | 文字ベクトル | string スカラー

リンク テキストのフォント サイズ。数値とそれに続く測定単位を含む文字ベクトルまたは string スカラーとして指定します。たとえば、"11pt" は 11 ポイントを指定します。有効な略語を以下に示します。

• "px" — ピクセル

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

• "in" — インチ

• "mm" — ミリメートル

• "pc" — パイカ

• "pt" — ポイント

単位を省略することで、ピクセルとして指定することもできます。たとえば、"5" は 5 ピクセルを指定します。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

Italic — リンク テキストにイタリックを使用するかどうか

[] (既定値) | 1 (true) | 0 (false)

リンク テキストにイタリックを使用するかどうか。logical の 1 (true) または 0 (false) として指定します。指定内容は以下のとおりです。

• 1 (true) — リンク テキストをイタリックでレンダリングする。

• 0 (false) — リンク テキストを直立体のテキストとしてレンダリングする。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: logical

Strike — リンク テキストの取り消し線スタイル

[] (既定値) | "single" | "none" | "double"

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

• "single" — 一重水平線

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

• "double" — 二重水平線

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

Subscript — リンク テキストを下付き文字として表示するかどうか

[] (既定値) | 1 (true) | 0 (false)

リンク テキストを下付き文字として表示するかどうか。logical の 1 (true) または 0 (false) として指定します。指定内容は以下のとおりです。

• 1 (true) — リンク テキストを上付き文字としてレンダリングする。

• 0 (false) — リンク テキストを通常のテキストとしてレンダリングする。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: logical

Superscript — リンク テキストを上付き文字として表示するかどうか

[] (既定値) | 1 (true) | 0 (false)

リンク テキストを上付き文字として表示するかどうか。logical の 1 (true) または 0 (false) として指定します。指定内容は以下のとおりです。

• 1 (true) — リンク テキストを上付き文字としてレンダリングする。

• 0 (false) — リンク テキストを通常のテキストとしてレンダリングする。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: logical

Underline — このプロパティは無視されます

[] (既定値)

このプロパティは無視されます。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

Style — リンク テキストの書式設定

[] (既定値) | PPT 書式オブジェクトの cell 配列

リンク テキストの書式設定。PPT 書式オブジェクトの cell 配列として指定します。

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

link = mlreportgen.ppt.InternalLink(3,"link text");
link.Style = [link.Style {Bold(true)}];

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

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: cell

Parent — このオブジェクトの親

PPT API オブジェクト

このオブジェクトの親。PPT API オブジェクトとして指定します。PPT API オブジェクトの親は 1 つでなければなりません。

属性:

GetAccess	public
SetAccess	private
NonCopyable	true

Children — このプロパティは無視されます

適用不可

クラスはこのプロパティを無視します。

属性:

GetAccess	public
SetAccess	private
NonCopyable	true

Tag — タグ

文字ベクトル | string スカラー

タグ。文字ベクトルまたは string スカラーとして指定します。PPT API は、このオブジェクトを作成するときに、セッション固有タグを生成します。生成されるタグの形式は CLASS:ID という形式です。ここで、CLASS はオブジェクト クラスです。ID はオブジェクトの Id プロパティの値です。この値を使用すると、プレゼンテーションの生成中に問題が発生した箇所を容易に特定できるようになります。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

Id — オブジェクト識別子

文字ベクトル | string スカラー

オブジェクト識別子。文字ベクトルまたは string スカラーとして指定します。PPT API は、プレゼンテーション要素オブジェクトの作成時にセッション固有識別子を生成します。Id には独自の値を指定できます。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

メソッド

パブリック メソッド

clone

objCopy = clone(obj) は、obj で指定された mlreportgen.ppt.InternalLink オブジェクトのコピーを返します。コピーにはソース オブジェクトの子が含まれますが、親は含まれません。 入力引数 obj — クローンするオブジェクト。mlreportgen.ppt.InternalLink オブジェクトとして指定します。 戻り値 objCopy— オブジェクトのコピー。mlreportgen.ppt.InternalLink オブジェクトとして返されます。 詳細については、mlreportgen.ppt.Paragraph クラスのメソッド clone を参照してください。

例

ターゲット スライドの名前を使用したスライドへのリンク

この例では、ターゲット スライドの名前を指定する mlreportgen.ppt.InternalLink オブジェクトを使用してスライドにリンクします。

プレゼンテーションを作成します。

import mlreportgen.ppt.*
ppt = Presentation("myPresentation1.pptx");
open(ppt);

プレゼンテーションにスライドを追加します。

slide1 = add(ppt,"Title and Content");

ターゲット スライドを識別するための名前を選択します。

targetSlideName = "myTargetSlide";

段落を作成します。ターゲット スライドを名前で指定する InternalLink オブジェクトを作成し、段落に追加します。

p = Paragraph("This is a link to the slide with the name ");
linkObj = InternalLink(targetSlideName,targetSlideName);
append(p,linkObj);

スライドにタイトルとコンテンツを追加します。

replace(slide1,"Title","First slide");
replace(slide1,"Content",p);

プレゼンテーションに 2 番目のスライドを追加します。

slide2 = add(ppt,"Title and Content");
replace(slide2,"Title","Second slide");

プレゼンテーションにターゲット スライドを追加します。スライドの Name プロパティを、InternalLink オブジェクトで指定された名前に設定します。

slide3 = add(ppt,"Title and Content");
slide3.Name = targetSlideName;
replace(slide3,"Title","Third slide");
content = strcat("This is the target slide with the name ",targetSlideName);
replace(slide3,"Content",content);

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

close(ppt);
rptview(ppt);

生成されたスライドは次のようになります。

ターゲット スライドのインデックスを使用したスライドへのリンク

この例では、ターゲット スライドの番号を指定する mlreportgen.ppt.InternalLink オブジェクトを使用してスライドにリンクします。

プレゼンテーションを作成します。

import mlreportgen.ppt.*
ppt = Presentation("myPresentation2.pptx");
open(ppt);

プレゼンテーションにスライドを追加します。

slide1 = add(ppt,"Title and Content");

段落を作成します。ターゲット スライドをインデックスで指定する InternalLink オブジェクトを作成し、そのオブジェクトを段落に追加します。

p = Paragraph("This is a link to ");
link = InternalLink(3,"slide 3");
append(p,link);

スライドにタイトルとコンテンツを追加します。

replace(slide1,"Title","First slide");
replace(slide1,"Content",p);

プレゼンテーションにスライド 2 を追加します。

slide2 = add(ppt,"Title and Content");
replace(slide2,"Title","Second slide");

ターゲット スライド (スライド 3) をプレゼンテーションに追加します。

slide3 = add(ppt,"Title and Content");
replace(slide3,"Title","Third slide");
replace(slide3,"Content","This is the target slide");

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

close(ppt);
rptview(ppt);

生成されたスライドは次のようになります。

バージョン履歴

R2021a で導入

参考

mlreportgen.ppt.ExternalLink | mlreportgen.ppt.Paragraph | mlreportgen.ppt.Text

トピック

• リンクの作成と書式設定
• プレゼンテーションの書式設定方法
• プレゼンテーション書式の継承