Buat Dokumen OneNote (.ONE) Secara Terprogram di C#

Aspose.Note for .NET adalah API manipulasi dokumen OneNote kaya fitur yang memungkinkan Anda membuat, membaca, dan mengonversi dokumen OneNote secara terprogram menggunakan C# atau VB.NET. Dalam artikel sebelumnya, kami telah membahas cara menggunakan Aspose.Note for .NET untuk mengonversi, membaca, dan mengurai dokumen OneNote. Hari ini, kami akan memeriksa cara membuat dokumen OneNote dari awal menggunakan C#.

MS OneNote memberi Anda cara mengatur dan mengelola informasi dalam bentuk catatan digital (.ONE). Halaman dalam dokumen OneNote digunakan untuk memuat konten yang ditentukan pengguna yang dapat terdiri dari teks, tabel, gambar, daftar, dll. Pada artikel ini, kami akan membahas semua aspek dasar pembuatan halaman dan kontennya dalam dokumen OneNote .

• Buat Dokumen OneNote Kosong
• Tambahkan Halaman ke Dokumen OneNote
• Sisipkan Gambar ke Dokumen OneNote
• Tambahkan Tabel di Dokumen OneNote
• Tambahkan Tag di Dokumen OneNote
• Sisipkan Hyperlink di Dokumen OneNote

Buat Dokumen OneNote (.ONE) menggunakan C#

Mari mulai dengan membuat dokumen OneNote kosong hanya dengan judul halaman. Berikut langkah-langkah untuk membuat dokumen OneNote dengan halaman kosong dan menyimpannya sebagai file .one.

• Buat instance dari kelas Document.
• Buat halaman baru dengan menginisialisasi objek Halaman dengan objek kelas Document.
• Tetapkan judul halaman menggunakan properti Page.Title.
• Panggil metode Document.AppendChild() dan teruskan objek Halaman.
• Terakhir, simpan dokumen OneNote menggunakan metode Document.Save().

Contoh kode berikut menunjukkan cara membuat dokumen OneNote kosong menggunakan C#.

// Path ke direktori dokumen.
string dataDir = RunExamples.GetDataDir_LoadingAndSaving();

// Buat objek dari kelas Document
Document doc = new Aspose.Note.Document();
// Inisialisasi objek kelas Halaman
Aspose.Note.Page page = new Aspose.Note.Page(doc);

// Gaya default untuk semua teks dalam dokumen.
ParagraphStyle textStyle = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
// Tetapkan properti judul halaman
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 }
};
// Tambahkan simpul Halaman dalam dokumen
doc.AppendChildLast(page);

dataDir = dataDir + "CreateDocWithPageTitle_out.one";
// Simpan dokumen OneNote
doc.Save(dataDir);

Tambahkan Halaman ke Dokumen OneNote menggunakan C#

Di bagian ini, kita akan selangkah lebih maju dan menambahkan teks ke halaman di dokumen OneNote. Halaman di dokumen OneNote bisa berupa halaman utama atau subhalaman. Misalnya, Anda membuat laporan tahunan yang selanjutnya berisi subbagian untuk laporan bulanan. Dalam kasus seperti itu, Anda dapat meletakkan deskripsi laporan di halaman utama dan laporan bulanan di subhalaman. Dalam dokumen OneNote, ini bisa ditangani menggunakan level halaman.

Berikut adalah langkah-langkah untuk membuat halaman di dokumen OneNote.

• Buat dokumen OneNote baru menggunakan kelas Document.
• Buat halaman baru untuk dokumen dan atur levelnya menggunakan kelas Halaman.
• Gunakan kelas Outline dan OutlineElement untuk membuat catatan.
• Tambahkan catatan ke halaman menggunakan metode Page.AppendChildLast().
• Tambahkan halaman ke dokumen OneNote menggunakan metode Document.AppendChildLast().
• Simpan dokumen menggunakan metode Document.Save().

Contoh kode berikut menunjukkan cara membuat dan menambahkan halaman ke dokumen OneNote menggunakan C#.

// Path ke direktori dokumen.
string dataDir = RunExamples.GetDataDir_Pages();

// Buat objek dari kelas Document
Document doc = new Document();
// Inisialisasi objek kelas Page dan atur levelnya
Aspose.Note.Page page1 = new Aspose.Note.Page(doc) { Level = 1 };
// Inisialisasi objek kelas Page dan atur levelnya
Aspose.Note.Page page2 = new Aspose.Note.Page(doc) { Level = 2 };
// Inisialisasi objek kelas Page dan atur levelnya
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";
// Simpan dokumen OneNote
doc.Save(dataDir);

