プレゼンテーションの図形に関連する API 操作 - Intelligent Media Management

このトピックでは、プレゼンテーションドキュメント内の図形に関連する API 操作について説明します。

図形

ActivePresentation.SlideShowWindow.View.Slide.Shapes

スライド上のすべての Shape オブジェクトのコレクションを返します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.10 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // スライド上のすべての Shape オブジェクトのコレクションを返します。
  const shapes = await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes;
}

メソッド

ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddPicture()

アクティブなスライドに画像を追加します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.10 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddPicture({ FileName, LinkToFile, SaveWithDocument, Left, Top, Width, Height, Scale })
expression: アプリケーションオブジェクト。

パラメーター

名前	データ型	必須	説明
FileName	String	はい	画像。画像は、Blob ファイルまたは URL を使用して指定できます。
LinkToFile	Enum	はい	画像を作成元のファイルにリンクするかどうかを指定します。詳細については、「MsoTriState」をご参照ください。
SaveWithDocument	Enum	はい	画像をドキュメントと一緒に保存するかどうかを指定します。 `LinkToFile` を `msoFalse` に設定した場合、このパラメーターの値は `msoTrue` である必要があります。詳細については、「MsoTriState」をご参照ください。
Left	Number	はい	スライドの左端を基準とした画像の左端の位置。位置は比率で表され、有効な値の範囲は 0 ～ 1 です。説明値が 0 未満または 1 を超える場合、画像はスライドの外側に配置されます。
Top	Number	はい	スライドの上端を基準とした画像の上端の位置。位置は比率で表され、有効な値の範囲は 0 ～ 1 です。説明値が 0 未満または 1 を超える場合、画像はスライドの外側に配置されます。
Width	Number	いいえ	画像の幅。幅は比率で表され、デフォルト値は 1 で、元の幅を示します。
Height	Number	いいえ	画像の高さ。高さは比率で表され、デフォルト値は 1 で、元の高さを示します。
Scale	Boolean	いいえ	スライドのスケールに基づいて画像の幅、高さ、座標を計算するかどうかを指定します。有効な値： false（デフォルト値） true

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // アクティブなスライドに画像を追加します。
  await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddPicture({
    FileName: 'https://image.developer.aliyundoc.com/storage/000000003682-2-tps-799-531.png', 
    LinkToFile: -1, 
    SaveWithDocument: 0,
    Left: 0.1,
    Top: 0.1,
    Width: 0.3,
    Height: 0.3,
    Scale: true,
  });
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddMediaObject()

メディアオブジェクトを挿入します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.14 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddMediaObject({ Type, FileName, File, Url, LinkToFile, Left, Top, Width, Height })
expression: アプリケーションオブジェクト。

パラメーター

名前	データ型	必須	説明
Type	`String`	はい	メディアファイルの種類：有効な値：'audio' および 'video'
FileName	`String`	はい	メディアファイル名。
File	`Object`	いいえ	オブジェクトのリンクと埋め込み (OLE) オブジェクトを作成するファイル。 Blob または File オブジェクトを指定できます。
Url	`String`	いいえ	ファイルの URL。 Base64 エンコード URL がサポートされています。
LinkToFile	`Enum`	はい	メディアファイルを、それが作成されたファイルにリンクするかどうかを指定します。詳細については、「MsoTriState」をご参照ください。
Left	`Number`	いいえ	スライドの左端に対するオブジェクトの左端の位置。
Top	`Number`	いいえ	スライドの上端に対するオブジェクトの上端の位置。
Width	`Number`	いいえ	オブジェクトの幅。
Height	`Number`	いいえ	オブジェクトの高さ。

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // アクティブなプレゼンテーションファイルにビデオを挿入します。
  await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddMediaObject({
    Type: 'video',
    FileName: 'audio.mp4',
    Url: 'https://res1.wpsacdm.cache.wpscdn.cn/videos/57da3d14aee8307bab5fa529503adba4-min.mp4', // WPS 学習のビデオ
    LinkToFile: 0, 
    Left: 100,
    Top: 200,
    Width: 300,
    Height: 300,
  });
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox()

