ImageData

ImageData class

Definiert ein Bild für eine Form.

Um mehr zu erfahren, besuchen Sie dieArbeiten mit Bildern Dokumentationsartikel.

public class ImageData

Eigenschaften

NameBeschreibung
BiLevel { get; set; }Bestimmt, ob ein Bild in Schwarzweiß angezeigt wird.
Borders { get; }Ruft die Sammlung der Bildränder ab. Ränder wirken sich nur auf Inline-Bilder aus.
Brightness { get; set; }Ruft die Helligkeit des Bildes ab oder legt sie fest. Der Wert für diese Eigenschaft muss eine Zahl zwischen 0,0 (am dunkelsten) und 1,0 (am hellsten) sein.
ChromaKey { get; set; }Definiert den Farbwert des Bildes, der als transparent behandelt wird.
Contrast { get; set; }Ruft den Kontrast für das angegebene Bild ab oder legt ihn fest. Der Wert für diese Eigenschaft muss eine Zahl zwischen 0,0 (geringster Kontrast) und 1,0 (größter Kontrast) sein.
CropBottom { get; set; }Definiert den Anteil der Bildentfernung von der Unterseite.
CropLeft { get; set; }Definiert den Anteil der Bildentfernung von der linken Seite.
CropRight { get; set; }Definiert den Anteil der Bildentfernung von der rechten Seite.
CropTop { get; set; }Definiert den Anteil der Bildentfernung von der Oberseite.
GrayScale { get; set; }Bestimmt, ob ein Bild im Graustufenmodus angezeigt wird.
HasImage { get; }RückgabenWAHR wenn die Form Bildbytes enthält oder ein Bild verlinkt.
ImageBytes { get; set; }Ruft die Rohbytes des in der Form gespeicherten Bildes ab oder legt sie fest.
ImageSize { get; }Ruft Informationen zu Bildgröße und Auflösung ab.
ImageType { get; }Ruft den Typ des Bildes ab.
IsLink { get; }RückgabenWAHR wenn das Bild mit der Form verknüpft ist (wennSourceFullName angegeben ist).
IsLinkOnly { get; }RückgabenWAHR wenn das Bild verknüpft und nicht im Dokument gespeichert ist.
SourceFullName { get; set; }Ruft den Pfad und den Namen der Quelldatei für das verknüpfte Bild ab oder legt diese fest.
Title { get; set; }Definiert den Titel eines Bildes.

Methoden

NameBeschreibung
FitImageToShape()Passt die Bilddaten an den Formrahmen an, sodass das Seitenverhältnis der Bilddaten dem Seitenverhältnis des Formrahmens entspricht.
Save(Stream)Speichert das Bild im angegebenen Stream.
Save(string)Speichert das Bild in einer Datei.
SetImage(Image)Legt das Bild fest, das die Form anzeigt.
SetImage(Stream)Legt das Bild fest, das die Form anzeigt.
SetImage(string)Legt das Bild fest, das die Form anzeigt.
ToByteArray()Gibt Bildbytes für jedes Bild zurück, unabhängig davon, ob das Bild gespeichert oder verknüpft ist.
ToImage()Ruft das in der Form gespeicherte Bild alsImage Objekt.
ToStream()Erstellt und gibt einen Stream zurück, der die Bildbytes enthält.

Bemerkungen

Verwenden Sie dieImageDataEigenschaft, um auf das Bild innerhalb einer Form zuzugreifen und es zu ändern. Sie erstellen keine Instanzen derImageData Klasse direkt.

Ein Bild kann in einer Form gespeichert, mit einer externen Datei verknüpft oder beides (verknüpft und im Dokument gespeichert) sein.

Unabhängig davon, ob das Bild in der Form gespeichert oder verknüpft ist, können Sie immer auf das tatsächliche -Bild zugreifen, indem SieToByteArray ,ToStream ,ToImage oderSave methods. Wenn das Bild in der Form gespeichert ist, können Sie auch direkt darauf zugreifen, indem SieImageBytes Eigentum.

Um ein Bild in einer Form zu speichern, verwenden Sie dieSetImage Methode. Um ein Bild mit einer Form zu verknüpfen, legen Sie dieSourceFullName Eigentum.

Beispiele

Zeigt, wie Bilder aus einem Dokument extrahiert und als einzelne Dateien im lokalen Dateisystem gespeichert werden.

Document doc = new Document(MyDir + "Images.docx");

// Holen Sie sich die Sammlung von Formen aus dem Dokument,
// und speichere die Bilddaten jeder Form mit einem Bild als Datei im lokalen Dateisystem.
NodeCollection shapes = doc.GetChildNodes(NodeType.Shape, true);

Assert.AreEqual(9, shapes.Count(s => ((Shape)s).HasImage));

int imageIndex = 0;
foreach (Shape shape in shapes.OfType<Shape>())
{
    if (shape.HasImage)
    {
            // Die Bilddaten von Formen können Bilder in vielen möglichen Bildformaten enthalten.
        // Wir können für jedes Bild automatisch eine Dateierweiterung basierend auf seinem Format bestimmen.
        string imageFileName =
            $"File.ExtractImages.{imageIndex}{FileFormatUtil.ImageTypeToExtension(shape.ImageData.ImageType)}";
        shape.ImageData.Save(ArtifactsDir + imageFileName);
        imageIndex++;
    }
}

Zeigt, wie ein verknüpftes Bild in ein Dokument eingefügt wird.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

string imageFileName = ImageDir + "Windows MetaFile.wmf";

// Unten sind zwei Möglichkeiten aufgeführt, ein Bild auf eine Form anzuwenden, damit es angezeigt werden kann.
// 1 – Legen Sie die Form fest, die das Bild enthalten soll.
Shape shape = new Shape(builder.Document, ShapeType.Image);
shape.WrapType = WrapType.Inline;
shape.ImageData.SetImage(imageFileName);

builder.InsertNode(shape);

doc.Save(ArtifactsDir + "Image.CreateLinkedImage.Embedded.docx");

// Jedes Bild, das wir in der Form speichern, vergrößert die Größe unseres Dokuments.
Assert.True(70000 < new FileInfo(ArtifactsDir + "Image.CreateLinkedImage.Embedded.docx").Length);

doc.FirstSection.Body.FirstParagraph.RemoveAllChildren();

// 2 – Legen Sie fest, dass die Form mit einer Bilddatei im lokalen Dateisystem verknüpft werden soll.
shape = new Shape(builder.Document, ShapeType.Image);
shape.WrapType = WrapType.Inline;
shape.ImageData.SourceFullName = imageFileName;

builder.InsertNode(shape);
doc.Save(ArtifactsDir + "Image.CreateLinkedImage.Linked.docx");

// Durch das Verknüpfen mit Bildern wird Platz gespart und das Dokument wird kleiner.
// Allerdings kann das Dokument das Bild nur dann korrekt anzeigen, wenn
// Die Bilddatei befindet sich an dem Speicherort, auf den die Eigenschaft „SourceFullName“ der Form verweist.
Assert.True(10000 > new FileInfo(ArtifactsDir + "Image.CreateLinkedImage.Linked.docx").Length);

Siehe auch

HorizontalRuleFormat Class ImageSize Class