الفئة Image

Image class

يمثل صورة.

public sealed class Image : CompositeNode<Loop>, IOutlineElementChildNode, IPageChildNode, ITaggable

المُنشئات

الاسمالوصف
Image()يُنشئ مثيلاً جديدًا للفئة Image.
Image(string)يُنشئ مثيلاً جديدًا للفئة Image.
Image(string, Stream)يُنشئ مثيلاً جديدًا للفئة Image.
Image(string, string, string)يُنشئ مثيلاً جديدًا للفئة Image.

الخصائص

الاسمالوصف
Alignment { get; set; }يحصل أو يعيّن المحاذاة.
AlternativeTextDescription { get; set; }يحصل أو يعيّن نصًا بديلًا للجسم للصورة.
AlternativeTextTitle { get; set; }يحصل أو يعيّن عنوان النص البديل للصورة.
Bytes { get; }يحصل على مخزن بيانات الصورة.
Document { get; }يحصل على مستند العقدة.
FileName { get; }يحصل على اسم الملف.
FilePath { get; }يحصل على المسار إلى ملف الصورة.
FirstChild { get; }
Format { get; }يحصل على تنسيق الصورة.
Height { get; set; }يحصل أو يعيّن الارتفاع. هذا هو الارتفاع الحقيقي للصورة في مستند MS OneNote.
HorizontalOffset { get; set; }يحصل أو يعيّن الإزاحة الأفقية.
HyperlinkUrl { get; set; }يحصل أو يعيّن الرابط التشعبي المرتبط بالصورة.
IsBackground { get; set; }يحصل على ما إذا كانت الصورة صورة خلفية.
IsComposite { get; }
LastChild { get; }
LastModifiedTime { get; set; }يحصل أو يعيّن وقت التعديل الأخير.
NextSibling { get; }يحصل على العقدة التالية في نفس مستوى شجرة العقد.
NodeType { get; }يحصل على نوع العقدة.
OriginalHeight { get; }يحصل على الارتفاع الأصلي. هذا هو العرض الأصلي للصورة، قبل إعادة التحجيم.
OriginalWidth { get; }يحصل على العرض الأصلي. هذا هو العرض الأصلي للصورة، قبل إعادة التحجيم.
ParentNode { get; }يحصل على العقدة الأصلية.
PreviousSibling { get; }يحصل على العقدة السابقة في نفس مستوى شجرة العقد.
Tags { get; }يحصل على قائمة جميع العلامات في الفقرة.
VerticalOffset { get; set; }يحصل أو يضبط الإزاحة العمودية.
Width { get; set; }يحصل أو يعيّن العرض. هذا هو العرض الحقيقي للصورة في مستند MS OneNote.

الطرق

الاسمالوصف
override Accept(DocumentVisitor)يقبل زائر العقدة.
virtual AppendChildFirst<T1>(T1)
virtual AppendChildLast<T1>(T1)
override GetChildNodes<T1>()
GetEnumerator()
virtual InsertChild<T1>(int, T1)
InsertChildrenRange(int, IEnumerable<Loop>)
InsertChildrenRange(int, params Loop[])
RemoveChild<T1>(T1)
Replace(Image)يستبدل بيانات الصورة الحالية بالبيانات من كائن Image المقدم.

أمثلة

يعرض كيفية ربط ارتباط تشعبي بصورة.

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

var document = new Document();

var page = new Page();

var image = new Image(dataDir + "image.jpg") { HyperlinkUrl = "https://image.com" };

page.AppendChildLast(image);

document.AppendChildLast(page);

document.Save(dataDir + "Image with Hyperlink_out.one");

يظهر كيفية تعيين وصف نصي لصورة.

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

var document = new Document();
var page = new Page();
var image = new Image(dataDir + "image.jpg")
            {
                AlternativeTextTitle = "This is an image's title!",
                AlternativeTextDescription = "And this is an image's description!"
            };
page.AppendChildLast(image);
document.AppendChildLast(page);

dataDir = dataDir + "ImageAlternativeText_out.one";
document.Save(dataDir);

يظهر كيفية الحصول على صورة من مستند.

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

// حمّل المستند إلى Aspose.Note.
Document oneFile = new Document(dataDir + "Aspose.one");

// الحصول على جميع عقد Image
IList<Aspose.Note.Image> nodes = oneFile.GetChildNodes<Aspose.Note.Image>();

foreach (Aspose.Note.Image image in nodes)
{
    using (MemoryStream stream = new MemoryStream(image.Bytes))
    {
        using (Bitmap bitMap = new Bitmap(stream))
        {
            // حفظ بايتات الصورة إلى ملف
            bitMap.Save(String.Format(dataDir + "{0}", Path.GetFileName(image.FileName)));
        }
    }
}

