Rendering Formen Getrennt von einem Dokument
Bei der Verarbeitung von Dokumenten besteht die gemeinsame Aufgabe darin, alle im Dokument gefundenen Bilder zu extrahieren und an einen externen Standort zu exportieren. Diese Aufgabe wird einfach mit Aspose.Words API, die bereits die Funktionalität zum Extrahieren und Speichern von Bilddaten bietet. Manchmal möchten Sie jedoch ähnlich andere Arten von grafischen Inhalten extrahieren, die durch eine andere Art von Zeichnungsobjekt dargestellt sind, beispielsweise ein Textfeld mit Absätzen, Pfeilformen und ein kleines Bild. Es gibt keinen einfachen Weg, dieses Objekt zu machen, da es sich um eine Kombination von einzelnen Inhaltselementen handelt. Sie können auch einen Fall auftreten, wenn die Inhalte zusammen in das Objekt gruppiert wurden, das wie ein einziges Bild aussieht.
Aspose.Words bietet Funktionalität, um diese Art von Inhalten in der gleichen Weise zu extrahieren, können Sie ein einfaches Bild aus der Form herausziehen, wie der erzeugte Inhalt. Dieser Artikel beschreibt, wie diese Funktionalität verwendet wird, um Formen unabhängig vom Dokument zu machen.
Formen in Aspose.Words
Alle Inhalte in einer Belegzeichnungsschicht sind durch die Shape oder GroupShape Knoten in der Aspose.Words Dokument Objektmodul (DOM) Solche Inhalte können Textfelder, Bilder, AutoShapes, OLE-Objekte usw. sein. Einige Felder werden auch als Formen importiert, zum Beispiel, INCLUDEPICTURE Feld.
Ein einfaches Bild wird durch eine Shape Knoten ShapeType.Image. Dieser Formknoten hat keine Kinderknoten, aber die innerhalb dieses Formknotens enthaltenen Bilddaten können von der Shape.ImageData Eigentum. Andererseits kann auch eine Form aus vielen Kinderknoten gebildet werden. Zum Beispiel eine Textfeldform, die durch die ShapeType.TextBox Eigenschaft, kann aus vielen Knoten, wie Paragraph und Table. Die meisten Formen können die Paragraph und Table Block-Level-Knoten. Dies sind die gleichen Knoten wie die im Hauptkörper erscheinen. Formen sind immer Teile eines Absatzes, entweder direkt inline enthalten oder an den Absatz aber “auslöschen” überall auf der Dokumentseite.
Ein Dokument kann auch Formen enthalten, die zusammen gruppiert werden. Grouping kann eingeschaltet werden Microsoft Word indem Sie mehrere Objekte auswählen und auf “Group” im Kontextmenü.
In Aspose.Words, Diese Formengruppen sind durch die GroupShape Knoten. Diese können auch in gleicher Weise aufgerufen werden, um die gesamte Gruppe zum Bild zu machen.
Das DOCX-Format kann spezielle Arten von Bildern, wie Diagramme oder Diagramme enthalten. Diese Formen sind auch durch die Shape Knoten in Aspose.Words, die auch ein ähnliches Verfahren zur Darstellung als Bilder bietet. Eine Form kann nicht als Kind eine andere Form enthalten, es sei denn, diese Form ist ein Bild (ShapeType.Image) Zum Beispiel Microsoft Word erlaubt es Ihnen nicht, ein Textfeld in ein anderes Textfeld einzufügen.
Die oben beschriebenen Formtypen liefern ein spezielles Verfahren, um die Formen durch die ShapeRenderer Klasse. Ein Beispiel der ShapeRenderer Klasse wird für eine Shape oder GroupShape durch die GetShapeRenderer Verfahren oder durch Passieren Shape zum Konstruktor der ShapeRenderer Klasse. Diese Klasse bietet Zugang zu Mitgliedern, die eine Form wie folgt zulassen:
- Datei auf der Festplatte mit der Save Prozessüberlastung
- Stream mit der Save Prozessüberlastung
- Grafiken Objekt mit Hilfe der RenderToSize und RenderToScale Methoden
Rendering to File oder Stream
Die Save Verfahren bietet Überlastungen, die eine Form direkt zu einer Datei oder einem Stream machen. Beide Überlastungen nehmen eine Instanz der ImageSaveOptions Klasse, die Optionen zur Gestaltung der Form definieren lässt. Dies funktioniert in der gleichen Weise wie die Document.Save Methode. Auch wenn dieser Parameter erforderlich ist, können Sie einen Null-Wert übergeben, indem Sie angeben, dass es keine benutzerdefinierten Optionen gibt.
Die Form kann in jedem Bildformat exportiert werden, das im SaveFormat Aufzählung. Beispielsweise kann das Bild als Rasterbild wie JPEG durch Angabe der SaveFormat.Jpeg Aufzählung oder als Vektorbild, wie EMF durch Angabe der SaveFormat.Emf.
Das nachfolgende Codebeispiel illustriert die Darstellung einer Form auf ein EMF-Bild getrennt von Dokument und das Speichern auf Festplatte:
Das nachfolgende Codebeispiel illustriert die Form eines JPEG-Bildes getrennt vom Dokument und die Speicherung in einen Stream:
Die ImageSaveOptions class ermöglicht es Ihnen, eine Vielzahl von Optionen anzugeben, die steuern, wie das Bild dargestellt wird. Die oben beschriebene Funktionalität kann in gleicher Weise auf die GroupShape und Shape Knoten.
Rendering to a Graphics Gegenstand
Direkt an eine Graphics Objekt ermöglicht es Ihnen, Ihre eigenen Einstellungen und den Zustand für die Graphics Objekt. Ein gemeinsames Szenario bedeutet, eine Form direkt in eine Graphics aus einem Windows Formular oder eine Bitmap. Wenn Shape node wird eingestellt, die Einstellungen beeinflussen die Form Aussehen. Beispielsweise können Sie die Form drehen oder skalieren, indem Sie die RotateTransform oder ScaleTransform Methoden für die Graphics Objekt.
Das folgende Beispiel zeigt, wie eine Form an eine Graphics Objekt getrennt vom Dokument und Anwendung Rotation auf das Rendered-Bild:
In ähnlicher Weise RenderToSize Verfahren, RenderToSizevon der NodeRendererBase ist nützlich für die Erstellung von Miniaturansichten von Dokumenteninhalten. Die Formgröße wird durch den Konstruktor vorgegeben. Die RenderToSize die Methode akzeptiert Graphics Objekt, die X- und Y-Koordinaten der Bildposition und die Größe des Bildes (Breite und Höhe), das auf die Graphics Objekt.
Die Shape mit Hilfe der ShapeRenderer.RenderToScale von der NodeRendererBase Klasse. Dies ist ähnlich wie die Document.RenderToScale Methode, die die gleichen großen Parameter akzeptiert. Der Unterschied zwischen diesen beiden Methoden ist, daß ShapeRenderer.RenderToScale Methode, statt einer wörtlichen Größe, wählen Sie einen Float-Wert, der die Form während seiner Rendering skaliert. Wenn der Schwimmerwert gleich 1,0 ist, wird die Form bei 100% ihrer ursprünglichen Größe wiedergegeben. Ein Schwimmerwert von 0,5 reduziert die Bildgröße um die Hälfte.
Rendern eines Formbildes
Die Shape Klasse stellt Objekte in der Zeichenschicht dar, wie ein AutoShape, Textfeld, Freeform, OLE-Objekt, ActiveX-Steuerung oder ein Bild. Verwendung von Shape Klasse, können Sie Formen in einer Microsoft Word Dokument. Eine wichtige Eigenschaft einer Form ist ihre ShapeType. Formen verschiedener Typen können in einem Word-Dokument unterschiedliche Fähigkeiten haben. Zum Beispiel können nur Bilder und OLE-Formen Bilder in ihnen haben, während die meisten Formen nur Text haben können.
Das folgende Beispiel zeigt, wie man ein Shape-Bild zu einem JPEG-Bild getrennt vom Dokument macht und auf die Festplatte speichert:
Abrufen einer Formgröße
Die ShapeRenderer Klasse bietet auch Funktionalität, um die Größe der Form in Pixeln durch die GetSizeInPixels Methode. Diese Methode akzeptiert zwei Float- (Single)-Parameter – die Skala und DPI, die bei der Berechnung der Formgröße beim Rendern der Form verwendet werden. Das Verfahren gibt die Size ein Objekt, das die Breite und Höhe der berechneten Größe enthält. Dies ist nützlich, wenn man die Größe der Rendered-Form im Voraus kennen muss, beispielsweise beim Erstellen einer neuen Bitmap aus dem Rendered-Ausgang.
Das folgende Beispiel zeigt, wie man ein neues Bitmap- und Grafikobjekt mit der Breite und Höhe der darzustellenden Form erstellt:
Bei Verwendung der RenderToSize oder RenderToScale Verfahren, wobei die Bildgröße auch in der SizeF Objekt. Dies kann einer Variable zugeordnet und bei Bedarf verwendet werden.
Die SizeInPoints Eigenschaft gibt die in Punkten gemessene Formgröße zurück (siehe ShapeRenderer) Das Ergebnis ist SizeF Objekt mit Breite und Höhe.