Formen getrennt von einem Dokument rendern
Bei der Verarbeitung von Dokumenten besteht eine häufige Aufgabe darin, alle im Dokument gefundenen Bilder zu extrahieren und an einen externen Speicherort zu exportieren. Diese Aufgabe wird mit Aspose.Words API einfach, das bereits die Funktionalität zum Extrahieren und Speichern von Bilddaten bietet. Manchmal möchten Sie jedoch möglicherweise auch andere Arten von Grafikinhalten extrahieren, die durch einen anderen Typ von Zeichenobjekt dargestellt werden, z. B. ein Textfeld mit Absätzen, Pfeilformen und einem kleinen Bild. Es gibt keine einfache Möglichkeit, dieses Objekt zu rendern, da es sich um eine Kombination einzelner Inhaltselemente handelt. Es kann auch vorkommen, dass der Inhalt zu einem Objekt gruppiert wurde, das wie ein einzelnes Bild aussieht.
Aspose.Words bietet Funktionen zum Extrahieren dieses Inhaltstyps auf die gleiche Weise, wie Sie ein einfaches Bild aus einer Form als gerenderten Inhalt extrahieren können. In diesem Artikel wird beschrieben, wie Sie diese Funktionalität verwenden, um Formen unabhängig vom Dokument zu rendern.
Formtypen in Aspose.Words
Der gesamte Inhalt einer Dokumentzeichnungsebene wird durch den Knoten Shape oder GroupShape im Dokumentobjektmodul Aspose.Words (DOM) dargestellt. Solche Inhalte können Textfelder, Bilder, AutoShapes, OLE Objekte usw. sein. Einige Felder werden auch als Formen importiert, z. B. das Feld INCLUDEPICTURE.
Ein einfaches Bild wird durch einen Shape -Knoten von ShapeType.Image dargestellt. Dieser Formknoten hat keine untergeordneten Knoten, aber auf die in diesem Formknoten enthaltenen Bilddaten kann mit der Eigenschaft Shape.ImageData zugegriffen werden. Andererseits kann eine Form auch aus vielen untergeordneten Knoten bestehen. Beispielsweise kann eine Textfeldform, die durch die Eigenschaft ShapeType.TextBox dargestellt wird, aus vielen Knoten bestehen, z. B. Paragraph und Table. Die meisten Formen können die Knoten Paragraph und Table auf Blockebene enthalten. Dies sind die gleichen Knoten wie die, die im Hauptteil erscheinen. Formen sind immer Teile eines Absatzes, entweder direkt inline enthalten oder an Paragraph, verankert, aber an einer beliebigen Stelle auf der Dokumentseite “schwebend”.
Ein Dokument kann auch Formen enthalten, die gruppiert sind. Die Gruppierung kann in Microsoft Word aktiviert werden, indem mehrere Objekte ausgewählt und im Kontextmenü auf “Gruppieren” geklickt wird.
In Aspose.Words werden diese Gruppen von Formen durch den Knoten GroupShape dargestellt. Diese können auch auf die gleiche Weise aufgerufen werden, um die gesamte Gruppe für das Bild zu rendern.
Das Format DOCX kann spezielle Bildtypen enthalten, z. B. Diagramme oder Diagramme. Diese Formen werden auch durch den Knoten Shape in Aspose.Words dargestellt, der auch eine ähnliche Methode zum Rendern als Bilder bereitstellt. Konstruktionsbedingt kann eine Form als Kind keine andere Form enthalten, es sei denn, diese Form ist ein Bild (ShapeType.Image). Mit Microsoft Word können Sie beispielsweise kein Textfeld in ein anderes Textfeld einfügen.
Die oben beschriebenen Formtypen bieten eine spezielle Methode zum Rendern der Formen über die Klasse ShapeRenderer. Eine Instanz der ShapeRenderer -Klasse wird für eine Shape oder GroupShape durch die GetShapeRenderer -Methode oder durch Übergeben der Shape an den Konstruktor der ShapeRenderer -Klasse abgerufen. Diese Klasse bietet Zugriff auf Elemente, mit denen eine Form wie folgt gerendert werden kann:
- Datei auf der Festplatte mit der Save-Methodenüberladung
- Stream mit der Save -Methodenüberladung
- Grafikobjekt mit den Methoden RenderToSize und RenderToScale
Rendern in Datei oder Stream
Die Save -Methode stellt Überladungen bereit, die eine Form direkt in eine Datei oder einen Stream rendern. Beide Überladungen akzeptieren eine Instanz der Klasse ImageSaveOptions, mit der Optionen zum Rendern der Form definiert werden können. Dies funktioniert genauso wie die Document.Save -Methode. Obwohl dieser Parameter erforderlich ist, können Sie einen Nullwert übergeben, der angibt, dass keine benutzerdefinierten Optionen vorhanden sind.
Die Form kann in ein beliebiges Bildformat exportiert werden, das in der SaveFormat-Aufzählung angegeben ist. Beispielsweise kann das Bild als Rasterbild gerendert werden, z. B. JPEG durch Angabe der SaveFormat.Jpeg-Aufzählung, oder als Vektorbild, z. B. EMF durch Angabe von SaveFormat.Emf.
Das folgende Codebeispiel zeigt das Rendern einer Form in ein EMF -Bild getrennt vom Dokument und das Speichern auf der Festplatte:
Das folgende Codebeispiel zeigt das Rendern einer Form in ein JPEG -Bild getrennt vom Dokument und das Speichern in einem Stream:
Mit der Klasse ImageSaveOptions können Sie eine Vielzahl von Optionen angeben, die steuern, wie das Bild gerendert wird. Die oben beschriebene Funktionalität kann in gleicher Weise auf die Knoten GroupShape und Shape angewendet werden.
Rendern in ein Graphics -Objekt
Durch direktes Rendern in ein Graphics -Objekt können Sie Ihre eigenen Einstellungen und den Status für das Graphics -Objekt definieren. Ein häufiges Szenario besteht darin, eine Form direkt in ein Graphics-Objekt zu rendern, das aus einem Windows-Formular oder einer Bitmap abgerufen wurde. Wenn der Shape -Knoten gerendert wird, wirken sich die Einstellungen auf das Erscheinungsbild der Form aus. Sie können die Form beispielsweise drehen oder skalieren, indem Sie die Methoden RotateTransform oder ScaleTransform für das Objekt Graphics verwenden.
Das folgende Beispiel zeigt, wie Sie eine Form separat vom Dokument auf ein Graphics -Objekt rendern und das gerenderte Bild drehen:
Ähnlich wie bei der RenderToSize-Methode ist die von NodeRendererBase geerbte RenderToSize-Methode nützlich, um Miniaturansichten des Dokumentinhalts zu erstellen. Die Formgröße wird durch den Konstruktor angegeben. Die RenderToSize -Methode akzeptiert das Graphics -Objekt, die X- und Y-Koordinaten der Bildposition und die Größe des Bildes (Breite und Höhe), das auf das Graphics -Objekt gezeichnet wird.
Die Shape kann mit der von der NodeRendererBase -Klasse geerbten ShapeRenderer.RenderToScale -Methode in einem bestimmten Maßstab gerendert werden. Dies ähnelt der Document.RenderToScale -Methode, die dieselben Hauptparameter akzeptiert. Der Unterschied zwischen diesen beiden Methoden besteht darin, dass Sie bei der ShapeRenderer.RenderToScale -Methode anstelle einer Literalgröße einen Gleitkommawert auswählen, der die Form während des Renderns skaliert. Wenn der Gleitkommawert gleich 1.0 ist, wird die Form mit 100% ihrer ursprünglichen Größe gerendert. Ein Gleitkommawert von 0.5 reduziert die Bildgröße um die Hälfte.
Rendern eines Formbilds
Die Klasse Shape repräsentiert Objekte in der Zeichnungsebene, z. B. ein AutoShape-, Textfeld-, Freiform-, OLE-Objekt, ActiveX-Steuerelement oder ein Bild. Mit der Klasse Shape können Sie Formen in einem Microsoft Word-Dokument erstellen oder ändern. Eine wichtige Eigenschaft einer Form ist ihre ShapeType. Formen verschiedener Typen können in einem Word-Dokument unterschiedliche Funktionen aufweisen. Beispielsweise können nur Bilder und OLE -Formen Bilder enthalten, während die meisten Formen nur Text enthalten können.
Das folgende Beispiel zeigt, wie Sie ein Formbild separat vom Dokument in ein JPEG-Bild rendern und auf der Festplatte speichern:
Abrufen einer Formgröße
Die ShapeRenderer -Klasse bietet auch Funktionen zum Abrufen der Größe der Form in Pixeln über die GetSizeInPixels -Methode. Diese Methode akzeptiert zwei float (Einzel–) Parameter - die Skalierung und DPI, die bei der Berechnung der Formgröße beim Rendern der Form verwendet werden. Die Methode gibt das Size -Objekt zurück, das die Breite und Höhe der berechneten Größe enthält. Dies ist nützlich, wenn die Größe der gerenderten Form im Voraus bekannt sein muss, z. B. beim Erstellen einer neuen Bitmap aus der gerenderten Ausgabe.
Das folgende Beispiel zeigt, wie Sie ein neues Bitmap- und Grafikobjekt mit der Breite und Höhe der zu rendernden Form erstellen:
Bei Verwendung der Methoden RenderToSize oder RenderToScale wird die gerenderte Bildgröße auch im Objekt SizeF zurückgegeben. Dies kann einer Variablen zugewiesen und bei Bedarf verwendet werden.
Die Eigenschaft SizeInPoints gibt die in Punkten gemessene Formgröße zurück (siehe ShapeRenderer). Das Ergebnis ist ein SizeF -Objekt, das die Breite und Höhe enthält.