إنشاء مستندات OneNote (.ONE) برمجيًا في C#

Aspose.Note for .NET هي واجهة برمجة تطبيقات لمعالجة مستندات OneNote غنية بالميزات تتيح لك إنشاء مستندات OneNote وقراءتها وتحويلها برمجيًا باستخدام C# أو VB.NET. في مقالة سابقة ، قمنا بتغطية كيفية استخدام Aspose.Note لـ .NET لتحويل مستندات OneNote وقراءتها وتحليلها. اليوم ، سنتحقق من كيفية إنشاء مستندات OneNote من البداية باستخدام C#.

يوفر لك MS OneNote طريقة لتنظيم وإدارة المعلومات في شكل ملاحظات رقمية (.ONE).تُستخدم الصفحات الموجودة في مستندات OneNote لاحتواء المحتوى المعرف من قبل المستخدم والذي قد يتكون من نصوص وجداول وصور وقوائم وما إلى ذلك. في هذه المقالة ، سنغطي جميع الجوانب الأساسية لإنشاء الصفحات ومحتواها في مستندات OneNote .

قم بإنشاء مستند OneNote فارغ
أضف صفحات إلى مستند OneNote
إدراج الصور في مستندات OneNote
أضف جدولاً في مستندات OneNote
أضف علامات في مستندات OneNote
قم بإدراج ارتباطات تشعبية في مستندات OneNote

إنشاء مستند OneNote (.ONE) باستخدام C#

لنبدأ بإنشاء مستند OneNote فارغ بعنوان صفحة فقط. فيما يلي خطوات إنشاء مستند OneNote بصفحة فارغة وحفظه كملف واحد.

قم بإنشاء مثيل لفئة المستند.
قم بإنشاء صفحة جديدة عن طريق تهيئة كائن الصفحة بكائن فئة المستند.
قم بتعيين عنوان الصفحة باستخدام خاصية Page.Title.
استدعاء الأسلوب Document.AppendChild() وتمرير كائن الصفحة.
أخيرًا ، احفظ مستند OneNote باستخدام أسلوب Document.Save().

يوضح نموذج التعليمات البرمجية التالي كيفية إنشاء مستند OneNote فارغ باستخدام C#.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_LoadingAndSaving();

// قم بإنشاء كائن من فئة المستند
Document doc = new Aspose.Note.Document();
// تهيئة كائن فئة الصفحة
Aspose.Note.Page page = new Aspose.Note.Page(doc);

// النمط الافتراضي لكل النص في المستند.
ParagraphStyle textStyle = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
// تعيين خصائص عنوان الصفحة
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 }
};
// إلحاق عقدة الصفحة في المستند
doc.AppendChildLast(page);

dataDir = dataDir + "CreateDocWithPageTitle_out.one";
// احفظ مستند OneNote
doc.Save(dataDir);

إضافة صفحات إلى مستند OneNote باستخدام C#

في هذا القسم ، سنتقدم خطوة واحدة ونضيف نصًا إلى الصفحة في مستند OneNote. يمكن أن تكون الصفحة في مستند OneNote هي الصفحة الرئيسية أو الصفحة الفرعية. على سبيل المثال ، تقوم بإنشاء تقرير سنوي يحتوي أيضًا على الأقسام الفرعية للتقارير الشهرية. في مثل هذه الحالة ، يمكنك وضع وصف التقرير على الصفحة الرئيسية والتقارير الشهرية على الصفحات الفرعية. في مستند OneNote ، يمكن معالجة ذلك باستخدام مستويات الصفحة.

فيما يلي خطوات إنشاء صفحات في مستند OneNote.

قم بإنشاء مستند OneNote جديد باستخدام فئة المستند.
قم بإنشاء صفحات جديدة للمستند وقم بتعيين مستواها باستخدام فئة الصفحة.
استخدم فئات Outline و OutlineElement لإنشاء ملاحظات.
أضف ملاحظات إلى الصفحات باستخدام طريقة Page.AppendChildLast().
أضف صفحات إلى مستند OneNote باستخدام أسلوب Document.AppendChildLast().
احفظ المستند باستخدام طريقة Document.Save().

يوضح نموذج التعليمات البرمجية التالي كيفية إنشاء وإضافة صفحات إلى مستندات OneNote باستخدام C#.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_Pages();

// قم بإنشاء كائن من فئة المستند
Document doc = new Document();
// تهيئة كائن فئة الصفحة وتعيين مستواه
Aspose.Note.Page page1 = new Aspose.Note.Page(doc) { Level = 1 };
// تهيئة كائن فئة الصفحة وتعيين مستواه
Aspose.Note.Page page2 = new Aspose.Note.Page(doc) { Level = 2 };
// تهيئة كائن فئة الصفحة وتعيين مستواه
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";
// احفظ مستند OneNote
doc.Save(dataDir);

إدراج الصور في مستند OneNote باستخدام C#