Sisipkan Gambar ke Dokumen OneNote menggunakan C#

Anda juga bisa menyisipkan gambar ke halaman OneNote. Berikut ini adalah langkah-langkah untuk membuat dokumen OneNote yang memiliki gambar.

• Buat instance kelas Document untuk dokumen OneNote baru.
• Gunakan kelas Halaman untuk membuat halaman baru untuk dokumen.
• Buat instance baru dari kelas Gambar dan inisialisasi dengan jalur gambar.
• Tambahkan gambar ke halaman menggunakan metode OutlineElement.AppendChildLast().
• Tambahkan halaman ke dokumen menggunakan metode Document.AppendChildLast().
• Simpan dokumen OneNote.

Contoh kode berikut menunjukkan cara menyisipkan gambar ke dokumen OneNote menggunakan C#.

// Path ke direktori dokumen.
string dataDir = RunExamples.GetDataDir_Images();

// Buat objek dari kelas Document
Document doc = new Document();
// Inisialisasi objek kelas Halaman
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Inisialisasi objek kelas Outline dan atur properti offset
Outline outline = new Outline(doc) { VerticalOffset = 0, HorizontalOffset = 0 };
// Menginisialisasi objek kelas OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);
// Muat gambar dengan jalur file.
Aspose.Note.Image image = new Aspose.Note.Image(doc, dataDir + "image.jpg");
// Atur perataan gambar
image.Alignment = HorizontalAlignment.Right;
// Menambahkan gambar
outlineElem.AppendChildLast(image);
// Tambahkan elemen kerangka
outline.AppendChildLast(outlineElem);
// Tambahkan simpul Outline
page.AppendChildLast(outline);
// Tambahkan simpul Halaman
doc.AppendChildLast(page);

dataDir = dataDir + "BuildDocAndInsertImage_out.one";
// Simpan dokumen OneNote
doc.Save(dataDir);

Tambahkan Tabel ke Dokumen OneNote menggunakan C#

Tabel adalah cara yang bagus untuk mengatur dan meringkas data dalam bentuk baris dan kolom. Seiring dengan pengaturan yang efisien, tabel memungkinkan Anda menemukan data yang diinginkan dengan cepat. Dokumen OneNote juga mendukung tabel. Berikut langkah-langkah untuk menambahkan tabel pada dokumen OneNote.

• Buat dokumen OneNote baru menggunakan kelas Document.
• Buat halaman baru menggunakan kelas Halaman.
• Tambahkan baris tabel dan sel tabel baru masing-masing menggunakan kelas TableRow dan TableCell.
• Sisipkan elemen ke sel tabel menggunakan metode TableCell.AppendChildLast.
• Tambahkan sel ke baris tabel menggunakan metode TableRow.AppendChildLast().
• Buat instance dari kelas Tabel dan tambahkan baris tabel ke dalamnya.
• Tambahkan tabel ke halaman menggunakan kelas OutlineElement dan Outline.
• Tambahkan halaman ke dokumen dan simpan dokumen menggunakan metode Document.Save().

Contoh kode berikut menunjukkan cara menambahkan tabel ke dokumen OneNote menggunakan C#.

// Path ke direktori dokumen.
string dataDir = RunExamples.GetDataDir_Tables();

// Buat objek dari kelas Document
Document doc = new Document();
// Inisialisasi objek kelas Halaman
Aspose.Note.Page page = new Aspose.Note.Page(doc);

// Inisialisasi objek kelas TableRow
TableRow row1 = new TableRow(doc);
// Inisialisasi objek kelas TableCell
TableCell cell11 = new TableCell(doc);
TableCell cell12 = new TableCell(doc);
TableCell cell13 = new TableCell(doc);

// Tambahkan elemen kerangka di sel tabel
cell11.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.1"));
cell12.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.2"));
cell13.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.3"));
// Tabel sel ke baris
row1.AppendChildLast(cell11);
row1.AppendChildLast(cell12);
row1.AppendChildLast(cell13);

// Inisialisasi objek kelas TableRow
TableRow row2 = new TableRow(doc);
// menginisialisasi objek kelas TableCell
TableCell cell21 = new TableCell(doc);
TableCell cell22 = new TableCell(doc);
TableCell cell23 = new TableCell(doc);

// Tambahkan elemen kerangka di sel tabel
cell21.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.1"));
cell22.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.2"));
cell23.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.3"));

// Tambahkan sel tabel ke baris
row2.AppendChildLast(cell21);
row2.AppendChildLast(cell22);
row2.AppendChildLast(cell23);

