Διαχείριση Πινάκων Παρουσίασης σε JavaScript

Σχετικά με αυτήν τη σελίδα

Δημιουργήστε και επεξεργαστείτε πίνακες σε διαφάνειες PowerPoint με JavaScript και Aspose.Slides για Node.js. Ανακαλύψτε απλά παραδείγματα κώδικα για να βελτιώσετε τη ροή εργασίας των πινάκων σας.

Εισαγωγή

Ένας πίνακας στο PowerPoint είναι ένας αποδοτικός τρόπος εμφάνισης και παρουσίασης πληροφοριών. Οι πληροφορίες σε ένα πλέγμα κελιών (διατεταγμένα σε σειρές και στήλες) είναι απλές και εύκολες στην κατανόηση.

Η Aspose.Slides παρέχει την κλάση Table, την κλάση Cell και άλλους τύπους που σας επιτρέπουν να δημιουργείτε, να ενημερώνετε και να διαχειρίζεστε πίνακες σε κάθε είδους παρουσιάσεις.

Δημιουργία Πίνακα από την Αρχή

Δημιουργήστε ένα αντικείμενο της κλάσης Presentation.
Πάρτε την αναφορά μιας διαφάνειας μέσω του δείκτη της.
Ορίστε έναν πίνακα του columnWidth.
Ορίστε έναν πίνακα του rowHeight.
Προσθέστε ένα αντικείμενο Table στη διαφάνεια μέσω της μεθόδου addTable.
Επανάληψη σε κάθε Cell για να εφαρμόσετε μορφοποίηση στα άνω, κάτω, δεξιά και αριστερά σύνορα.
Ενώστε τα τέσσερα κελιά στην πάνω αριστερή γωνία του πίνακα (τις πρώτες δύο στήλες των πρώτων δύο σειρών) σε ένα ενιαίο κελί.
Πρόσβαση στο TextFrame ενός Cell.
Προσθέστε κάποιο κείμενο στο TextFrame.
Αποθηκεύστε την τροποποιημένη παρουσίαση.

Αυτός ο κώδικας JavaScript δείχνει πώς να δημιουργήσετε έναν πίνακα σε μια παρουσίαση:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

// Δημιουργεί μια κλάση Presentation που αντιπροσωπεύει ένα αρχείο PPTX
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);
        }
    }
    // Συγχωνεύει το μπλοκ 2x2 των κελιών στην επάνω αριστερή γωνία σε ένα κελί
    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).

Για παράδειγμα, τα κελιά σε έναν πίνακα με 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 δείχνει πώς να καθορίσετε την αρίθμηση των κελιών σε έναν πίνακα:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

// Δημιουργεί μια κλάση Presentation που αντιπροσωπεύει ένα αρχείο PPTX
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 δείχνει πώς να προσπελάσετε και να εργαστείτε με έναν υπάρχοντα πίνακα:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