يمكنك أيضًا إدراج الصور في صفحات OneNote. فيما يلي خطوات إنشاء مستند OneNote به صور.

قم بإنشاء مثيل لفئة المستند لمستند OneNote جديد.
استخدم فئة الصفحة لإنشاء صفحة جديدة للمستند.
قم بإنشاء مثيل جديد لفئة الصورة وقم بتهيئته بمسار الصورة.
أضف صورة إلى الصفحة باستخدام طريقة OutlineElement.AppendChildLast().
أضف صفحة إلى المستند باستخدام طريقة Document.AppendChildLast().
احفظ مستند OneNote.

يوضح نموذج التعليمات البرمجية التالي كيفية إدراج الصور في مستند OneNote باستخدام C#.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_Images();

// قم بإنشاء كائن من فئة المستند
Document doc = new Document();
// تهيئة كائن فئة الصفحة
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// تهيئة كائن فئة المخطط التفصيلي وضبط خصائص الإزاحة
Outline outline = new Outline(doc) { VerticalOffset = 0, HorizontalOffset = 0 };
// تهيئة كائن فئة OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);
// قم بتحميل صورة من خلال مسار الملف.
Aspose.Note.Image image = new Aspose.Note.Image(doc, dataDir + "image.jpg");
// ضبط محاذاة الصورة
image.Alignment = HorizontalAlignment.Right;
// إضافة صورة
outlineElem.AppendChildLast(image);
// أضف عناصر المخطط التفصيلي
outline.AppendChildLast(outlineElem);
// أضف عقدة المخطط التفصيلي
page.AppendChildLast(outline);
// أضف عقدة الصفحة
doc.AppendChildLast(page);

dataDir = dataDir + "BuildDocAndInsertImage_out.one";
// احفظ مستند OneNote
doc.Save(dataDir);

إضافة جداول إلى مستند OneNote باستخدام C#

تعد الجداول طريقة جيدة لتنظيم البيانات وتلخيصها في شكل صفوف وأعمدة. إلى جانب التنظيم الفعال ، تتيح لك الجداول تحديد موقع البيانات المطلوبة بسرعة. تدعم مستندات OneNote أيضًا الجداول. فيما يلي خطوات إضافة الجداول في مستندات OneNote.

قم بإنشاء مستند OneNote جديد باستخدام فئة المستند.
قم بإنشاء صفحة جديدة باستخدام فئة الصفحة.
أضف صفًا جديدًا للجدول وخلايا الجدول باستخدام فئات TableRow و TableCell على التوالي.
قم بإدراج العناصر في خلايا الجدول باستخدام أسلوب TableCell.AppendChildLast.
أضف خلايا إلى صف الجدول باستخدام طريقة TableRow.AppendChildLast().
قم بإنشاء مثيل لفئة Table وأضف صف الجدول إليها.
أضف الجدول إلى الصفحة باستخدام فئات OutlineElement و Outline.
أضف صفحة إلى المستند واحفظ المستند باستخدام طريقة Document.Save().

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة جدول إلى مستند OneNote باستخدام C#.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_Tables();

// قم بإنشاء كائن من فئة المستند
Document doc = new Document();
// تهيئة كائن فئة الصفحة
Aspose.Note.Page page = new Aspose.Note.Page(doc);

// تهيئة كائن فئة TableRow
TableRow row1 = new TableRow(doc);
// تهيئة كائنات فئة TableCell
TableCell cell11 = new TableCell(doc);
TableCell cell12 = new TableCell(doc);
TableCell cell13 = new TableCell(doc);

// إلحاق عناصر المخطط التفصيلي في خلية الجدول
cell11.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.1"));
cell12.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.2"));
cell13.AppendChildLast(GetOutlineElementWithText(doc, "cell_1.3"));
// خلايا الجدول إلى صفوف
row1.AppendChildLast(cell11);
row1.AppendChildLast(cell12);
row1.AppendChildLast(cell13);

// تهيئة كائن فئة TableRow
TableRow row2 = new TableRow(doc);
// تهيئة كائنات فئة TableCell
TableCell cell21 = new TableCell(doc);
TableCell cell22 = new TableCell(doc);
TableCell cell23 = new TableCell(doc);

// إلحاق عناصر المخطط التفصيلي في خلية الجدول
cell21.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.1"));
cell22.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.2"));
cell23.AppendChildLast(GetOutlineElementWithText(doc, "cell_2.3"));

// إلحاق خلايا الجدول بالصفوف
row2.AppendChildLast(cell21);
row2.AppendChildLast(cell22);
row2.AppendChildLast(cell23);

// تهيئة كائن فئة الجدول وتعيين عرض العمود
Table table = new Table(doc)
{
    IsBordersVisible = true,
    Columns = { new TableColumn { Width = 200 }, new TableColumn { Width = 200 }, new TableColumn { Width = 200 } }
};
// إلحاق صفوف الجدول بالجدول
table.AppendChildLast(row1);
table.AppendChildLast(row2);

