Ink-Objekte in Präsentationen mit JavaScript verwalten

PowerPoint bietet die Ink‑Funktion, mit der Sie nicht‑standardisierte Figuren zeichnen können. Diese können verwendet werden, um andere Objekte hervorzuheben, Verbindungen und Prozesse zu zeigen und die Aufmerksamkeit auf bestimmte Elemente einer Folie zu lenken.

Aspose.Slides stellt alle Ink‑Typen (z. B. die Klasse Ink) bereit, die Sie zum Erstellen und Verwalten von Ink‑Objekten benötigen.

Unterschiede zwischen regulären Objekten und Ink‑Objekten

Objekte auf einer PowerPoint‑Folge werden typischerweise durch Shape‑Objekte dargestellt. Ein Shape‑Objekt ist im einfachsten Fall ein Container, der den Bereich des Objekts selbst (seinen Rahmen) zusammen mit seinen Eigenschaften definiert. Letztere umfassen die Größe des Containerbereichs, die Form des Containers, den Hintergrund des Containers usw. Weitere Informationen finden Sie unter Shape Layout Format.

Wenn PowerPoint jedoch ein Ink‑Objekt verarbeitet, ignoriert es alle Eigenschaften des Objektframes (Containers) außer dessen Größe. Die Größe des Containerbereichs wird durch die Standardwerte width und height bestimmt:

Inkshape Traces

Ein Trace ist ein Basis‑Element oder ein Standard, der die Trajektorie eines Stifts aufzeichnet, während ein Benutzer digitale Ink zeichnet. Traces sind Aufzeichnungen, die Sequenzen verbundener Punkte beschreiben.

Die einfachste Kodierung gibt die X‑ und Y‑Koordinaten jedes Sample‑Punktes an. Wenn alle verbundenen Punkte gerendert werden, entsteht ein Bild wie dieses:

Brush Properties For Drawing

Sie können einen Brush verwenden, um Linien zu zeichnen, die die Punkte der Trace‑Elemente verbinden. Der Brush hat seine eigene Farbe und Größe, die den Methoden Brush.setColor und Brush.setSize entsprechen.

Set Ink Brush Color

Dieser JavaScript‑Code zeigt, wie Sie die Farbe für einen Brush festlegen:

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var ink = pres.getSlides().get_Item(0).getShapes().get_Item(0);
    var traces = ink.getTraces();
    var brush = traces[0].getBrush();
    var brushColor = brush.getColor();
    brush.setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Set Ink Brush Size

Dieser JavaScript‑Code zeigt, wie Sie die Größe für einen Brush festlegen:

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var ink = pres.getSlides().get_Item(0).getShapes().get_Item(0);
    var traces = ink.getTraces();
    var brush = traces[0].getBrush();
    var brushSize = brush.getSize();
    brush.setSize(java.newInstanceSync("java.awt.Dimension", 5, 10));
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Im Allgemeinen stimmen Breite und Höhe eines Brushes nicht überein, sodass PowerPoint die Brush‑Größe nicht anzeigt (der Datenabschnitt ist ausgegraut). Stimmen Breite und Höhe jedoch überein, zeigt PowerPoint die Größe wie folgt an:

Zur Veranschaulichung erhöhen wir die Höhe des Ink‑Objekts und prüfen die wichtigen Abmessungen:

Der Container (Frame) berücksichtigt die Größe der Brushes nicht – er geht immer davon aus, dass die Linienstärke null ist (siehe das letzte Bild).

Daher müssen wir zur Bestimmung des sichtbaren Bereichs des gesamten Ink‑Objekts die Brush‑Größe der Trace‑Objekte berücksichtigen. Hier wurde das Zielobjekt (das Trace‑Objekt für handgeschriebene Texte) auf die Container‑ (Frame‑) Größe skaliert. Ändert sich die Größe des Containers (Frames), bleibt die Brush‑Größe konstant und umgekehrt.

PowerPoint zeigt dasselbe Verhalten bei Texten:

Weiterführende Literatur

• Für allgemeine Informationen zu Shapes siehe den Abschnitt PowerPoint Shapes.
• Weitere Informationen zu effektiven Werten finden Sie unter Shape Effective Properties.