Arbeiten mit OneNote-Notizbüchern

Erstellen und Speichern eines Notizbuchs

Die von der API bereitgestellte Klasse Notebook ermöglicht das Erstellen eines Notizbuchs von Grund auf und das Speichern als OneNote-Notizbuch (.onetoc2). Ein OneNote-Notizbuch kann mit dem Standardkonstruktor der Klasse Notebook erstellt werden. Dieser Artikel zeigt, wie man ein Notizbuch erstellt und speichert.

Speichern des Notizbuchs in einen Stream

// Load the document into Aspose.Note.
String dataDir = Utils.getSharedDataDir(SaveNotebooktoStream.class) + "Notebook/";

Notebook notebook = new Notebook();

FileOutputStream stream = new FileOutputStream(dataDir + "output.onetoc2");

notebook.save(stream);

if (notebook.getCount() > 0) {
	Document childDocument0 = (Document) notebook.get_Item(0);

	OutputStream childStream = new FileOutputStream(dataDir + "childStream.one");
	childDocument0.save(childStream);

	Document childDocument1 = (Document) notebook.get_Item(1);

	childDocument1.save(dataDir + "child.one");
}

Unterstützung des Schreibens passwortgeschützter Dokumente als Teil eines .onetoc2-Notizbuchs

// Load the document into Aspose.Note.
String dataDir = Utils.getSharedDataDir(WritingPasswordProtectedDoc.class) + "Notebook/";
		
Notebook notebook = new Notebook();
		
NotebookOneSaveOptions saveOptions = new NotebookOneSaveOptions();
saveOptions.setDeferredSaving(true);
notebook.save(dataDir + "Open Notebook.onetoc2", saveOptions);

Document childDocument0 = (Document) notebook.get_Item(0);
childDocument0.save(dataDir + "Not Locked.one");

Document childDocument1 = (Document) notebook.get_Item(1);
OneSaveOptions documentSaveOptions1 = new OneSaveOptions();
documentSaveOptions1.setDocumentPassword("pass1");
childDocument1.save(dataDir + "Locked Pass1.one", documentSaveOptions1);

Document childDocument2 = (Document) notebook.get_Item(2);
OneSaveOptions documentSaveOptions2 = new OneSaveOptions();
documentSaveOptions2.setDocumentPassword("pass2");
childDocument2.save(dataDir + "Locked Pass2.one", documentSaveOptions2);

Lesen einer Notizbuchdatei

Die Notebook-Klasse der API ermöglicht das Lesen einer OneNote-Notizbuchdatei (.onetoc2) von der Festplatte. Die Klasse NotebookLoadOptions bietet zusätzliche Möglichkeiten, die Datei mit benutzerdefinierten Optionen zu laden.

Laden der Notizbuchdatei

String dataDir = Utils.getSharedDataDir(LoadingNotebook.class) + "Notebook/";
Notebook notebook = new Notebook(dataDir + "Notizbuch �ffnen.onetoc2");
      
      
for (INotebookChildNode notebookChildNode : notebook) {
	System.out.println(notebookChildNode.getDisplayName());

	if (notebookChildNode instanceof Document) {
		// Do something with child document
	} else if (notebookChildNode instanceof Notebook) {
		// Do something with child notebook
	}
}

Laden der Notizbuchdatei aus einem Stream

Laden der Notizbuchdatei mit LoadOptions

Standardmäßig werden untergeordnete Dokumente eines Notizbuchs „lazy“ geladen, d. h. deren Ladevorgang wird verzögert, bis sie direkt angesprochen werden. Alternativ können alle untergeordneten Dokumente sofort geladen werden, indem man dem Konstruktor NotebookLoadOptions mit dem Flag InstantLoading = true übergibt. Die folgenden Codebeispiele zeigen beide Ansätze.

Laden eines Notizbuchs mit Lazy Loading Option

String dataDir = Utils.getSharedDataDir(LoadingNotebookFilewithLoadOptions.class) + "Notebook/";

// By default children loading is "lazy".
Notebook notebook = new Notebook(dataDir + "test.onetoc2");

for (INotebookChildNode notebookChildNode : notebook) {
	// Actual loading of the child document happens only here.
	if (notebookChildNode instanceof Document) {
		// Do something with child document
	}
}

Sofortiges Laden eines Notizbuchs

// By default children loading is "lazy".
// Therefore for instant loading has took place,
// it is necessary to set the NotebookLoadOptions.InstantLoading flag.
NotebookLoadOptions loadOptions = new NotebookLoadOptions();
loadOptions.setInstantLoading(true);
String dataDir = Utils.getSharedDataDir(LoadingNotebookInstantly.class) + "Notebook/";
Notebook notebook = new Notebook(dataDir + "test.onetoc2", loadOptions);

// All child documents are already loaded.
for (INotebookChildNode notebookChildNode : notebook) {
	if (notebookChildNode instanceof Document) {
		// Do something with child document
	}
}