// Inisialisasi objek kelas Tabel dan atur lebar kolom
Table table = new Table(doc)
{
    IsBordersVisible = true,
    Columns = { new TableColumn { Width = 200 }, new TableColumn { Width = 200 }, new TableColumn { Width = 200 } }
};
// Menambahkan baris tabel ke tabel
table.AppendChildLast(row1);
table.AppendChildLast(row2);

// Inisialisasi objek Outline
Outline outline = new Outline(doc);
// Menginisialisasi objek OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);
// Tambahkan tabel ke simpul elemen kerangka
outlineElem.AppendChildLast(table);
// Tambahkan elemen garis besar ke garis besar
outline.AppendChildLast(outlineElem);
// Tambahkan garis besar ke simpul halaman
page.AppendChildLast(outline);
// Tambahkan halaman ke simpul dokumen
doc.AppendChildLast(page);
dataDir = dataDir + "InsertTable_out.one";
doc.Save(dataDir);

Sisipkan Tag dalam Dokumen OneNote menggunakan C#

Tag digunakan untuk mengkategorikan atau memprioritaskan catatan dalam dokumen OneNote. Anda dapat menerapkan tag ke teks atau paragraf untuk menemukan atau memfilter catatan terkait dengan cepat. Berikut langkah-langkah membuat dan menambahkan tag pada dokumen OneNote.

• Buat instance dari kelas Document.
• Buat halaman baru menggunakan kelas Halaman.
• Menginisialisasi objek Outline dan OutlineElement.
• Buat objek RichText baru dan atur teks dan properti lainnya.
• Tambahkan tag ke teks menggunakan metode RichText.Tags.Add().
• Tambahkan teks ke halaman.
• Tambahkan halaman ke dokumen OneNote dan simpan.

Contoh kode berikut menunjukkan cara menambahkan tag ke teks di dokumen OneNote menggunakan C#.

// Path ke direktori dokumen.
string dataDir = RunExamples.GetDataDir_Tags();

// Buat objek dari kelas Document
Document doc = new Document();
// Inisialisasi objek kelas Halaman
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Inisialisasi objek kelas Outline
Outline outline = new Outline(doc);
// Menginisialisasi objek kelas 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,
});

// Tambahkan simpul teks
outlineElem.AppendChildLast(text);
// Tambahkan simpul elemen kerangka
outline.AppendChildLast(outlineElem);
// Tambahkan simpul kerangka
page.AppendChildLast(outline);
// Tambahkan simpul halaman
doc.AppendChildLast(page);

dataDir = dataDir + "AddTextNodeWithTag_out.one";
// Simpan dokumen OneNote
doc.Save(dataDir);

Sisipkan Hyperlink di Dokumen OneNote menggunakan C#

Last but not least, mari kita lihat cara menyisipkan hyperlink ke dokumen OneNote menggunakan langkah-langkah berikut.

• Buat instance dari kelas Document.
• Buat halaman baru untuk dokumen menggunakan kelas Halaman.
• Setel gaya teks hyperlink dan URL-nya menggunakan kelas TextStyle.
• Buat instance kelas RichText, tambahkan teksnya dan inisialisasi dengan gaya teks yang dibuat sebelumnya untuk hyperlink.
• Tambahkan teks ke halaman dokumen OneNote.
• Simpan dokumen sebagai .one file.

Contoh kode berikut menunjukkan cara menyisipkan hyperlink ke dokumen OneNote menggunakan C#.

// Path ke direktori dokumen.
string dataDir = RunExamples.GetDataDir_Tasks();

// Buat objek dari kelas Document
Document doc = new Document();
// Inisialisasi objek kelas Halaman
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// Inisialisasi objek kelas Judul
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);
// Tambahkan elemen kerangka
outline.AppendChildLast(outlineElem);
// Tambahkan simpul Outline
page.AppendChildLast(outline);
// Tambahkan simpul Halaman
doc.AppendChildLast(page);

dataDir = dataDir + "AddHyperlink_out.one";
// Simpan dokumen OneNote
doc.Save(dataDir);

Kesimpulan

Pada artikel ini, Anda telah mempelajari cara membuat dokumen OneNote (.ONE) dari awal menggunakan C#. Selain itu, artikel tersebut juga membahas cara menyisipkan halaman, gambar, tabel, tag, dan hyperlink ke dokumen OneNote secara terprogram. Anda dapat menjelajahi fitur menarik lainnya dari Aspose.Note for .NET menggunakan dokumentasi.

Artikel Terkait

• Mengonversi dan Membaca File Microsoft OneNote menggunakan C#