テキストボックスを作成します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.10 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox({ Orientation, Left, Top, Width, Height, Color, Size, Scale, Bold, Italic, StrikeThrough, AlignMode })
expression: アプリケーションオブジェクト。

パラメーター

名前	データ型	必須	説明
Orientation	Enum	はい	テキストの向き。詳細については、「MsoTriState」をご参照ください。
Left	Number	はい	スライドの左端を基準としたテキストボックスの左端の位置。位置は比率で表され、有効な値の範囲は 0 ～ 1 です。説明値が 0 未満または 1 を超える場合、テキストボックスはスライドの外側に配置されます。
Top	Number	はい	スライドの上端を基準としたテキストボックスの上端の位置。位置は比率で表され、有効な値の範囲は 0 ～ 1 です。説明値が 0 未満または 1 より大きい場合、テキストボックスはスライドの外側に配置されます。
幅	数値	いいえ	テキストボックスの幅。幅は比率で表されます。デフォルト値： 0.05
高さ	番号	いいえ	テキストボックスの高さ。高さは比率で表されます。デフォルト値：0.25
色	文字列	いいえ	テキストの色です。デフォルト値は #000000 で、黒色を示します。
サイズ	番号	いいえ	テキストフォントのサイズです。デフォルト値：18
スケール	ブール値	いいえ	テキストボックスの幅を自動的に拡張するかどうかを指定します。有効な値： false (デフォルト値) true
太字	ブール値	いいえ	テキストを太字で表示するかどうかを指定します。有効な値： false (デフォルト値) true
イタリック	ブール値	いいえ	テキストを斜体で表示するかどうかを指定します。有効な値： false (デフォルト値) true
取り消し線	ブール値	いいえ	テキストに打ち消し線を適用するかどうかを指定します。有効な値： false (デフォルト値) true
整列モード	番号	いいえ	テキストの配置。有効な値： 1: 左揃え。これはデフォルト値です。 2: 中央揃え。 3: 右揃え。 4: 両端揃え。 5: 均等揃え。

戻り値
新しいテキストボックスを表す Shape オブジェクトを返します。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // テキストボックスを作成します。
  const textBox = await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox({
    Orientation: 0,
    Left: 0.1,
    Top: 0.1,
    Width: 0.1,
    Height: 0.1,
    Color: '#f00',
    Size: 36,
    Scale: true
  });
  textBox.TextFrame.TextRange.Text = '1245';
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.ReplacePicture()

スライドで選択した画像を置き換えます。

重要

IMM WebOffice SDK for JavaScript V1.1.10 以降でのみ、この機能がサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.ReplacePicture({ FileName, IsKeepShapeSize })
expression: アプリケーションオブジェクト。

パラメータ

名前

データ型

必須

説明

FileName

String/Object

はい

新しい画像のソース。ソースは Blob ファイルまたは URL です。

IsKeepShapeSize

ブール値

いいえ

ソース画像の縦横比を維持するかどうかを指定します。有効な値：

true: ソース画像の縦横比が維持されます。
false: ソース画像の幅と高さは、選択した画像の縦横比に基づいて変更されます。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // スライド上で選択した画像を置き換えます。
  await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.ReplacePicture({
    FileName: 'https://img8.file.cache.docer.com/storage/1626952237972828328/0e7c3a748ed2d065749b9659f54b679e.jpeg', // Docer の画像。
    IsKeepShapeSize: true, 
  });
}

図形

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item()

描画レイヤーにあるオートシェイプ、フリーフォーム、OLE オブジェクト、図などの単一のオブジェクトを取得します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.10 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 描画レイヤーにあるオートシェイプ、フリーフォーム、OLE オブジェクト、図などの単一のオブジェクトを取得します。
  const shape =await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1);
}

プロパティ

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).ActionSettings

Shape オブジェクトに対する操作設定のコレクションを返します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.14 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).ActionSettings
expression: アプリケーションオブジェクトです。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // Shape オブジェクトに対する操作設定のコレクションを取得します。
  const ActionSettings =await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).ActionSettings;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).AutoShapeType