In der aktuellen Implementierung ist Lazy Loading nur für OneNote 2010-Unterdokumente/-notizbücher implementiert. OneNote Online-Erste-Ebene-Dokumente/-notizbücher werden immer sofort geladen.

Beispielsweise bei folgender Hierarchiestruktur:

— Root Notebook (2010)
— Abschnitt 1 Ebene 1 (2010)
— Abschnitt 2 Ebene 1 (Online)
— Notizbuch 1 Ebene 1 (2010)
—— Abschnitt 1 Ebene 2 (Online)
— Notizbuch 2 Ebene 1 (Online)
—— Abschnitt 1 Ebene 2 (Online)
—— Abschnitt 2 Ebene 2 (2010)

Werden nur folgende Kinder sofort geladen:
Root Notebook -> Abschnitt 2 Ebene 1,
Root Notebook -> Notizbuch 2 Ebene 1,
Root Notebook -> Notizbuch 2 Ebene 1 -> Abschnitt 1 Ebene 2.

Beachte, dass „Root Notebook -> Notizbuch 1 Ebene 1 -> Abschnitt 1 Ebene 2“ nicht zusammen mit dem „Root Notebook“ geladen wird, sondern erst dann, wenn „Notizbuch 1 Ebene 1“ geladen wird.

Laden passwortgeschützter Dokumente als Teil eines .onetoc2-Notizbuchs

Ein passwortgeschütztes Notizbuch kann mit Hilfe der Klasse LoadOptions und Angabe des Passworts geladen werden.

// Load the document into Aspose.Note.
String dataDir = Utils.getSharedDataDir(LoadPasswordProtectedDocuments.class) + "Notebook/";
		
NotebookLoadOptions loadOptions = new NotebookLoadOptions();
loadOptions.setDeferredLoading(true);
Notebook notebook = new Notebook(dataDir + "Notizbuch �ffnen.onetoc2", loadOptions);

notebook.loadChildDocument(dataDir + "Neuer Abschnitt 1.one");

LoadOptions documentLoadOptions1 = new LoadOptions();
documentLoadOptions1.setDocumentPassword("pass");
notebook.loadChildDocument(dataDir + "Locked Pass1.one", documentLoadOptions1);

LoadOptions documentLoadOptions2 = new LoadOptions();
documentLoadOptions2.setDocumentPassword("pass");
notebook.loadChildDocument(dataDir + "Locked Pass2.one", documentLoadOptions2);

Hinzufügen eines untergeordneten Knotens zu einem OneNote-Notizbuch

Die Aspose.Note API ermöglicht das Hinzufügen bzw. Anhängen eines untergeordneten Knotens zu einem Notizbuch. Die Methode appendChildLast der Klasse Notebook wird dafür verwendet.

String dataDir = Utils.getSharedDataDir(AddChildNode.class) + "Notebook/";
// Load a OneNote Notebook
Notebook notebook = new Notebook(dataDir + "Notizbuch �ffnen.onetoc2");

// Append a new child to the Notebook
notebook.appendChild(new Document(dataDir + "Neuer Abschnitt 1.one"));

dataDir = dataDir + "AddChildNodetoOneNoteNotebook_out.onetoc2";

// Save the Notebook
notebook.save(dataDir);

Entfernen eines untergeordneten Knotens aus einem OneNote-Notizbuch

Die API stellt die Methode removeChild bereit, mit der ein untergeordneter Knoten aus einem OneNote-Notizbuch entfernt werden kann.

String dataDir = Utils.getSharedDataDir(RemoveChildNode.class) + "Notebook/";
		
// Load a OneNote Notebook
Notebook notebook = new Notebook(dataDir + "test.onetoc2");

// Traverse through its child nodes for searching the desired child item
for (INotebookChildNode child : new List<>(notebook))
{
    if (child.getDisplayName() == "Remove Me")
    {
        // Remove the Child Item from the Notebook
        notebook.removeChild(child);
    }
}

dataDir = dataDir + "RemoveChildNodeFromOneNoteNotebook_out.onetoc2";

// Save the Notebook
notebook.save(dataDir);

Konvertieren eines Notizbuchdokuments in ein Bild

Die Aspose.Note API ermöglicht die Konvertierung von Notizbuchdokumenten (.onetoc2) in Bilder. Die API kann die Konvertierung direkt vornehmen oder es können zusätzliche Optionen mit NotebookImageSaveOptions festgelegt werden.

Exportieren des Notizbuchs als Bild

String dataDir = Utils.getSharedDataDir(ConvertToImage.class) + "Notebook/";
		
// Load a OneNote Notebook
Notebook notebook = new Notebook(dataDir + "Notizbuch �ffnen.onetoc2");

dataDir = dataDir + "ExportNotebooktoImage_out.png";
		
// Save the Notebook
notebook.save(dataDir);

Exportieren des Notizbuchs mit Optionen