// تهيئة كائن المخطط التفصيلي
Outline outline = new Outline(doc);
// تهيئة كائن OutlineElement
OutlineElement outlineElem = new OutlineElement(doc);
// أضف الجدول إلى مخطط عقدة العنصر
outlineElem.AppendChildLast(table);
// أضف عنصر المخطط التفصيلي إلى مخطط تفصيلي
outline.AppendChildLast(outlineElem);
// إضافة مخطط تفصيلي إلى عقدة الصفحة
page.AppendChildLast(outline);
// أضف الصفحة إلى عقدة الوثيقة
doc.AppendChildLast(page);
dataDir = dataDir + "InsertTable_out.one";
doc.Save(dataDir);

إدراج علامات في مستند OneNote باستخدام C#

تُستخدم العلامات لتصنيف الملاحظات أو ترتيبها حسب الأولوية في مستندات OneNote. يمكنك تطبيق علامات على نص أو فقرة للعثور بسرعة على الملاحظات ذات الصلة أو تصفيتها. فيما يلي خطوات إنشاء العلامات وإضافتها في مستندات OneNote.

قم بإنشاء مثيل لفئة المستند.
قم بإنشاء صفحة جديدة باستخدام فئة الصفحة.
تهيئة كائنات OutlineElement و OutlineElement.
إنشاء كائن RichText جديد وتعيين نصه وخصائص أخرى.
أضف علامة إلى النص باستخدام طريقة RichText.Tags.Add().
إلحاق نص بالصفحة.
أضف صفحة إلى مستند OneNote واحفظه.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة علامات إلى نص في مستندات OneNote باستخدام C#.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_Tags();

// قم بإنشاء كائن من فئة المستند
Document doc = new Document();
// تهيئة كائن فئة الصفحة
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// تهيئة كائن فئة المخطط التفصيلي
Outline outline = new Outline(doc);
// تهيئة كائن فئة 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,
});

// أضف عقدة نصية
outlineElem.AppendChildLast(text);
// أضف عقدة عنصر المخطط التفصيلي
outline.AppendChildLast(outlineElem);
// أضف عقدة المخطط التفصيلي
page.AppendChildLast(outline);
// أضف عقدة الصفحة
doc.AppendChildLast(page);

dataDir = dataDir + "AddTextNodeWithTag_out.one";
// احفظ مستند OneNote
doc.Save(dataDir);

إدراج ارتباطات تشعبية في مستند OneNote باستخدام C#

أخيرًا وليس آخرًا ، دعنا نرى كيفية إدراج الارتباطات التشعبية في مستندات OneNote باستخدام الخطوات التالية.

قم بإنشاء مثيل لفئة المستند.
قم بإنشاء صفحة جديدة للمستند باستخدام فئة الصفحة.
قم بتعيين نمط نص الارتباط التشعبي وعنوان URL الخاص به باستخدام فئة TextStyle.
قم بإنشاء مثيل لفئة RichText ، وأضف نصها وقم بتهيئتها بنمط نص تم إنشاؤه مسبقًا للارتباط التشعبي.
أضف نصًا إلى صفحة مستند OneNote.
احفظ المستند كملف واحد.

يوضح نموذج التعليمات البرمجية التالي كيفية إدراج ارتباط تشعبي إلى مستند OneNote باستخدام C#.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_Tasks();

// قم بإنشاء كائن من فئة المستند
Document doc = new Document();
// تهيئة كائن فئة الصفحة
Aspose.Note.Page page = new Aspose.Note.Page(doc);
// تهيئة كائن فئة العنوان
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);
// أضف عناصر المخطط التفصيلي
outline.AppendChildLast(outlineElem);
// أضف عقدة المخطط التفصيلي
page.AppendChildLast(outline);
// أضف عقدة الصفحة
doc.AppendChildLast(page);

dataDir = dataDir + "AddHyperlink_out.one";
// احفظ مستند OneNote
doc.Save(dataDir);

استنتاج

في هذه المقالة ، تعلمت كيفية إنشاء مستندات OneNote (.ONE) من البداية باستخدام C#. علاوة على ذلك ، تناولت المقالة أيضًا كيفية إدراج الصفحات والصور والجداول والعلامات والارتباطات التشعبية إلى مستندات OneNote برمجيًا. يمكنك استكشاف الميزات الأخرى المثيرة للاهتمام في Aspose.Note for .NET باستخدام التوثيق.

إنشاء مستند OneNote (.ONE) باستخدام C##

إضافة صفحات إلى مستند OneNote باستخدام C##

إدراج الصور في مستند OneNote باستخدام C##

إضافة جداول إلى مستند OneNote باستخدام C##

إدراج علامات في مستند OneNote باستخدام C##

إدراج ارتباطات تشعبية في مستند OneNote باستخدام C##

استنتاج#

مقالات ذات صلة#