Shape オブジェクトまたは ShapeRange オブジェクトの図形の種類を設定または返します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.14 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).AutoShapeType
expression: アプリケーションオブジェクトです。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 図形または図形範囲オブジェクトの図形の種類を取得します。
  const AutoShapeType =await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).AutoShapeType;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Fill

塗りつぶしの書式設定プロパティを取得します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.14 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Fill
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 図形オブジェクトの塗りつぶし書式プロパティを取得します。
  const Fill =await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Fill;
}

ActivePresentation.SlideMaster.Background.Fill.透過性

塗りつぶしの透明度を返したり、設定したりします。

構文
expression.ActivePresentation.SlideMaster.Background.Fill.Transparency
式: アプリケーションオブジェクト。
Transparency の有効な値: 0 ～ 1。0 を指定すると、背景は完全に透明になります。1 を指定すると、背景は完全に不透明になります。

例

//@file=base.pptx
async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 透明度を指定します。
  app.ActivePresentation.SlideMaster.Background.Fill.Transparency = 0.5;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Fill.Visible

塗りつぶしが表示されるかどうかを返します、または設定します。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Fill.Visible
expression: アプリケーションオブジェクト。

例

//@file=base.pptx
async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 塗りつぶしが表示されているかどうかをクエリします。
  await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Fill.Visible;

  // 塗りつぶしを表示するかどうかを指定します。
  app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Fill.Visible = true;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Fill.BackColor

塗りつぶしの背景色を返したり、設定したりします。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Fill.BackColor
expression: アプリケーションオブジェクト。

例

//@file=base.pptx
async function example() {
  await instance.ready();

  const app = instance.Application;

  // 背景色を照会します。
  await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Fill.BackColor.RGB;

  // 背景色を指定します。
  app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Fill.BackColor = '#ff0000';
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Fill.ForeColor

前景色の取得または設定を行います。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Fill.ForeColor
式: アプリケーションオブジェクト。

例

//@file=base.pptx
async function example() {
  await instance.ready();

  const app = instance.Application;

  // 前景色のクエリを実行します。
  await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Fill.ForeColor.RGB;

  // 前景色を設定します。
  app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Fill.ForeColor = '#ff0000';
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Fill.Type

塗りつぶしの種類を返します。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Fill.Type
expression: アプリケーションオブジェクト。

例

//@file=base.pptx
async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 塗りつぶしの種類を照会します。
  await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Fill.Type;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Line

図形の線のフォーマットを返します。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Line
expression: アプリケーションオブジェクト。

例

//@file=base.pptx
async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 行の書式設定を照会します。
  const lineFormat = await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Line;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Line.Transparency

回線の透明度のプロパティを返したり、設定したりします。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Line.Transparency
expression: アプリケーションオブジェクト。
Transparency の有効な値: 0 ～ 1。0 を指定すると、境界線は完全に不透明になります。1 を指定すると、境界線は完全に透明になります。

例

//@file=base.pptx
async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 透明度を照会します。
  await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Line.Transparency;

  // 透明度を指定します。
  app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Line.Transparency = 0.5;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Line.Visible

境界線が可視かどうかを返却または設定します。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Line.Visible
expression: アプリケーションオブジェクト。

例

//@file=base.pptx
async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 境界線が可視かどうかをクエリします。
  await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Line.Visible;

  // 境界線が可視かどうかを指定します。
  app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Line.Visible = true;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Line.BackColor

境界線の背景色を返したり、設定したりします。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Line.BackColor
expression: アプリケーションオブジェクトです。

例

//@file=base.pptx
async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 境界線の背景色をクエリします。
  await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Line.BackColor.RGB

  // 境界線の背景色を指定します。
  app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Line.BackColor = '#ff0000';
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Line.Style

境界線のスタイルを返したり、設定したりします。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Line.Style
式: アプリケーションオブジェクト。

例

//@file=base.pptx
async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 境界線のスタイルを照会します。
  await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Line.Style;

  // 境界線のスタイルを指定します。
  app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Line.Style = await app.Enum.MsoLineStyle.msoLineThickThin;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Line.DashStyle

境界線の破線のスタイルを返したり、設定したりします。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Line.DashStyle
式: アプリケーションオブジェクト。

例

//@file=base.pptx
async function example() {
  // インスタンスの準備ができるまで待機します。
  await instance.ready();

  const app = instance.Application;
  
  // 境界線の破線スタイルを照会します。
  await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Line.DashStyle;

  // 境界線の破線スタイルを指定します。
  app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Line.DashStyle = await app.Enum.MsoLineDashStyle.msoLineDashDot;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Glow

Shape オブジェクトのグロースタイルを返します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.14 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Glow
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 指定された図形オブジェクトのグロー フォーマットを取得します。
  const Glow = app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Glow;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).TextFrame

Shape オブジェクトのテキストフレームを返します。テキストフレームには、テキストフレーム内のテキスト、およびテキストフレームの配置とアンカーを制御するプロパティとメソッドが含まれています。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.14 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).TextFrame
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // Shape オブジェクトの操作設定のコレクションを取得します。
  const ActionSettings =await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).ActionSettings;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).HasTextFrame