String dataDir = Utils.getSharedDataDir(ConvertToImageWithOptions.class) + "Notebook/";
// Load a OneNote Notebook
Notebook notebook = new Notebook(dataDir + "test.onetoc2");

NotebookImageSaveOptions notebookSaveOptions = new NotebookImageSaveOptions(SaveFormat.Png);

ImageSaveOptions documentSaveOptions = notebookSaveOptions.getDocumentSaveOptions();

documentSaveOptions.setResolution(400);

dataDir = dataDir + "ExportNotebooktoImagewithOptions_out.png";

// Save the Notebook
notebook.save(dataDir, notebookSaveOptions);

Exportieren als flaches Notizbuch-Bild

String dataDir = Utils.getSharedDataDir(ConvertToImageAsFlattenedNotebook.class) + "Notebook/";
		
Notebook notebook = new Notebook(dataDir + "test.onetoc2");

NotebookImageSaveOptions saveOptions = new NotebookImageSaveOptions(SaveFormat.Png);

ImageSaveOptions documentSaveOptions = saveOptions.getDocumentSaveOptions();

documentSaveOptions.setResolution(400);

saveOptions.setFlatten(true);

notebook.save(dataDir + "ExportImageasFlattenedNotebook_out.png", saveOptions);

Konvertieren des Notizbuchdokuments in PDF

Die Aspose.Note API ermöglicht die Konvertierung von Notizbuchdokumenten (.onetoc2) ins PDF-Format. Die API unterstützt sowohl den direkten Export als auch die Verwendung zusätzlicher Optionen mittels NotebookPdfSaveOptions.

Bitte beachte, dass du keine Werte für die Felder Application und Producer setzen kannst – dort werden “Aspose Ltd.” und “Aspose.Note for Java x.x” angezeigt.

Exportieren des Notizbuchs als PDF

String dataDir = Utils.getSharedDataDir(ConvertToPDF.class) + "Notebook/";
		
// Load a OneNote Notebook
Notebook notebook = new Notebook(dataDir + "Notizbuch �ffnen.onetoc2");

dataDir = dataDir + "ExportNotebooktoPDF_out.pdf";

// Save the Notebook
notebook.save(dataDir);

Exportieren des Notizbuchs mit Optionen

String dataDir = Utils.getSharedDataDir(ConvertToPDFWithOptions.class) + "Notebook/";
		
// Load a OneNote Notebook
Notebook notebook = new Notebook(dataDir + "Notizbuch �ffnen.onetoc2");

NotebookPdfSaveOptions notebookSaveOptions = new NotebookPdfSaveOptions();

PdfSaveOptions documentSaveOptions = notebookSaveOptions.getDocumentSaveOptions();

documentSaveOptions.setPageSplittingAlgorithm (new KeepSolidObjectsAlgorithm());

dataDir = dataDir + "ExportNotebooktoPDFwithOptions_out.pdf";

// Save the Notebook
notebook.save(dataDir, notebookSaveOptions);

Exportieren als flaches Notizbuch-PDF

Die Aspose.Note API kann verwendet werden, um ein OneNote-Notizbuch als flaches PDF zu exportieren, wobei alle untergeordneten Inhalte in ein einzelnes Verzeichnis exportiert werden.

String dataDir = Utils.getSharedDataDir(ExportNotebookToPDFAsFlattened.class) + "Notebook/";

// Load a OneNote Notebook
Notebook notebook = new Notebook(dataDir + "Notizbuch îffnen.onetoc2");

NotebookPdfSaveOptions notebookSaveOptions = new NotebookPdfSaveOptions();

notebookSaveOptions.setFlatten(true);

dataDir = dataDir + "ExportNotebookToPDFAsFlattened_out.pdf";

// Save the Notebook
notebook.save(dataDir, notebookSaveOptions);

Abrufen von Dokumenten aus einem OneNote-Notizbuch

Das folgende Codebeispiel zeigt, wie man alle Dokumente in einem MS OneNote-Notizbuch einschließlich untergeordneter Notizbücher erhält:

String dataDir = Utils.getSharedDataDir(RetrieveDocumentsfromOneNoteNotebook.class) + "Notebook/";
Notebook rootNotebook = new Notebook(dataDir + "test.onetoc2");

List<Document> allDocuments = rootNotebook.getChildNodes(Document.class);
for (Document document : allDocuments) {
	System.out.println(document.getDisplayName());
}

RichText-Knoten aus einem Microsoft OneNote-Notizbuch lesen

Das folgende Codebeispiel zeigt, wie man alle RichText-Knoten aus einem OneNote-Notizbuch ausgibt:

String dataDir = Utils.getSharedDataDir(LoadingNotebook.class) + "Notebook/";
Notebook rootNotebook = new Notebook(dataDir + "test.onetoc2");

List<RichText> allRichTextNodes = rootNotebook.getChildNodes(RichText.class);
for (RichText richTextNode : allRichTextNodes) {
	System.out.println(richTextNode.getText());
}