JavaScript でプレゼンテーションテーブルを管理する

PowerPoint の表は、情報を表示し伝える効率的な方法です。行と列に配置されたセルのグリッド内の情報は、シンプルで理解しやすいです。

Aspose.Slides は、Table クラス、Table クラス、Cell クラス、Cell クラス、その他のタイプを提供し、さまざまなプレゼンテーションで表の作成、更新、管理ができるようにします。

最初から表を作成する

Presentation クラスのインスタンスを作成します。
スライドのインデックスを使用してスライドへの参照を取得します。
columnWidth の配列を定義します。
rowHeight の配列を定義します。
addTable メソッドを使用して、スライドに Table オブジェクトを追加します。
各 Cell を反復処理して、上・下・右・左の境界線の書式設定を適用します。
表の最初の行の最初の 2 つのセルを結合します。
Cell の TextFrame にアクセスします。
TextFrame にテキストを追加します。
変更されたプレゼンテーションを保存します。

この JavaScript コードは、プレゼンテーションで表を作成する方法を示しています:

// PPTX ファイルを表す Presentation クラスのインスタンスを作成
var pres = new aspose.slides.Presentation();
try {
    // 最初のスライドにアクセス
    var sld = pres.getSlides().get_Item(0);
    // 列幅と行高を定義
    var dblCols = java.newArray("double", [50, 50, 50]);
    var dblRows = java.newArray("double", [50, 30, 30, 30, 30]);
    // スライドにテーブルシェイプを追加
    var tbl = sld.getShapes().addTable(100, 50, dblCols, dblRows);
    // 各セルの罫線書式を設定
    for (var row = 0; row < tbl.getRows().size(); row++) {
        for (var cell = 0; cell < tbl.getRows().get_Item(row).size(); cell++) {
            var cellFormat = tbl.getRows().get_Item(row).get_Item(cell).getCellFormat();
            cellFormat.getBorderTop().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderTop().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cellFormat.getBorderTop().setWidth(5);
            cellFormat.getBorderBottom().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderBottom().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cellFormat.getBorderBottom().setWidth(5);
            cellFormat.getBorderLeft().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderLeft().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cellFormat.getBorderLeft().setWidth(5);
            cellFormat.getBorderRight().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderRight().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cellFormat.getBorderRight().setWidth(5);
        }
    }
    // 行 1 のセル 1 と 2 を結合
    tbl.mergeCells(tbl.getRows().get_Item(0).get_Item(0), tbl.getRows().get_Item(1).get_Item(1), false);
    // 結合されたセルにテキストを追加
    tbl.getRows().get_Item(0).get_Item(0).getTextFrame().setText("Merged Cells");
    // プレゼンテーションをディスクに保存
    pres.save("table.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

標準表の番号付け

標準表では、セルの番号付けはシンプルで 0 ベースです。表の最初のセルは 0,0（列 0、行 0）としてインデックス付けされます。

たとえば、4 列 4 行の表のセルは次のように番号付けされます:

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

この JavaScript コードは、表のセルの番号指定方法を示しています:

// PPTX ファイルを表す Presentation クラスのインスタンスを作成
var pres = new aspose.slides.Presentation();
try {
    // 最初のスライドにアクセス
    var sld = pres.getSlides().get_Item(0);
    // 列の幅と行の高さを定義
    var dblCols = java.newArray("double", [70, 70, 70, 70]);
    var dblRows = java.newArray("double", [70, 70, 70, 70]);
    // スライドにテーブルシェイプを追加
    var tbl = sld.getShapes().addTable(100, 50, dblCols, dblRows);
    // 各セルの罫線書式を設定
    for (let i = 0; i < tbl.getRows().size(); i++) {
        const row = tbl.getRows().get_Item(i);
        for (let j = 0; j < row.size(); j++) {
            const cell = row.get_Item(j);
            cell.getCellFormat().getBorderTop().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cell.getCellFormat().getBorderTop().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cell.getCellFormat().getBorderTop().setWidth(5);
            cell.getCellFormat().getBorderBottom().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cell.getCellFormat().getBorderBottom().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cell.getCellFormat().getBorderBottom().setWidth(5);
            cell.getCellFormat().getBorderLeft().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cell.getCellFormat().getBorderLeft().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cell.getCellFormat().getBorderLeft().setWidth(5);
            cell.getCellFormat().getBorderRight().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cell.getCellFormat().getBorderRight().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cell.getCellFormat().getBorderRight().setWidth(5);
        }
    }
    // プレゼンテーションをディスクに保存
    pres.save("StandardTables_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

既存の表にアクセスする

Presentation クラスのインスタンスを作成します。
テーブルを含むスライドへの参照をインデックスを使用して取得します。
Table オブジェクトを作成し、null に設定します。
テーブルが見つかるまで、すべての Shape オブジェクトを反復処理します。

スライドに単一の表しか含まれていないと考えられる場合は、含まれるすべてのシェイプを単純にチェックできます。シェイプが表として識別されたら、Table オブジェクトに型変換できます。ただし、スライドに複数の表が含まれている場合は、setAlternativeText(String value) を使用して目的の表を検索した方が便利です。
Table オブジェクトを使用して表を操作します。以下の例では、表に新しい行を追加しました。
変更されたプレゼンテーションを保存します。

この JavaScript コードは、既存の表にアクセスして操作する方法を示しています:

// PPTX ファイルを表す Presentation クラスのインスタンスを作成
var pres = new aspose.slides.Presentation("UpdateExistingTable.pptx");
try {
    // 最初のスライドにアクセス
    var sld = pres.getSlides().get_Item(0);
    // null の TableEx を初期化
    var tbl = null;
    // シェイプを反復処理し、見つかったテーブルへの参照を設定
    for (let i = 0; i < sld.getShapes().size(); i++) {
        let shp = sld.getShapes().get_Item(i);
        if (java.instanceOf(shp, "com.aspose.slides.ITable")) {
            tbl = shp;
            // 第2行の第1列のテキストを設定
            tbl.get_Item(0, 1).getTextFrame().setText("New");
        }
    }
    // 変更されたプレゼンテーションをディスクに保存
    pres.save("table1_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

表内のテキストを配置する

Presentation クラスのインスタンスを作成します。
スライドのインデックスを使用してスライドへの参照を取得します。
スライドに Table オブジェクトを追加します。
表から TextFrame オブジェクトにアクセスします。
TextFrame の Paragraph にアクセスします。
テキストを垂直方向に配置します。
変更されたプレゼンテーションを保存します。

この JavaScript コードは、表内のテキストを配置する方法を示しています:

// Presentation クラスのインスタンスを作成
var pres = new aspose.slides.Presentation();
try {
    // 最初のスライドを取得
    var slide = pres.getSlides().get_Item(0);
    // 列幅と行高を定義
    var dblCols = java.newArray("double", [120, 120, 120, 120]);
    var dblRows = java.newArray("double", [100, 100, 100, 100]);
    // スライドにテーブルシェイプを追加
    var tbl = slide.getShapes().addTable(100, 50, dblCols, dblRows);
    tbl.get_Item(1, 0).getTextFrame().setText("10");
    tbl.get_Item(2, 0).getTextFrame().setText("20");
    tbl.get_Item(3, 0).getTextFrame().setText("30");
    // テキストフレームにアクセス
    var txtFrame = tbl.get_Item(0, 0).getTextFrame();
    // テキストフレームの Paragraph オブジェクトを作成
    var paragraph = txtFrame.getParagraphs().get_Item(0);
    // Paragraph の Portion オブジェクトを作成
    var portion = paragraph.getPortions().get_Item(0);
    portion.setText("Text here");
    portion.getPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
    // テキストを垂直方向に揃える
    var cell = tbl.get_Item(0, 0);
    cell.setTextAnchorType(aspose.slides.TextAnchorType.Center);
    cell.setTextVerticalType(aspose.slides.TextVerticalType.Vertical270);
    // プレゼンテーションをディスクに保存
    pres.save("Vertical_Align_Text_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

表レベルでテキスト書式設定を行う

Presentation クラスのインスタンスを作成します。
スライドのインデックスを使用してスライドへの参照を取得します。
スライドから Table オブジェクトにアクセスします。
テキストの setFontHeight(float value) を設定します。
setAlignment(int value) と setMarginRight(float value) を設定します。
setTextVerticalType(byte value) を設定します。
変更されたプレゼンテーションを保存します。

この JavaScript コードは、表内のテキストに好みの書式設定オプションを適用する方法を示しています:

// Presentation クラスのインスタンスを作成
var pres = new aspose.slides.Presentation("simpletable.pptx");
try {
    // まず最初のスライドの最初のシェイプがテーブルであると仮定します
    var someTable = pres.getSlides().get_Item(0).getShapes().get_Item(0);
    // テーブルセルのフォント高さを設定
    var portionFormat = new aspose.slides.PortionFormat();
    portionFormat.setFontHeight(25);
    someTable.setTextFormat(portionFormat);
    // テーブルセルのテキスト配置と右余白を一度に設定
    var paragraphFormat = new aspose.slides.ParagraphFormat();
    paragraphFormat.setAlignment(aspose.slides.TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
    someTable.setTextFormat(paragraphFormat);
    // テーブルセルのテキスト垂直方向タイプを設定
    var textFrameFormat = new aspose.slides.TextFrameFormat();
    textFrameFormat.setTextVerticalType(aspose.slides.TextVerticalType.Vertical);
    someTable.setTextFormat(textFrameFormat);
    pres.save("result.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

表のスタイルプロパティを取得する

Aspose.Slides は、表のスタイルプロパティを取得できるようにし、取得した詳細を別の表や他の場所で使用できます。この JavaScript コードは、表のプリセットスタイルからスタイルプロパティを取得する方法を示しています:

var pres = new aspose.slides.Presentation();
try {
    var table = pres.getSlides().get_Item(0).getShapes().addTable(10, 10, java.newArray("double", [100, 150]), java.newArray("double", [5, 5, 5]));
    table.setStylePreset(aspose.slides.TableStylePreset.DarkStyle1);// デフォルトのスタイルプリセットテーマを変更
    pres.save("table.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

表のアスペクト比をロックする

幾何学的形状のアスペクト比は、異なる次元におけるサイズの割合です。Aspose.Slides は、表やその他のシェイプのアスペクト比ロック設定を可能にする setAspectRatioLocked プロパティを提供しています。

この JavaScript コードは、表のアスペクト比をロックする方法を示しています:

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var table = pres.getSlides().get_Item(0).getShapes().get_Item(0);
    console.log("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());
    table.getGraphicalObjectLock().setAspectRatioLocked(!table.getGraphicalObjectLock().getAspectRatioLocked());// invert
    console.log("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());
    pres.save("pres-out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

FAQ

テーブル全体とセル内テキストに右から左 (RTL) の読み方向を有効にできますか？

はい。テーブルは setRightToLeft メソッドを提供し、段落には ParagraphFormat.setRightToLeft が用意されています。両方を使用することで、セル内の正しい RTL 順序とレンダリングが保証されます。

最終ファイルでユーザーがテーブルを移動またはサイズ変更できないようにするにはどうすればよいですか？

シェイプのロック機能を使用して、移動、サイズ変更、選択などを無効にします。これらのロックは表にも適用されます。

セル内に画像を背景として挿入することはサポートされていますか？

はい。セルに対して picture fill を設定できます。画像は選択したモード（伸縮またはタイル）に従ってセル領域を覆います。

プレゼンテーションビューア

JavaScript でプレゼンテーション テーブルを管理する