OneNote ermöglicht das Sammeln, Organisieren und Zusammenarbeiten von Freiforminformationen und die Zusammenarbeit mehrerer Benutzer in Form von Notizen, Zeichnungen, Bildschirmausschnitten und Audiokommentaren. Wir können Bilder programmgesteuert in OneNote-Dokumente einfügen. In diesem Artikel erfahren Sie, wie Sie ein Bild zu einem OneNote in C# hinzufügen.
Folgende Themen sollen in diesem Artikel behandelt werden:
- C#-API zum Hinzufügen von Bildern zu OneNote
- Bild zu einem neuen OneNote-Dokument hinzufügen
- Bild in ein vorhandenes OneNote-Dokument einfügen
- Bild mit alternativem Text hinzufügen
C#-API zum Hinzufügen von Bildern zu OneNote
Um einem neuen oder vorhandenen OneNote-Dokument ein Bild hinzuzufügen, verwenden wir die API Aspose.Note for .NET. Die API ermöglicht das programmgesteuerte Erstellen, Lesen und Konvertieren von OneNote-Dokumenten ohne Verwendung von Microsoft OneNote. Es ermöglicht auch das Importieren von Inhalten aus PDF-Dokumenten in OneNote-Dokumente.
Bitte laden Sie die DLL der API herunter oder installieren Sie sie mit NuGet.
PM> Install-Package Aspose.Note
Bild zu neuem OneNote-Dokument in C# hinzufügen
Wir können ein neues OneNote-Dokument erstellen und ein Bild einfügen, indem wir die folgenden Schritte ausführen:
- Erstellen Sie zunächst eine Instanz der Document-Klasse.
- Initialisieren Sie als Nächstes das Page-Klassenobjekt.
- Laden Sie dann ein Bild mithilfe der Image-Klasse.
- Legen Sie optional Bildhöhe, -breite, -ausrichtung, -versatz usw. fest.
- Fügen Sie danach das Bild mit der Methode AppendChildLast() zur Seite hinzu.
- Fügen Sie auf ähnliche Weise die Seite zum Dokument hinzu.
- Rufen Sie schließlich die Methode Save() auf, um das OneNote-Dokument zu speichern.
Das folgende Codebeispiel zeigt, wie Sie einem neuen OneNote-Dokument mit C# ein Bild hinzufügen.
// Dieses Codebeispiel zeigt, wie Sie einem neuen OneNote-Dokument ein Bild hinzufügen.
// Der Pfad zum Dokumentenverzeichnis.
string dataDir = "C:\\Files\\Note\\";
// Erstellen Sie ein Objekt der Document-Klasse
Document doc = new Document();
// Objekt der Page-Klasse initialisieren
Page page = new Page();
// Laden Sie ein Bild über den Dateipfad.
Image image = new Image(dataDir + "sample.jpg");
// Bildausrichtung festlegen
image.Alignment = HorizontalAlignment.Right;
// Bild hinzufügen
page.AppendChildLast(image);
// Seitenknoten hinzufügen
doc.AppendChildLast(page);
// OneNote-Dokument speichern
dataDir = dataDir + "CreateOneNoteWithImage.one";
doc.Save(dataDir);
Bild zu vorhandenem OneNote-Dokument in C# hinzufügen
Wir können auch ein Bild in ein vorhandenes OneNote-Dokument einfügen, indem wir die folgenden Schritte ausführen:
- Laden Sie zunächst ein vorhandenes OneNote mithilfe der Document-Klasse.
- Initialisieren Sie als Nächstes das Page-Klassenobjekt.
- Laden Sie dann ein Bild mithilfe der Image-Klasse.
- Legen Sie optional Bildhöhe, -breite, -ausrichtung, -versatz usw. fest.
- Fügen Sie danach das Bild mit der Methode AppendChildLast() zur Seite hinzu.
- Fügen Sie auf ähnliche Weise die Seite zum Dokument hinzu.
- Rufen Sie schließlich die Methode Save() auf, um das OneNote-Dokument zu speichern.
Das folgende Codebeispiel zeigt, wie Sie einem vorhandenen OneNote-Dokument mithilfe von C# ein Bild hinzufügen.
// Dieses Codebeispiel zeigt, wie Sie einem vorhandenen OneNote-Dokument ein Bild hinzufügen.
// Der Pfad zum Dokumentenverzeichnis.
string dataDir = "C:\\Files\\Note\\";
// Dokument aus dem Stream laden.
Document doc = new Document(dataDir + "Sample1.one");
// Fügen Sie eine neue Seite hinzu.
Page page = new Page();
// Laden Sie ein Bild aus der Datei.
Image image = new Image(dataDir + "sample.jpg");
// Ändern Sie die Größe des Bildes nach Ihren Bedürfnissen (optional).
image.Width = 500;
image.Height = 750;
// Legen Sie die Position des Bildes auf der Seite fest (optional).
image.VerticalOffset = 400;
image.HorizontalOffset = 100;
// Bildausrichtung festlegen
image.Alignment = HorizontalAlignment.Right;
// Fügen Sie das Bild der Seite hinzu.
page.AppendChildLast(image);
doc.AppendChildLast(page);
// OneNote-Dokument speichern
dataDir = dataDir + "InsertImageIntoExisting.one";
doc.Save(dataDir);
Bild mit Alternativtext in OneNote mit C# einfügen
Wir können alternativen Bildtext hinzufügen, während wir ihn in ein OneNote-Dokument einfügen, indem wir die folgenden Schritte ausführen:
- Erstellen Sie zunächst eine Instanz der Document-Klasse.
- Initialisieren Sie als Nächstes das Page-Klassenobjekt.
- Laden Sie dann ein Bild mithilfe der Image-Klasse.
- Geben Sie als Nächstes die Eigenschaften AlternativeTextTitle und AlternativeTextDescription an.
- Fügen Sie danach das Bild mit der Methode AppendChildLast() zur Seite hinzu.
- Fügen Sie auf ähnliche Weise die Seite zum Dokument hinzu.
- Rufen Sie schließlich die Methode Save() auf, um das OneNote-Dokument zu speichern.
Das folgende Codebeispiel zeigt, wie Sie mithilfe von C# ein Bild mit alternativem Text in OneNote einfügen.
// Dieses Codebeispiel zeigt, wie Sie ein Bild mit alternativem Text in einem OneNote-Dokument hinzufügen.
// Der Pfad zum Dokumentenverzeichnis.
string dataDir = "C:\\Files\\Note\\";
// Erstellen Sie ein neues Dokument
var document = new Document();
// Fügen Sie eine neue Seite hinzu
var page = new Page();
// Laden Sie ein Bild
var image = new Image(dataDir + "sample.jpg");
// Geben Sie den alternativen Bildtext und die Beschreibung an
image.AlternativeTextTitle = "This is an image's title!";
image.AlternativeTextDescription = "And this is an image's description!";
// Bild anhängen
page.AppendChildLast(image);
// Seite anhängen
document.AppendChildLast(page);
// Speichern Sie das Dokument
dataDir = dataDir + "ImageAlternativeText.one";
document.Save(dataDir);
Holen Sie sich eine kostenlose Lizenz
Sie können eine kostenlose temporäre Lizenz erhalten, um die Bibliothek ohne Evaluierungseinschränkungen zu testen.
Fazit
In diesem Artikel haben wir gelernt, wie man:
- Erstellen Sie ein neues OneNote-Dokument mit C#;
- Laden Sie ein vorhandenes OneNote-Dokument;
- fügen Sie eine Seite zu einem OneNote-Dokument hinzu;
- programmgesteuert ein Bild zur OneNote-Dokumentseite hinzufügen;
Neben dem Hinzufügen eines Bildes zu einem OneNote in C# können Sie mithilfe der Dokumentation mehr über Aspose.Note für die .NET-API erfahren. Im Falle von Unklarheiten können Sie sich gerne in unserem kostenlosen Support-Forum an uns wenden.