Vytvořte soubor OneNote v C# 2

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ř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);

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.

Související články