يظهر كيفية الحصول على معلومات ميتا للصورة.

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

// حمّل المستند إلى Aspose.Note.
Document oneFile = new Document(dataDir + "Aspose.one");

// الحصول على جميع عقد Image
IList<Aspose.Note.Image> images = oneFile.GetChildNodes<Aspose.Note.Image>();

foreach (Aspose.Note.Image image in images)
{
    Console.WriteLine("Width: {0}", image.Width);
    Console.WriteLine("Height: {0}", image.Height);
    Console.WriteLine("OriginalWidth: {0}", image.OriginalWidth);
    Console.WriteLine("OriginalHeight: {0}", image.OriginalHeight);
    Console.WriteLine("FileName: {0}", image.FileName);
    Console.WriteLine("LastModifiedTime: {0}", image.LastModifiedTime);
    Console.WriteLine();
}

يعرض كيفية إضافة صورة جديدة مع علامة.

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

// إنشاء كائن من فئة Document
Document doc = new Document();

// تهيئة كائن فئة Page
Page page = new Page();

// تهيئة كائن فئة Outline
Outline outline = new Outline();

// تهيئة كائن فئة OutlineElement
OutlineElement outlineElem = new OutlineElement();

// تحميل صورة.
Image image = new Image(dataDir + "icon.jpg");

// إدراج صورة في عقدة المستند.
outlineElem.AppendChildLast(image);
image.Tags.Add(NoteTag.CreateYellowStar());

// إضافة عقدة عنصر المخطط
outline.AppendChildLast(outlineElem);

// إضافة عقدة المخطط
page.AppendChildLast(outline);

// إضافة عقدة صفحة
doc.AppendChildLast(page);

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

يظهر كيفية إضافة صورة من ملف إلى مستند مع خصائص محددة من قبل المستخدم.

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

// تحميل المستند من الدفق.
Document doc = new Document(dataDir + "Aspose.one");

// احصل على الصفحة الأولى من المستند.
Page page = doc.FirstChild;

// تحميل صورة من الملف.
Image image = new Image(dataDir + "image.jpg")
                          {
                              // غيّر حجم الصورة وفقًا لاحتياجاتك (اختياري).
                              Width = 100,
                              Height = 100,

                              // حدد موقع الصورة في الصفحة (اختياري).
                              HorizontalOffset = 100,
                              VerticalOffset = 400,

                              // ضبط محاذاة الصورة
                              Alignment = HorizontalAlignment.Right
                          };

// أضف الصورة إلى الصفحة.
page.AppendChildLast(image);

يظهر كيفية إضافة صورة من الدفق إلى مستند.

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

// إنشاء كائن من فئة Document
Document doc = new Document();

// تهيئة كائن فئة Page
Page page = new Page();

Outline outline1 = new Outline();
OutlineElement outlineElem1 = new OutlineElement();

using (FileStream fs = File.OpenRead(dataDir + "image.jpg"))
{

    // تحميل الصورة الثانية باستخدام اسم الصورة، الامتداد، والدفق.
    Image image1 = new Image("Penguins.jpg", fs)
                                   {
                                       // ضبط محاذاة الصورة
                                       Alignment = HorizontalAlignment.Right
                                   };

    outlineElem1.AppendChildLast(image1);
}

outline1.AppendChildLast(outlineElem1);
page.AppendChildLast(outline1);

doc.AppendChildLast(page);

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

يظهر كيفية إضافة صورة من ملف إلى مستند.

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

// إنشاء كائن من فئة Document
Document doc = new Document();

// تهيئة كائن فئة Page
Page page = new Page();

// تهيئة كائن فئة Outline وتعيين خصائص الإزاحة
Outline outline = new Outline();

// تهيئة كائن فئة OutlineElement
OutlineElement outlineElem = new OutlineElement();

// تحميل صورة عبر مسار الملف.
Image image = new Image(dataDir + "image.jpg")
                          {
                              // ضبط محاذاة الصورة
                              Alignment = HorizontalAlignment.Right
                          };

// إضافة صورة
outlineElem.AppendChildLast(image);

// إضافة عناصر المخطط
outline.AppendChildLast(outlineElem);

// إضافة عقدة المخطط
page.AppendChildLast(outline);

// إضافة عقدة الصفحة
doc.AppendChildLast(page);

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

انظر أيضًا

الواجهة ITaggable الفئة IncorrectDocumentStructureException