Aspose.Note for .NET to bogaty w funkcje interfejs API do manipulowania dokumentami programu OneNote, który umożliwia programistyczne tworzenie, odczytywanie i konwertowanie dokumentów programu OneNote przy użyciu języka C# lub VB.NET. W poprzednim artykule omówiliśmy, jak używać Aspose.Note dla platformy .NET do konwertowania, odczytywania i analizowania dokumentów programu OneNote. Dzisiaj sprawdzimy, jak tworzyć dokumenty programu OneNote od podstaw przy użyciu języka C#.
MS OneNote zapewnia sposób organizowania i zarządzania informacjami w formie notatek cyfrowych (.ONE). Strony w dokumentach programu OneNote służą do przechowywania zawartości zdefiniowanej przez użytkownika, która może składać się z tekstu, tabel, obrazów, list itp. W tym artykule omówimy wszystkie podstawowe aspekty tworzenia stron i ich zawartości w dokumentach programu OneNote .
- Utwórz pusty dokument programu OneNote
- Dodaj strony do dokumentu programu OneNote
- Wstaw obrazy do dokumentów programu OneNote
- Dodaj tabelę w dokumentach programu OneNote
- Dodaj tagi w dokumentach programu OneNote
- Wstaw hiperłącza w dokumentach programu OneNote
Utwórz dokument OneNote (.ONE) przy użyciu języka C#
Zacznijmy od utworzenia pustego dokumentu programu OneNote zawierającego tylko tytuł strony. Poniżej przedstawiono kroki, aby utworzyć dokument OneNote z pustą stroną i zapisać go jako plik .one.
- Utwórz instancję klasy Document.
- Utwórz nową stronę, inicjując obiekt Page obiektem klasy Document.
- Ustaw tytuł strony za pomocą właściwości Page.Title.
- Wywołaj metodę Document.AppendChild() i przekaż obiekt Page.
- Na koniec zapisz dokument programu OneNote przy użyciu metody Document.Save().
Poniższy przykładowy kod pokazuje, jak utworzyć pusty dokument programu OneNote przy użyciu języka C#.
// Ścieżka do katalogu dokumentów.
string dataDir = RunExamples.GetDataDir_LoadingAndSaving();
// Utwórz obiekt klasy Document
Document doc = new Aspose.Note.Document();
// Zainicjuj obiekt klasy Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Domyślny styl dla całego tekstu w dokumencie.
ParagraphStyle textStyle = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
// Ustaw właściwości tytułu strony
page.Title = new Title(doc)
{
TitleText = new RichText(doc) { Text = "Title text.", ParagraphStyle = textStyle },
TitleDate = new RichText(doc) { Text = new DateTime(2011, 11, 11).ToString("D", CultureInfo.InvariantCulture), ParagraphStyle = textStyle },
TitleTime = new RichText(doc) { Text = "12:34", ParagraphStyle = textStyle }
};
// Dołącz węzeł strony w dokumencie
doc.AppendChildLast(page);
dataDir = dataDir + "CreateDocWithPageTitle_out.one";
// Zapisz dokument programu OneNote
doc.Save(dataDir);
Dodaj strony do dokumentu OneNote za pomocą C#
W tej sekcji pójdziemy o krok dalej i dodamy tekst do strony w dokumencie OneNote. Strona w dokumencie programu OneNote może być stroną główną lub stroną podrzędną. Na przykład tworzysz raport roczny, który dodatkowo zawiera podsekcje dla raportów miesięcznych. W takim przypadku możesz umieścić opis raportu na stronie głównej, a raporty miesięczne na podstronach. W dokumencie programu OneNote można to obsłużyć za pomocą poziomów strony.
Poniżej przedstawiono kroki tworzenia stron w dokumencie programu OneNote.
- Utwórz nowy dokument programu OneNote przy użyciu klasy Document.
- Utwórz nowe strony dla dokumentu i ustaw ich poziom za pomocą klasy Page.
- Użyj klas Outline i OutlineElement do tworzenia notatek.
- Dodaj notatki do stron za pomocą metody Page.AppendChildLast().
- Dodaj strony do dokumentu programu OneNote za pomocą metody Document.AppendChildLast().
- Zapisz dokument przy użyciu metody Document.Save().
Poniższy przykładowy kod pokazuje, jak tworzyć i dodawać strony do dokumentów programu OneNote przy użyciu języka C#.
// Ścieżka do katalogu dokumentów.
string dataDir = RunExamples.GetDataDir_Pages();
// Utwórz obiekt klasy Document
Document doc = new Document();
// Zainicjuj obiekt klasy Page i ustaw jego poziom
Aspose.Note.Page page1 = new Aspose.Note.Page(doc) { Level = 1 };
// Zainicjuj obiekt klasy Page i ustaw jego poziom
Aspose.Note.Page page2 = new Aspose.Note.Page(doc) { Level = 2 };
// Zainicjuj obiekt klasy Page i ustaw jego poziom
Aspose.Note.Page page3 = new Aspose.Note.Page(doc) { Level = 1 };
/*---------- Adding nodes to first Page ----------*/
Outline outline = new Outline(doc);
OutlineElement outlineElem = new OutlineElement(doc);
ParagraphStyle textStyle = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
RichText text = new RichText(doc) { Text = "First page.", ParagraphStyle = textStyle };
outlineElem.AppendChildLast(text);
outline.AppendChildLast(outlineElem);
page1.AppendChildLast(outline);
/*---------- Adding nodes to second Page ----------*/
var outline2 = new Outline(doc);
var outlineElem2 = new OutlineElement(doc);
var textStyle2 = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
var text2 = new RichText(doc) { Text = "Second page.", ParagraphStyle = textStyle2 };
outlineElem2.AppendChildLast(text2);
outline2.AppendChildLast(outlineElem2);
page2.AppendChildLast(outline2);
/*---------- Adding nodes to third Page ----------*/
var outline3 = new Outline(doc);
var outlineElem3 = new OutlineElement(doc);
var textStyle3 = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
var text3 = new RichText(doc) { Text = "Third page.", ParagraphStyle = textStyle3 };
outlineElem3.AppendChildLast(text3);
outline3.AppendChildLast(outlineElem3);
page3.AppendChildLast(outline3);
/*---------- Add pages to the OneNote Document ----------*/
doc.AppendChildLast(page1);
doc.AppendChildLast(page2);
doc.AppendChildLast(page3);
dataDir = dataDir + "CreateDocWithRootAndSubPages_out.one";
// Zapisz dokument programu OneNote
doc.Save(dataDir);
Wstaw obrazy do dokumentu OneNote za pomocą C#
Możesz także wstawiać obrazy na stronach programu OneNote. Poniżej przedstawiono kroki tworzenia dokumentu programu OneNote zawierającego obrazy.
- Utwórz wystąpienie klasy Document dla nowego dokumentu programu OneNote.
- Użyj klasy Page, aby utworzyć nową stronę dla dokumentu.
- Utwórz nową instancję klasy Image i zainicjuj ją ścieżką obrazu.
- Dodaj obraz do strony za pomocą metody OutlineElement.AppendChildLast().
- Dodaj stronę do dokumentu za pomocą metody Document.AppendChildLast().
- Zapisz dokument programu OneNote.
Poniższy przykładowy kod pokazuje, jak wstawiać obrazy do dokumentu programu OneNote przy użyciu języka C#.
// Ścieżka do katalogu dokumentów.
string dataDir = RunExamples.GetDataDir_Images();
// Utwórz obiekt klasy Document
Document doc = new Document();
// Zainicjuj obiekt klasy Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Zainicjuj obiekt klasy Outline i ustaw właściwości przesunięcia
Outline outline = new Outline(doc) { VerticalOffset = 0, HorizontalOffset = 0 };
// Zainicjuj obiekt klasy OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);
// Załaduj obraz według ścieżki pliku.
Aspose.Note.Image image = new Aspose.Note.Image(doc, dataDir + "image.jpg");
// Ustaw wyrównanie obrazu
image.Alignment = HorizontalAlignment.Right;
// Dodaj obraz
outlineElem.AppendChildLast(image);
// Dodaj elementy konturu
outline.AppendChildLast(outlineElem);
// Dodaj węzeł Konspektu
page.AppendChildLast(outline);
// Dodaj węzeł strony
doc.AppendChildLast(page);
dataDir = dataDir + "BuildDocAndInsertImage_out.one";
// Zapisz dokument programu OneNote
doc.Save(dataDir);
Dodaj tabele do dokumentu OneNote za pomocą C#
Tabele to doskonały sposób organizowania i podsumowywania danych w postaci wierszy i kolumn. Wraz z wydajną organizacją tabele pozwalają szybko zlokalizować żądane dane. Dokumenty programu OneNote obsługują również tabele. Poniżej przedstawiono kroki dodawania tabel w dokumentach programu OneNote.
- Utwórz nowy dokument programu OneNote przy użyciu klasy Document.
- Utwórz nową stronę za pomocą klasy Page.
- Dodaj nowy wiersz tabeli i komórki tabeli, używając odpowiednio klas TableRow i TableCell.
- Wstaw elementy do komórek tabeli za pomocą metody TableCell.AppendChildLast.
- Dodaj komórki do wiersza tabeli za pomocą metody TableRow.AppendChildLast().
- Utwórz instancję klasy Table i dodaj do niej wiersz tabeli.
- Dodaj tabelę do strony, używając klas OutlineElement i Outline.
- Dodaj stronę do dokumentu i zapisz dokument za pomocą metody Document.Save().
Poniższy przykładowy kod pokazuje, jak dodać tabelę do dokumentu programu OneNote przy użyciu języka C#.
// Ścieżka do katalogu dokumentów.
string dataDir = RunExamples.GetDataDir_Tables();
// Utwórz obiekt klasy Document
Document doc = new Document();
// Zainicjuj obiekt klasy Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Zainicjuj obiekt klasy TableRow
TableRow row1 = new TableRow(doc);
// Zainicjuj obiekty klasy TableCell
TableCell cell11 = new TableCell(doc);
TableCell cell12 = new TableCell(doc);
TableCell cell13 = new TableCell(doc);
// Dołącz elementy konturu w komórce tabeli
cell11.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.1"));
cell12.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.2"));
cell13.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.3"));
// Komórki tabeli do wierszy
row1.AppendChildLast(cell11);
row1.AppendChildLast(cell12);
row1.AppendChildLast(cell13);
// Zainicjuj obiekt klasy TableRow
TableRow row2 = new TableRow(doc);
// zainicjować obiekty klasy TableCell
TableCell cell21 = new TableCell(doc);
TableCell cell22 = new TableCell(doc);
TableCell cell23 = new TableCell(doc);
// Dołącz elementy konturu w komórce tabeli
cell21.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.1"));
cell22.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.2"));
cell23.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.3"));
// Dołącz komórki tabeli do wierszy
row2.AppendChildLast(cell21);
row2.AppendChildLast(cell22);
row2.AppendChildLast(cell23);
// Zainicjuj obiekt klasy Table i ustaw szerokości kolumn
Table table = new Table(doc)
{
IsBordersVisible = true,
Columns = { new TableColumn { Width = 200 }, new TableColumn { Width = 200 }, new TableColumn { Width = 200 } }
};
// Dołącz wiersze tabeli do tabeli
table.AppendChildLast(row1);
table.AppendChildLast(row2);
// Zainicjuj obiekt Outline
Outline outline = new Outline(doc);
// Zainicjuj obiekt OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);
// Dodaj tabelę do węzła elementu konturu
outlineElem.AppendChildLast(table);
// Dodaj element konspektu do konspektu
outline.AppendChildLast(outlineElem);
// Dodaj konspekt do węzła strony
page.AppendChildLast(outline);
// Dodaj stronę do węzła dokumentu
doc.AppendChildLast(page);
dataDir = dataDir + "InsertTable_out.one";
doc.Save(dataDir);
Wstaw tagi do dokumentu OneNote za pomocą C#
Tagi służą do kategoryzowania lub ustalania priorytetów notatek w dokumentach programu OneNote. Możesz zastosować znaczniki do tekstu lub akapitu, aby szybko znaleźć lub przefiltrować powiązane notatki. Poniżej przedstawiono kroki tworzenia i dodawania tagów w dokumentach programu OneNote.
- Utwórz instancję klasy Document.
- Utwórz nową stronę za pomocą klasy Page.
- Zainicjuj obiekty Outline i OutlineElement.
- Utwórz nowy obiekt RichText i ustaw jego tekst oraz inne właściwości.
- Dodaj znacznik do tekstu za pomocą metody RichText.Tags.Add().
- Dołącz tekst do strony.
- Dodaj stronę do dokumentu OneNote i zapisz ją.
Poniższy przykładowy kod pokazuje, jak dodawać tagi do tekstu w dokumentach programu OneNote przy użyciu języka C#.
// Ścieżka do katalogu dokumentów.
string dataDir = RunExamples.GetDataDir_Tags();
// Utwórz obiekt klasy Document
Document doc = new Document();
// Zainicjuj obiekt klasy Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Zainicjuj obiekt klasy Outline
Outline outline = new Outline(doc);
// Zainicjuj obiekt klasy OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);
ParagraphStyle textStyle = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
RichText text = new RichText(doc) { Text = "OneNote text.", ParagraphStyle = textStyle };
text.Tags.Add(new NoteTag
{
Icon = TagIcon.YellowStar,
});
// Dodaj węzeł tekstowy
outlineElem.AppendChildLast(text);
// Dodaj węzeł elementu konturu
outline.AppendChildLast(outlineElem);
// Dodaj węzeł konspektu
page.AppendChildLast(outline);
// Dodaj węzeł strony
doc.AppendChildLast(page);
dataDir = dataDir + "AddTextNodeWithTag_out.one";
// Zapisz dokument programu OneNote
doc.Save(dataDir);
Wstaw hiperłącza do dokumentu OneNote za pomocą C#
Na koniec zobaczmy, jak wstawić hiperłącza do dokumentów programu OneNote, wykonując następujące czynności.
- Utwórz instancję klasy Document.
- Utwórz nową stronę dokumentu za pomocą klasy Page.
- Ustaw styl tekstu hiperłącza i jego adresu URL za pomocą klasy TextStyle.
- Utwórz instancję klasy RichText, dodaj jej tekst i zainicjuj ją wcześniej utworzonym stylem tekstu dla hiperłącza.
- Dodaj tekst do strony dokumentu programu OneNote.
- Zapisz dokument jako plik .one.
Poniższy przykładowy kod pokazuje, jak wstawić hiperłącze do dokumentu programu OneNote przy użyciu języka C#.
// Ścieżka do katalogu dokumentów.
string dataDir = RunExamples.GetDataDir_Tasks();
// Utwórz obiekt klasy Document
Document doc = new Document();
// Zainicjuj obiekt klasy Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Zainicjuj obiekt klasy Tytuł
Title title = new Title(doc);
ParagraphStyle defaultTextStyle = new ParagraphStyle
{
FontName = "Arial",
FontSize = 10,
FontColor = SystemColors.WindowText
};
RichText titleText = new RichText(doc)
{
Text = "Title!",
ParagraphStyle = defaultTextStyle
};
Outline outline = new Outline(doc)
{
MaxWidth = 200,
MaxHeight = 200,
VerticalOffset = 100,
HorizontalOffset = 100
};
OutlineElement outlineElem = new OutlineElement(doc);
TextStyle textStyleRed = new TextStyle
{
FontColor = Color.Red,
FontName = "Arial",
FontSize = 10,
RunIndex = 8//this style will be applied to 0-7 characters.
};
TextStyle textStyleHyperlink = new TextStyle
{
RunIndex = 17,//this style will be applied to 8-16 characters.
IsHyperlink = true,
HyperlinkAddress = "www.google.com"
};
RichText text = new RichText(doc)
{
Text = "This is hyperlink. This text is not a hyperlink.",
ParagraphStyle = defaultTextStyle,
Styles = { textStyleRed, textStyleHyperlink }
};
title.TitleText = titleText;
page.Title = title;
outlineElem.AppendChildLast(text);
// Dodaj elementy konturu
outline.AppendChildLast(outlineElem);
// Dodaj węzeł Konspektu
page.AppendChildLast(outline);
// Dodaj węzeł strony
doc.AppendChildLast(page);
dataDir = dataDir + "AddHyperlink_out.one";
// Zapisz dokument programu OneNote
doc.Save(dataDir);
Wniosek
W tym artykule nauczyłeś się tworzyć od podstaw dokumenty programu OneNote (.ONE) przy użyciu języka C#. Ponadto w artykule omówiono również programowe wstawianie stron, obrazów, tabel, tagów i hiperłączy do dokumentów programu OneNote. Możesz poznać inne interesujące funkcje Aspose.Note for .NET, korzystając z dokumentacji.