mlreportgen.ppt.InternalLink クラス

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

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

R2021a 以降

説明

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` — リンクテキストに太字を使用するかどうか
`[]` (既定値) | `true` | `false`

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

属性:

`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 の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywords を参照してください。
16 進数の RGB 形式を指定するには、最初の文字として # を使用し、赤、緑、および青の値に 2 桁の 16 進数を使用します。たとえば、"#0000ff" は青を指定します。

属性:

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

データ型: char | string

`FontSize` — リンクテキストのフォントサイズ
`[]` (既定値) | 文字ベクトル | string スカラー

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

"px" — ピクセル
"cm" — センチメートル
"in" — インチ
"mm" — ミリメートル
"pc" — パイカ
"pt" — ポイント

属性:

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

データ型: char | string

`Italic` — リンクテキストにイタリックを使用するかどうか
`[]` (既定値) | `true` | `false`

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

属性:

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

データ型: logical

`Strike` — リンクテキストの取り消し線スタイル
`[]` (既定値) | `"single"` | `"none"` | `"double"`

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

"single" — 一重水平線
"none" — 取り消し線なし
"double" — 二重水平線

属性:

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

`Subscript` — リンクテキストを下付き文字として表示するかどうか
`[]` (既定値) | `true` | `false`

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

属性:

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

データ型: logical

`Superscript` — リンクテキストを上付き文字として表示するかどうか
`[]` (既定値) | `true` | `false`

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

属性:

`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 オブジェクトのコピーを返します。

Paragraph オブジェクトの clone メソッドを使用するのと同じ方法で、InternalLink オブジェクトの 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

mlreportgen.ppt.InternalLink クラス

説明

クラス属性

作成

説明

プロパティ

Target — ハイパーリンクのターゲット スライド [] (既定値) | 整数 | 文字ベクトル | string スカラー

属性:

Content — リンク テキスト "" (既定値) | 文字ベクトル | string スカラー

属性:

Bold — リンク テキストに太字を使用するかどうか [] (既定値) | true | false

属性:

Font — リンク テキストのフォント ファミリ [] (既定値) | 文字ベクトル | string スカラー

属性:

ComplexScriptFont — コンプレックス スクリプト用のフォント ファミリ [] (既定値) | 文字ベクトル | string スカラー

属性:

FontColor — リンク テキストのフォント カラー [] (既定値) | 文字ベクトル | string スカラー

属性:

FontSize — リンク テキストのフォント サイズ [] (既定値) | 文字ベクトル | string スカラー

属性:

Italic — リンク テキストにイタリックを使用するかどうか [] (既定値) | true | false

属性:

Strike — リンク テキストの取り消し線スタイル [] (既定値) | "single" | "none" | "double"

属性:

Subscript — リンク テキストを下付き文字として表示するかどうか [] (既定値) | true | false

属性:

Superscript — リンク テキストを上付き文字として表示するかどうか [] (既定値) | true | false

属性:

Underline — このプロパティは無視されます [] (既定値)

属性:

Style — リンク テキストの書式設定 [] (既定値) | PPT 書式オブジェクトの cell 配列

属性:

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

属性:

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

属性:

Tag — タグ 文字ベクトル | string スカラー

属性:

Id — オブジェクト識別子 文字ベクトル | string スカラー

属性:

メソッド

パブリック メソッド

例

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

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

バージョン履歴

参考

トピック

`Target` — ハイパーリンクのターゲットスライド
`[]` (既定値) | 整数 | 文字ベクトル | string スカラー

`Content` — リンクテキスト
`""` (既定値) | 文字ベクトル | string スカラー

`Bold` — リンクテキストに太字を使用するかどうか
`[]` (既定値) | `true` | `false`

`Font` — リンクテキストのフォントファミリ
`[]` (既定値) | 文字ベクトル | string スカラー

`ComplexScriptFont` — コンプレックススクリプト用のフォントファミリ
`[]` (既定値) | 文字ベクトル | string スカラー

`FontColor` — リンクテキストのフォントカラー
`[]` (既定値) | 文字ベクトル | string スカラー

`FontSize` — リンクテキストのフォントサイズ
`[]` (既定値) | 文字ベクトル | string スカラー

`Italic` — リンクテキストにイタリックを使用するかどうか
`[]` (既定値) | `true` | `false`

`Strike` — リンクテキストの取り消し線スタイル
`[]` (既定値) | `"single"` | `"none"` | `"double"`

`Subscript` — リンクテキストを下付き文字として表示するかどうか
`[]` (既定値) | `true` | `false`

`Superscript` — リンクテキストを上付き文字として表示するかどうか
`[]` (既定値) | `true` | `false`

`Underline` — このプロパティは無視されます
`[]` (既定値)

`Style` — リンクテキストの書式設定
`[]` (既定値) | PPT 書式オブジェクトの cell 配列

`Parent` — このオブジェクトの親
PPT API オブジェクト

`Children` — このプロパティは無視されます
適用不可

`Tag` — タグ
文字ベクトル | string スカラー

`Id` — オブジェクト識別子
文字ベクトル | string スカラー

パブリックメソッド

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

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