Aspose.Note for .NET je rozhraní API pro manipulaci s dokumenty OneNote s bohatými funkcemi, které umožňuje vytvářet, číst a převádět dokumenty OneNotu programově pomocí C# nebo VB.NET. V předchozím článku jsme se zabývali tím, jak používat Aspose.Note for .NET ke konverzi, čtení a analýze dokumentů OneNotu. Dnes se podíváme na to, jak vytvořit dokumenty OneNote od začátku pomocí C#.
MS OneNote vám poskytuje způsob organizace a správy informací ve formě digitálních poznámek (.ONE). Stránky v dokumentech OneNotu se používají k tomu, aby obsahovaly uživatelsky definovaný obsah, který může sestávat z textu, tabulek, obrázků, seznamů atd. V tomto článku se budeme zabývat všemi základními aspekty vytváření stránek a jejich obsahu v dokumentech OneNotu. .
- Vytvořte prázdný dokument OneNotu
- Přidejte stránky do dokumentu OneNotu
- Vkládání obrázků do dokumentů OneNotu
- Přidejte tabulku do Dokumentů OneNotu
- Přidejte štítky do dokumentů OneNotu
- Vkládání hypertextových odkazů do dokumentů OneNotu
Vytvoření dokumentu OneNote (.ONE) pomocí C#
Začněme vytvořením prázdného dokumentu OneNotu pouze s názvem stránky. Následují kroky k vytvoření dokumentu OneNotu s prázdnou stránkou a jeho uložení jako souboru .one.
- Vytvořte instanci třídy Document.
- Vytvořte novou stránku inicializací objektu Page s objektem třídy Document.
- Nastavte název stránky pomocí vlastnosti Page.Title.
- Zavolejte metodu Document.AppendChild() a předejte objekt Page.
- Nakonec uložte dokument OneNotu pomocí metody Document.Save().
Následující ukázka kódu ukazuje, jak vytvořit prázdný dokument OneNote pomocí C#.
// Cesta k adresáři dokumentů.
string dataDir = RunExamples.GetDataDir_LoadingAndSaving();
// Vytvořte objekt třídy Document
Document doc = new Aspose.Note.Document();
// Inicializujte objekt třídy Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Výchozí styl pro veškerý text v dokumentu.
ParagraphStyle textStyle = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
// Nastavte vlastnosti titulku stránky
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 }
};
// Připojit uzel stránky v dokumentu
doc.AppendChildLast(page);
dataDir = dataDir + "CreateDocWithPageTitle_out.one";
// Uložte dokument OneNotu
doc.Save(dataDir);
Přidání stránek do dokumentu OneNotu pomocí C#
V této části postoupíme o krok vpřed a přidáme text na stránku v dokumentu OneNotu. Stránka v dokumentu OneNotu může být hlavní stránkou nebo podstránkou. Například vytváříte výroční zprávu, která dále obsahuje podsekce pro měsíční zprávy. V takovém případě můžete umístit popis reportu na hlavní stránku a měsíční reporty na podstránky. V dokumentu OneNotu to lze vyřešit pomocí úrovní stránky.
Následují kroky k vytvoření stránek v dokumentu OneNotu.
- Vytvořte nový dokument OneNotu pomocí třídy Dokument.
- Vytvořte nové stránky dokumentu a nastavte jejich úroveň pomocí třídy Page.
- K vytváření poznámek použijte třídy Outline a OutlineElement.
- Přidejte poznámky na stránky pomocí metody Page.AppendChildLast().
- Přidejte stránky do dokumentu OneNotu pomocí metody Document.AppendChildLast().
- Uložte dokument pomocí metody Document.Save().
Následující ukázka kódu ukazuje, jak vytvořit a přidat stránky do dokumentů OneNotu pomocí C#.
// Cesta k adresáři dokumentů.
string dataDir = RunExamples.GetDataDir_Pages();
// Vytvořte objekt třídy Document
Document doc = new Document();
// Inicializujte objekt třídy Page a nastavte jeho úroveň
Aspose.Note.Page page1 = new Aspose.Note.Page(doc) { Level = 1 };
// Inicializujte objekt třídy Page a nastavte jeho úroveň
Aspose.Note.Page page2 = new Aspose.Note.Page(doc) { Level = 2 };
// Inicializujte objekt třídy Page a nastavte jeho úroveň
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";
// Uložte dokument OneNotu
doc.Save(dataDir);
Vkládání obrázků do dokumentu OneNotu pomocí C#
Na stránky OneNotu můžete také vkládat obrázky. Následují kroky k vytvoření dokumentu OneNotu s obrázky.
- Vytvořte instanci třídy Document pro nový dokument OneNotu.
- K vytvoření nové stránky dokumentu použijte třídu Page.
- Vytvořte novou instanci třídy Image a inicializujte ji s cestou k obrázku.
- Přidejte obrázek na stránku pomocí metody OutlineElement.AppendChildLast().
- Přidejte stránku do dokumentu pomocí metody Document.AppendChildLast().
- Uložte dokument OneNotu.
Následující ukázka kódu ukazuje, jak vložit obrázky do dokumentu OneNotu pomocí C#.
// Cesta k adresáři dokumentů.
string dataDir = RunExamples.GetDataDir_Images();
// Vytvořte objekt třídy Document
Document doc = new Document();
// Inicializujte objekt třídy Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Inicializujte objekt třídy Outline a nastavte vlastnosti odsazení
Outline outline = new Outline(doc) { VerticalOffset = 0, HorizontalOffset = 0 };
// Inicializujte objekt třídy OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);
// Načtěte obrázek podle cesty k souboru.
Aspose.Note.Image image = new Aspose.Note.Image(doc, dataDir + "image.jpg");
// Nastavte zarovnání obrazu
image.Alignment = HorizontalAlignment.Right;
// Přidat obrázek
outlineElem.AppendChildLast(image);
// Přidejte prvky obrysu
outline.AppendChildLast(outlineElem);
// Přidat uzel osnovy
page.AppendChildLast(outline);
// Přidat uzel stránky
doc.AppendChildLast(page);
dataDir = dataDir + "BuildDocAndInsertImage_out.one";
// Uložte dokument OneNotu
doc.Save(dataDir);
Přidání tabulek do dokumentu OneNotu pomocí C#
Tabulky jsou skvělým způsobem, jak organizovat a sumarizovat data ve formě řádků a sloupců. Spolu s efektivní organizací vám tabulky umožňují rychle najít požadovaná data. Dokumenty OneNotu také podporují tabulky. Následují kroky k přidání tabulek do dokumentů OneNotu.
- Vytvořte nový dokument OneNotu pomocí třídy Dokument.
- Vytvořte novou stránku pomocí třídy Page.
- Přidejte nový řádek tabulky a buňky tabulky pomocí tříd TableRow a TableCell.
- Vložte prvky do buněk tabulky pomocí metody TableCell.AppendChildLast.
- Přidejte buňky do řádku tabulky pomocí metody TableRow.AppendChildLast().
- Vytvořte instanci třídy Table a přidejte do ní řádek tabulky.
- Přidejte tabulku na stránku pomocí tříd OutlineElement a Outline.
- Přidejte stránku do dokumentu a uložte dokument pomocí metody Document.Save().
Následující ukázka kódu ukazuje, jak přidat tabulku do dokumentu OneNotu pomocí C#.
// Cesta k adresáři dokumentů.
string dataDir = RunExamples.GetDataDir_Tables();
// Vytvořte objekt třídy Document
Document doc = new Document();
// Inicializujte objekt třídy Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Inicializujte objekt třídy TableRow
TableRow row1 = new TableRow(doc);
// Inicializujte objekty třídy TableCell
TableCell cell11 = new TableCell(doc);
TableCell cell12 = new TableCell(doc);
TableCell cell13 = new TableCell(doc);
// Přidejte prvky osnovy do buňky tabulky
cell11.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.1"));
cell12.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.2"));
cell13.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.3"));
// Buňky tabulky na řádky
row1.AppendChildLast(cell11);
row1.AppendChildLast(cell12);
row1.AppendChildLast(cell13);
// Inicializujte objekt třídy TableRow
TableRow row2 = new TableRow(doc);
// inicializovat objekty třídy TableCell
TableCell cell21 = new TableCell(doc);
TableCell cell22 = new TableCell(doc);
TableCell cell23 = new TableCell(doc);
// Přidejte prvky osnovy do buňky tabulky
cell21.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.1"));
cell22.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.2"));
cell23.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.3"));
// Připojit buňky tabulky k řádkům
row2.AppendChildLast(cell21);
row2.AppendChildLast(cell22);
row2.AppendChildLast(cell23);
// Inicializujte objekt třídy Table a nastavte šířky sloupců
Table table = new Table(doc)
{
IsBordersVisible = true,
Columns = { new TableColumn { Width = 200 }, new TableColumn { Width = 200 }, new TableColumn { Width = 200 } }
};
// Připojit řádky tabulky k tabulce
table.AppendChildLast(row1);
table.AppendChildLast(row2);
// Inicializovat objekt osnovy
Outline outline = new Outline(doc);
// Inicializujte objekt OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);
// Přidejte tabulku do uzlu prvku osnovy
outlineElem.AppendChildLast(table);
// Přidejte k obrysu prvek obrysu
outline.AppendChildLast(outlineElem);
// Přidejte obrys do uzlu stránky
page.AppendChildLast(outline);
// Přidat stránku do uzlu dokumentu
doc.AppendChildLast(page);
dataDir = dataDir + "InsertTable_out.one";
doc.Save(dataDir);
Vkládání značek do dokumentu OneNotu pomocí C#
Značky se používají ke kategorizaci nebo upřednostnění poznámek v dokumentech OneNotu. Na text nebo odstavec můžete použít značky a rychle najít nebo filtrovat související poznámky. Následují kroky k vytvoření a přidání tagů v dokumentech OneNotu.
- Vytvořte instanci třídy Document.
- Vytvořte novou stránku pomocí třídy Page.
- Inicializujte objekty Outline a OutlineElement.
- Vytvořte nový objekt RichText a nastavte jeho text a další vlastnosti.
- Přidejte značku k textu pomocí metody RichText.Tags.Add().
- Přidejte text na stránku.
- Přidejte stránku do dokumentu OneNotu a uložte ji.
Následující ukázka kódu ukazuje, jak přidat značky k textu v dokumentech OneNotu pomocí C#.
// Cesta k adresáři dokumentů.
string dataDir = RunExamples.GetDataDir_Tags();
// Vytvořte objekt třídy Document
Document doc = new Document();
// Inicializujte objekt třídy Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Inicializovat objekt třídy Outline
Outline outline = new Outline(doc);
// Inicializujte objekt třídy 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,
});
// Přidat textový uzel
outlineElem.AppendChildLast(text);
// Přidejte uzel prvku obrysu
outline.AppendChildLast(outlineElem);
// Přidat obrysový uzel
page.AppendChildLast(outline);
// Přidat uzel stránky
doc.AppendChildLast(page);
dataDir = dataDir + "AddTextNodeWithTag_out.one";
// Uložte dokument OneNotu
doc.Save(dataDir);
Vkládání hypertextových odkazů do dokumentu OneNotu pomocí C#
V neposlední řadě se podívejme, jak vložit hypertextové odkazy na dokumenty OneNotu pomocí následujících kroků.
- Vytvořte instanci třídy Document.
- Vytvořte novou stránku dokumentu pomocí třídy Page.
- Nastavte styl textu hypertextového odkazu a jeho adresu URL pomocí třídy TextStyle.
- Vytvořte instanci třídy RichText, přidejte její text a inicializujte ji dříve vytvořeným stylem textu pro hypertextový odkaz.
- Přidejte text na stránku dokumentu OneNotu.
- Uložte dokument jako soubor .one.
Následující ukázka kódu ukazuje, jak vložit hypertextový odkaz na dokument OneNote pomocí C#.
// Cesta k adresáři dokumentů.
string dataDir = RunExamples.GetDataDir_Tasks();
// Vytvořte objekt třídy Document
Document doc = new Document();
// Inicializujte objekt třídy Page
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Inicializovat objekt třídy Title
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);
// Přidejte prvky obrysu
outline.AppendChildLast(outlineElem);
// Přidat uzel osnovy
page.AppendChildLast(outline);
// Přidat uzel stránky
doc.AppendChildLast(page);
dataDir = dataDir + "AddHyperlink_out.one";
// Uložte dokument OneNotu
doc.Save(dataDir);
Závěr
V tomto článku jste se naučili, jak vytvořit dokumenty OneNote (.ONE) od začátku pomocí C#. Dále se článek také zabýval tím, jak programově vkládat stránky, obrázky, tabulky, značky a hypertextové odkazy do dokumentů OneNotu. Další zajímavé funkce Aspose.Note for .NET můžete prozkoumat pomocí dokumentace.