Shape オブジェクトにテキストフレームが含まれているかどうかを確認します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.14 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).HasTextFrame
expression: アプリケーションオブジェクトです。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 指定された Shape オブジェクトにテキストフレームが含まれているかどうかを確認します。
  const HasTextFrame = app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).HasTextFrame;
}

プラグインのインストールプラグインのインストールこのページでは、WordPress の管理画面からプラグインをインストールする方法を説明します。プラグインの検索 WordPress の管理画面にログインし、「プラグイン」>「新規追加」をクリックします。検索ボックスにプラグイン名またはキーワードを入力し、「今すぐインストール」をクリックします。プラグインのアップロードプラグインをダウンロードした後、WordPress の管理画面で「プラグイン」>「新規追加」>「プラグインのアップロード」をクリックし、ダウンロードした zip ファイルを選択して「今すぐインストール」をクリックします。注意: アップロードできるのは zip 形式のファイルのみです。プラグインの有効化インストールが完了したら、「有効化」をクリックしてプラグインを有効にします。一部のプラグインは、有効化後に設定が必要になります。詳細については、「プラグインのドキュメント」をご参照ください。 ```

Shape オブジェクトの高さを返します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.14 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Height
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // Shape オブジェクトまたは ShapeRange オブジェクトの図形の種類を取得します。
  const AutoShapeType =await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).AutoShapeType;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Fill

Shape オブジェクトの幅を返します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.14 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Width
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // Shape オブジェクトの塗りつぶしの書式設定プロパティを取得します。
  const Fill =await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Fill;
}

ActivePresentation.SlideMaster.Background.Fill.Transparency

図形の境界ボックスの上端からスライドの上端までの距離を返したり、設定したりします。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Top
expression: アプリケーションオブジェクト。

例

//@file=base.pptx
async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 図形の境界ボックスの上端からスライドの上端までの距離を返します、または設定します。
  const Top = await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Top;
  app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Top = 10;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Left

図形のバウンディングボックスの左端からスライドの左端までの距離を返します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.14 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Left
式: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 図形のバウンディングボックスの左端からスライドの左端までの距離を取得します。
  const Left = app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Left;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Rotation

Shape オブジェクトの z 軸を中心とした回転角度を返します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.14 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Rotation
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // シェイプ オブジェクトの Z 軸を中心とした回転角度を取得します。
  const Rotation = app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Rotation;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Tags

Shape オブジェクトのタグを表す Tags オブジェクトを返します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.14 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Tags
式: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 指定された Shape オブジェクトのタグを表す Tags オブジェクトを取得します。
  const Tags = app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Tags;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Type

Shape オブジェクト 1 つのタイプ、または ShapeRange 内の複数の Shape オブジェクトのタイプを返します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.14 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Type
expression: アプリケーションオブジェクト。

例

//@file=base.pptx
async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 塗りつぶしが表示されるかどうかをクエリします。
  await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Fill.Visible;

  // 塗りつぶしが表示されるかどうかを指定します。
  app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Fill.Visible = true;
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Shadow

Shape オブジェクトの影の書式設定プロパティを返します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.14 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Shadow
expression: アプリケーションオブジェクト。

例

//@file=base.pptx
async function example() {
  await instance.ready();

  const app = instance.Application;

  // 背景色をクエリします。
  await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Fill.BackColor.RGB;

  // 背景色を指定します。
  app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Fill.BackColor = '#ff0000';
}

ShapeRange

ActiveWindow.Selection.ShapeRange

選択範囲内の Shape オブジェクトのコレクションを返します。

重要

IMM WebOffice SDK for JavaScript V1.1.14 以降でのみ、この機能がサポートされています。

構文
expression.ActiveWindow.Selection.ShapeRange
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // プレゼンテーション オブジェクトを取得します。
  const presentation = await app.ActiveWindow.Selection;

  // 選択範囲内の Shape オブジェクトのコレクションを取得します。
  const view = await presentation.ShapeRange;
}

メソッド

ActiveWindow.Selection.ShapeRange.Item()

Shape オブジェクトを返します。

重要

IMM WebOffice SDK for JavaScript V1.1.14 以降でのみ、この機能がサポートされています。

構文
expression.ActiveWindow.Selection.ShapeRange.Item(Index)
expression: アプリケーションオブジェクト。
パラメータ
名前
データ型
必須
説明
Index
数値
はい
Shape オブジェクトのインデックス番号です。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // プレゼンテーション オブジェクトを取得します。
  const presentation = await app.ActiveWindow.Selection;

  // 選択範囲内の Shape オブジェクトのコレクションを取得します。
  const view = await presentation.ShapeRange;

  // 選択範囲内の単一の Shape オブジェクトを取得します。
  await app.ActiveWindow.Selection.ShapeRange.Item(1);
}

プロパティ

ActiveWindow.Selection.ShapeRange.Count

選択範囲内の Shape オブジェクトの数を返します。

重要

IMM WebOffice SDK for JavaScript V1.1.14 以降でのみ、この機能がサポートされています。

構文
expression.ActiveWindow.Selection.ShapeRange.Count
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // プレゼンテーション オブジェクトを取得します。
  const presentation = await app.ActiveWindow.Selection;

  // 選択範囲内の Shape オブジェクトのコレクションを取得します。
  const view = await presentation.ShapeRange;

  // 選択範囲内の Shape オブジェクトの数を取得します。
  const count = await app.ActiveWindow.Selection.ShapeRange.Count
  console.log(count);
}

TextFrame

ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().TextFrame

Shape オブジェクトのテキストフレームを返します。テキストフレームには、テキストフレーム内のテキストと、テキストフレームの配置およびアンカーを制御するプロパティとメソッドが含まれています。

重要

IMM WebOffice SDK for JavaScript V1.1.10 以降でのみ、この機能がサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().TextFrame
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // Shape オブジェクトのテキストフレームを取得します。テキストフレームには、テキストフレーム内のテキストと、テキストフレームの配置およびアンカーを制御するプロパティとメソッドが含まれています。
  const TextFrame = app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).TextFrame;
}

TextRange

ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().TextFrame.TextRange

シェイプオブジェクトにアタッチされているテキスト、およびテキストを操作するプロパティとメソッドを取得します。

重要

IMM WebOffice SDK for JavaScript V1.1.10 以降でのみ、この機能がサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().TextFrame.TextRange
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // シェイプオブジェクトにアタッチされているテキスト、およびテキストを操作するためのプロパティとメソッドを取得します。
  const TextRange = app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().TextFrame.TextRange;
}

プロパティ

ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().TextFrame.TextRange.Text

シェイプオブジェクトに含まれるテキストを設定します。

重要

IMM WebOffice SDK for JavaScript V1.1.10 以降でのみ、この機能がサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().TextFrame.TextRange.Text
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // シェイプオブジェクトに含まれるテキストを設定します。
  app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().TextFrame.TextRange.Text = 'Aliyun';
}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(index).TextFrame.TextRange.Font

指定された TextRange オブジェクトのテキストフォーマットを表す Font オブジェクトを返します。

重要

IMM WebOffice SDK for JavaScript V1.1.14 以降でのみ、この機能がサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(index).TextFrame.GetTextRange(Begin,End).Font
expression: アプリケーションオブジェクト。
名前
データ型
必須
説明
Begin
数値
はい
テキスト範囲の開始位置。
End
数値
はい
テキスト範囲の終了位置。

例

async function example() {
 await instance.ready();

 const app = instance.Application;
 
 // 指定された範囲内の Font オブジェクトを返します。これには、指定されたテキストのテキスト属性が含まれます。
 const Font = app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).TextFrame.GetTextRang(1,2).Font;
}

ActionSettings

ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings

2 つの ActionSetting オブジェクトを含むコレクションを返します。

重要

IMM WebOffice SDK for JavaScript V1.1.10 以後でのみ、この機能がサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 2 つの ActionSetting オブジェクトを含むコレクションを取得します。
  const ActionSettings = await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings;
}

メソッド

ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item()

指定された ActionSettings コレクションから単一の操作設定を返します。

重要

IMM WebOffice SDK for JavaScript V1.1.10 以後でのみ、この機能がサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(Index)
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 指定された ActionSettings コレクションから単一の操作設定を取得します。
  const ActionSetting = await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(1);
}

ActionSetting

ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item()

スライドショー中に、指定された Shape オブジェクトまたは TexRange オブジェクト上でユーザーがクリックまたはマウスを移動したときに実行される操作に関する情報を保持する ActionSettings オブジェクトを返します。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.10 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(Index)
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // スライドショー中に Shape オブジェクトまたは TextRange オブジェクトに対するマウス操作に応答する方法に関する情報を取得します。
  const ActionSetting = await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(1);
}

プロパティ

ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item().Hyperlink

指定された Shape オブジェクトのハイパーリンクを表すハイパーリンクオブジェクトを返します。このプロパティは読み取り専用です。

重要

この機能は、IMM WebOffice SDK for JavaScript V1.1.10 以降でのみサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(Index).Hyperlink
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 指定された Shape オブジェクトのハイパーリンクを表す Hyperlink オブジェクトを返します。このプロパティは読み取り専用です。
  const ActionSetting = await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(1).Hyperlink;
}

ハイパーリンク

ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(Index).Hyperlink

Shape オブジェクトのハイパーリンクを返します。

重要

IMM WebOffice SDK for JavaScript V1.1.10 以降でのみ、この機能がサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(Index).Hyperlink
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // Shape オブジェクトのハイパーリンクを取得します。
  const ActionSetting = await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(1).Hyperlink;
}

プロパティ

ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(Index).Hyperlink.TextToDisplay

シェイプに関連付けられていないハイパーリンクの表示テキストを設定または返します。

重要

IMM WebOffice SDK for JavaScript V1.1.10 以降でのみ、この機能がサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(Index).Hyperlink.TextToDisplay
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // テキストボックスを作成します。
  const textBox = await app.Application.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox({
    Orientation: -1,
    Left: 0.3,
    Top: 0.3,
    Width: 100,
    Height: 30,
    Color: '#ff0',
    Size: 24,
    Scale: false,
  });

  // 表示テキストを指定します。
  textBox.ActionSettings(1).Hyperlink.TextToDisplay = 'Alibaba Cloud ナレッジベース';

  // ハイパーリンクを設定します。
  textBox.ActionSettings(1).Hyperlink.Address = 'https://example.aliyundoc.com/docs';

}

ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(Index).Hyperlink.Address

Shape オブジェクトのハイパーリンクアドレスを設定または返します。

重要

IMM WebOffice SDK for JavaScript V1.1.10 以降でのみ、この機能がサポートされています。

構文
expression.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(Index).Hyperlink.Address
expression: アプリケーションオブジェクト。

例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // テキストボックスを作成します。
  const textBox = await app.Application.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox({
    Orientation: -1,
    Left: 0.3,
    Top: 0.3,
    Width: 100,
    Height: 30,
    Color: '#ff0',
    Size: 24,
    Scale: false,
  });

  // 表示テキストを指定します。
  textBox.ActionSettings(1).Hyperlink.TextToDisplay = 'Aliyun';

  // ハイパーリンクを設定します。
  textBox.ActionSettings(1).Hyperlink.Address = 'https://example.aliyundoc.com/docs';
    
  // ハイパーリンク アドレスを取得します。
  const address = await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(1).Hyperlink.Address 
}