// Δημιουργεί την κλάση Presentation που αντιπροσωπεύει ένα αρχείο PPTX
var pres = new aspose.slides.Presentation("UpdateExistingTable.pptx");
try {
    // Προσπελαύνει την πρώτη διαφάνεια
    var sld = pres.getSlides().get_Item(0);
    // Αρχικοποιεί το TableEx ως null
    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;
            // Ορίζει το κείμενο για την πρώτη στήλη της δεύτερης σειράς
            tbl.get_Item(0, 1).getTextFrame().setText("New");
        }
    }
    // Αποθηκεύει την τροποποιημένη παρουσίαση στο δίσκο
    pres.save("table1_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Εύρεση του Κελιού που Κατέχει ένα Text Frame

Όταν ένας γενικός κώδικας επεξεργασίας κειμένου λαμβάνει ένα TextFrame από έναν πίνακα, χρησιμοποιήστε τη μέθοδο TextFrame.getParentCell για να ανακτήσετε το κυρίαρχο Cell.
Για ένα κείμενο-πλαισίου κελιού πίνακα, η TextFrame.getParentCell επιστρέφει τον κάτοχο και η TextFrame.getParentShape επιστρέφει null, ακόμη και αν ο ίδιος ο πίνακας είναι σχήμα.

Οι συντεταγμένες του κελιού είναι διαθέσιμες μέσω των μόνο ανάγνωσης μεθόδων Cell.getFirstColumnIndex και Cell.getFirstRowIndex. Η TextFrame.getParentCell παρέχει επίσης μόνο-ανάγνωση πλοήγηση: επιστρέφει τον κάτοχο αλλά δεν αλλάζει την κυριότητα. Πάντα ελέγχετε το επιστρεφόμενο κελί για null πριν το χρησιμοποιήσετε.

Για ένα πλήρες παράδειγμα που εντοπίζει τους ιδιοκτήτες κελιών πίνακα και σχήματος, συμπεριλαμβανομένων των σχημάτων που σχετίζονται με κόμβους SmartArt, δείτε Search and Replace Text.

Στοίχιση Κειμένου σε Πίνακα

Δημιουργήστε ένα αντικείμενο της κλάσης Presentation.
Πάρτε την αναφορά μιας διαφάνειας μέσω του δείκτη της.
Προσθέστε ένα αντικείμενο Table στη διαφάνεια.
Προσπελάστε ένα αντικείμενο TextFrame από τον πίνακα.
Πρόσβαση στο [Paragraph] του TextFrame.
Στοιχίστε το κείμενο κατακόρυφα.
Αποθηκεύστε την τροποποιημένη παρουσίαση.

Αυτός ο κώδικας JavaScript δείχνει πώς να στοιχίσετε το κείμενο σε έναν πίνακα:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

// Δημιουργεί ένα αντικείμενο της κλάσης 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);
    // Δημιουργεί το αντικείμενο 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(java.newByte(aspose.slides.TextAnchorType.Center));
    cell.setTextVerticalType(java.newByte(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 δείχνει πώς να εφαρμόσετε τις προτινόμενες επιλογές μορφοποίησης στο κείμενο ενός πίνακα:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

// Δημιουργεί ένα αντικείμενο της κλάσης 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(java.newByte(aspose.slides.TextVerticalType.Vertical));
    someTable.setTextFormat(textFrameFormat);
    pres.save("result.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Ορισμός Προεπιλογής Στυλ Πίνακα

Η Aspose.Slides παρέχει τα ενσωματωμένα στυλ πίνακα του PowerPoint ως την αρίθμηση TableStylePreset, ώστε να μπορείτε να εφαρμόζετε την ίδια εμφάνιση σε οποιονδήποτε πίνακα. Αυτός ο κώδικας JavaScript δείχνει πώς να αντικαταστήσετε το προεπιλεγμένο στυλ ενός πίνακα με ένα προεπιλεγμένο στυλ:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

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);// αλλάζει το προεπιλεγμένο στυλ preset theme
    pres.save("table.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Κλείδωμα Αναλογίας Διαστάσεων του Πίνακα

Η αναλογία διαστάσεων ενός γεωμετρικού σχήματος είναι ο λόγος των μεγεθών του σε διαφορετικές διαστάσεις. Η Aspose.Slides παρείχε την ιδιότητα setAspectRatioLocked για να σας επιτρέψει να κλειδώσετε τη ρύθμιση της αναλογίας διαστάσεων για πίνακες και άλλα σχήματα.

Αυτός ο κώδικας JavaScript δείχνει πώς να κλειδώσετε την αναλογία διαστάσεων για ένα πίνακα:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

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 για ένα κελί· η εικόνα θα καλύψει την περιοχή του κελιού σύμφωνα με την επιλεγμένη λειτουργία (τέντωμα ή επικάλυψη).

Διαχείριση Γραμμών και Στηλών σε Πίνακες PowerPoint χρησιμοποιώντας JavaScript