OneNote امکان جمعآوری، سازماندهی و همکاری اطلاعات رایگان و همکاری چند کاربره را در قالب یادداشتها، نقاشیها، بریدههای صفحه و تفسیرهای صوتی فراهم میکند. ما می توانیم تصاویر را به صورت برنامه ریزی شده در اسناد OneNote قرار دهیم. در این مقاله نحوه افزودن تصویر به OneNote در سی شارپ را خواهیم آموخت.
موضوعات زیر در این مقاله پوشش داده خواهد شد:
- C# API برای افزودن تصاویر به OneNote
- افزودن تصویر به یک سند جدید OneNote
- درج تصویر در یک سند OneNote موجود
- افزودن تصویر با متن جایگزین
C# API برای افزودن تصاویر به OneNote
برای افزودن یک تصویر به یک سند OneNote جدید یا موجود، از Aspose.Note for .NET API استفاده خواهیم کرد. API امکان ایجاد، خواندن و تبدیل اسناد OneNote را به صورت برنامهنویسی بدون استفاده از Microsoft OneNote میدهد. همچنین اجازه می دهد تا محتوا را از اسناد PDF به اسناد OneNote وارد کنید.
لطفاً یا DLL API را دانلود کنید یا با استفاده از NuGet آن را نصب کنید.
PM> Install-Package Aspose.Note
افزودن تصویر به سند جدید OneNote در سی شارپ
با دنبال کردن مراحل زیر میتوانیم یک سند OneNote جدید ایجاد کنیم و یک تصویر درج کنیم:
- ابتدا یک نمونه از کلاس Document ایجاد کنید.
- سپس شی کلاس Page را مقداردهی اولیه کنید.
- سپس، یک تصویر را با استفاده از کلاس Image بارگذاری کنید.
- به صورت اختیاری، ارتفاع، عرض، تراز، افست و غیره تصویر را تنظیم کنید.
- پس از آن، تصویر را با استفاده از متد ()ApendChildLast به صفحه اضافه کنید.
- به طور مشابه، صفحه را به سند اضافه کنید.
- در نهایت متد Save() را برای ذخیره سند OneNote فراخوانی کنید.
نمونه کد زیر نحوه افزودن تصویر به سند جدید OneNote را با استفاده از C# نشان می دهد.
// این نمونه کد نحوه افزودن یک تصویر به سند جدید OneNote را نشان می دهد.
// مسیر دایرکتوری اسناد
string dataDir = "C:\\Files\\Note\\";
// یک شی از کلاس Document ایجاد کنید
Document doc = new Document();
// شیء کلاس Page را مقدار دهی اولیه کنید
Page page = new Page();
// یک تصویر را در مسیر فایل بارگیری کنید.
Image image = new Image(dataDir + "sample.jpg");
// تنظیم تراز تصویر
image.Alignment = HorizontalAlignment.Right;
// تصویر اضافه کن
page.AppendChildLast(image);
// اضافه کردن گره صفحه
doc.AppendChildLast(page);
// سند OneNote را ذخیره کنید
dataDir = dataDir + "CreateOneNoteWithImage.one";
doc.Save(dataDir);
افزودن تصویر به سند OneNote موجود در سی شارپ
همچنین میتوانیم با دنبال کردن مراحل زیر، یک تصویر را در یک سند OneNote موجود وارد کنیم:
- ابتدا یک OneNote موجود را با استفاده از کلاس Document بارگیری کنید.
- سپس شی کلاس Page را مقداردهی اولیه کنید.
- سپس، یک تصویر را با استفاده از کلاس Image بارگذاری کنید.
- به صورت اختیاری، ارتفاع، عرض، تراز، افست و غیره تصویر را تنظیم کنید.
- پس از آن، تصویر را با استفاده از متد ()ApendChildLast به صفحه اضافه کنید.
- به طور مشابه، صفحه را به سند اضافه کنید.
- در نهایت متد Save() را برای ذخیره سند OneNote فراخوانی کنید.
نمونه کد زیر نحوه افزودن یک تصویر به یک سند OneNote موجود با استفاده از C# را نشان می دهد.
// این نمونه کد نحوه افزودن یک تصویر به سند موجود OneNote را نشان می دهد.
// مسیر دایرکتوری اسناد
string dataDir = "C:\\Files\\Note\\";
// سند را از جریان بارگیری کنید.
Document doc = new Document(dataDir + "Sample1.one");
// یک صفحه جدید اضافه کنید.
Page page = new Page();
// یک تصویر از فایل بارگیری کنید.
Image image = new Image(dataDir + "sample.jpg");
// اندازه تصویر را با توجه به نیاز خود تغییر دهید (اختیاری).
image.Width = 500;
image.Height = 750;
// مکان تصویر را در صفحه تنظیم کنید (اختیاری).
image.VerticalOffset = 400;
image.HorizontalOffset = 100;
// تنظیم تراز تصویر
image.Alignment = HorizontalAlignment.Right;
// تصویر را به صفحه اضافه کنید.
page.AppendChildLast(image);
doc.AppendChildLast(page);
// سند OneNote را ذخیره کنید
dataDir = dataDir + "InsertImageIntoExisting.one";
doc.Save(dataDir);
درج تصویر با متن جایگزین در OneNote با استفاده از C#
با دنبال کردن مراحل زیر میتوانیم متن جایگزین تصویر را هنگام درج آن در سند OneNote اضافه کنیم:
- ابتدا یک نمونه از کلاس Document ایجاد کنید.
- سپس شی کلاس Page را مقداردهی اولیه کنید.
- سپس، یک تصویر را با استفاده از کلاس Image بارگذاری کنید.
- سپس ویژگی های AlternativeTextTitle و AlternativeTextDescription را مشخص کنید.
- پس از آن، تصویر را با استفاده از متد ()ApendChildLast به صفحه اضافه کنید.
- به طور مشابه، صفحه را به سند اضافه کنید.
- در نهایت متد Save() را برای ذخیره سند OneNote فراخوانی کنید.
نمونه کد زیر نحوه درج یک تصویر با متن جایگزین در OneNote با استفاده از C# را نشان می دهد.
// این نمونه کد نحوه افزودن تصویر با متن جایگزین را در سند OneNote نشان می دهد.
// مسیر دایرکتوری اسناد
string dataDir = "C:\\Files\\Note\\";
// یک سند جدید ایجاد کنید
var document = new Document();
// یک صفحه جدید اضافه کنید
var page = new Page();
// یک تصویر بارگیری کنید
var image = new Image(dataDir + "sample.jpg");
// متن و توضیحات جایگزین تصویر را مشخص کنید
image.AlternativeTextTitle = "This is an image's title!";
image.AlternativeTextDescription = "And this is an image's description!";
// یک تصویر اضافه کنید
page.AppendChildLast(image);
// صفحه را اضافه کنید
document.AppendChildLast(page);
// سند را ذخیره کنید
dataDir = dataDir + "ImageAlternativeText.one";
document.Save(dataDir);
مجوز رایگان دریافت کنید
برای امتحان کتابخانه بدون محدودیت ارزیابی، می توانید [یک مجوز موقت رایگان دریافت کنید].
نتیجه
در این مقاله یاد گرفتیم که چگونه:
- یک سند OneNote جدید با استفاده از C# ایجاد کنید.
- یک سند OneNote موجود را بارگیری کنید.
- یک صفحه به سند OneNote اضافه کنید.
- اضافه کردن یک تصویر به صفحه سند OneNote از طریق برنامه ریزی؛
علاوه بر افزودن تصویر به OneNote در سی شارپ، میتوانید با استفاده از مستندات درباره Aspose.Note برای API .NET اطلاعات بیشتری کسب کنید. در صورت وجود هرگونه ابهام، لطفاً با ما در [تالار گفتمان پشتیبانی رایگان11 تماس بگیرید.