Class Comment

Class Comment

Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)

يحتوي على الكائن الذي يمثل تعليق الخلية.

public class Comment

الوراثة

objectComment

الأعضاء الموروثة

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

أمثلة

Workbook workbook = new Workbook();
CommentCollection comments = workbook.Worksheets[0].Comments;

//إضافة تعليق إلى الخلية A1
int commentIndex1 = comments.Add(0, 0);
Comment comment1 = comments[commentIndex1];
comment1.Note = "الملاحظة الأولى.";
comment1.Font.Name = "Times New Roman";

//إضافة تعليق إلى الخلية B2
comments.Add("B2");
Comment comment2 = comments["B2"];
comment2.Note = "الملاحظة الثانية.";

//قم بأعمالك

//حفظ ملف الإكسل.
workbook.Save("exmaple.xlsx");
Dim workbook as Workbook = new Workbook()
Dim comments as CommentCollection = workbook.Worksheets(0).Comments

'إضافة تعليق إلى الخلية A1
Dim commentIndex1 as Integer = comments.Add(0, 0)
Dim comment1 as Comment = comments(commentIndex1)
comment1.Note = "الملاحظة الأولى."
comment1.Font.Name = "Times New Roman"

'إضافة تعليق إلى الخلية B2
comments.Add("B2")
Dim comment2 As Comment = comments("B2")
comment2.Note = "الملاحظة الثانية."

الخصائص

المؤلف

يحصل على اسم مؤلف التعليق الأصلي ويقوم بتعيينه.

public string Author { get; set; }

قيمة الخاصية

string

أمثلة

comment1.Author = "Carl.Yang";

الحجم التلقائي

تشير إلى ما إذا كان حجم التعليق يتم ضبطه تلقائيًا وفقًا لمحتواه.

public bool AutoSize { get; set; }

قيمة الخاصية

bool

أمثلة

if(!comment1.AutoSize)
{
    //حجم التعليق يتغير مع المحتوى
    comment1.AutoSize = true;
}

العمود

يحصل على فهرس العمود للتعليق.

public int Column { get; }

قيمة الخاصية

int

أمثلة

int column = comment1.Column;

شكل التعليق

يحصل على كائن شكل يمثل الشكل المرتبط بالتعليق المحدد.

public CommentShape CommentShape { get; }

قيمة الخاصية

CommentShape

أمثلة

CommentShape shape = comment1.CommentShape;
int w = shape.Width;
int h = shape.Height;

الخط

يحصل على خط التعليق.

public Font Font { get; }

قيمة الخاصية

Font

أمثلة

Aspose.Cells.Font font = comment1.Font;
font.Size = 12;

الارتفاع

يمثل ارتفاع التعليق، بوحدات البكسل.

public int Height { get; set; }

قيمة الخاصية

int

أمثلة

comment1.Height = 10;

ارتفاع السنتيمتر

يمثل ارتفاع التعليق، بوحدات السنتيمتر.

public double HeightCM { get; set; }

قيمة الخاصية

double

أمثلة

comment1.HeightCM = 1.0;

ارتفاع البوصة

يمثل ارتفاع التعليق، بوحدات البوصة.

public double HeightInch { get; set; }

قيمة الخاصية

double

أمثلة

comment1.HeightInch = 1.0;

ملاحظة HTML

يحصل على سلسلة HTML التي تحتوي على بيانات وبعض التنسيقات في هذا التعليق ويقوم بتعيينها.

public string HtmlNote { get; set; }

قيمة الخاصية

string

أمثلة

comment1.HtmlNote = "<Font Style='FONT-FAMILY: Calibri;FONT-SIZE: 11pt;COLOR: #0000ff;TEXT-ALIGN: left;'>هذا هو <b>اختبار</b>.</Font>";

ملاحظات

إذا كان هذا تعليقًا متسلسلًا، فلا يمكن تغيير الملاحظة، وإلا فلن تتمكن MS Excel من معالجته كتعليق متسلسل.

هل هو تعليق متسلسل

تشير إلى ما إذا كان هذا التعليق تعليقًا متسلسلًا.

public bool IsThreadedComment { get; }

قيمة الخاصية

bool

أمثلة

if(comment1.IsThreadedComment)
{
    //هذا التعليق هو تعليق متسلسل.
}

هل هو مرئي

يمثل ما إذا كان التعليق مرئيًا أم لا.

public bool IsVisible { get; set; }

قيمة الخاصية

bool

أمثلة

if(comment1.IsVisible)
{
    //التعليق مرئي
}

الملاحظة

يمثل محتوى التعليق.

public string Note { get; set; }

قيمة الخاصية

string

أمثلة

comment1.Note = "الملاحظة الأولى.";

ملاحظات

إذا كان هذا تعليقًا متسلسلًا، فلا يمكن تغيير الملاحظة، وإلا فلن تتمكن MS Excel من معالجته كتعليق متسلسل.

الصف

يحصل على فهرس الصف للتعليق.

public int Row { get; }

قيمة الخاصية

int

أمثلة

int row = comment1.Row;

محاذاة النص الأفقية

يحصل على نوع محاذاة النص الأفقية للتعليق ويقوم بتعيينه.

public TextAlignmentType TextHorizontalAlignment { get; set; }

قيمة الخاصية

TextAlignmentType

أمثلة

if (comment1.TextHorizontalAlignment ==  TextAlignmentType.Fill)
{
    comment1.TextHorizontalAlignment = TextAlignmentType.Center;
}

نوع توجيه النص

يحصل على نوع توجيه النص للتعليق ويقوم بتعيينه.

public TextOrientationType TextOrientationType { get; set; }

قيمة الخاصية

TextOrientationType

أمثلة

if(comment1.TextOrientationType == TextOrientationType.NoRotation)
{
    comment1.TextOrientationType = TextOrientationType.TopToBottom;
}

محاذاة النص الرأسية

يحصل على نوع محاذاة النص الرأسية للتعليق ويقوم بتعيينه.

public TextAlignmentType TextVerticalAlignment { get; set; }

قيمة الخاصية

TextAlignmentType

أمثلة

if (comment1.TextVerticalAlignment ==  TextAlignmentType.Fill)
{
    comment1.TextVerticalAlignment = TextAlignmentType.Center;
}

التعليقات المتسلسلة

يحصل على قائمة التعليقات المتسلسلة.

public ThreadedCommentCollection ThreadedComments { get; }

قيمة الخاصية

ThreadedCommentCollection

أمثلة

ThreadedCommentCollection threadedComments = comment1.ThreadedComments;
for (int i = 0; i < threadedComments.Count; ++i)
{
    ThreadedComment tc = threadedComments[i];
    string note = tc.Notes;
}

العرض

يمثل عرض التعليق، بوحدات البكسل.

public int Width { get; set; }

قيمة الخاصية

int

أمثلة

comment1.Width = 10;

عرض السنتيمتر

يمثل عرض التعليق، بوحدات السنتيمتر.

public double WidthCM { get; set; }

قيمة الخاصية

double

أمثلة

comment1.WidthCM = 1.0;

عرض البوصة

يمثل عرض التعليق، بوحدات البوصة.

public double WidthInch { get; set; }

قيمة الخاصية

double

أمثلة

comment1.WidthInch = 1.0;

الطرق

Characters(int, int)

ترجع كائن Characters الذي يمثل مجموعة من الأحرف داخل نص التعليق.

public FontSetting Characters(int startIndex, int length)

المعلمات

startIndex int

فهرس بداية الحرف.

length int

عدد الأحرف.

القيمة المعادة

FontSetting

كائن Characters.

أمثلة

Aspose.Cells.FontSetting fontSetting = comment1.Characters(0, 4);

FormatCharacters(int, int, Font, StyleFlag)

قم بتنسيق بعض الأحرف مع إعداد الخط.

public void FormatCharacters(int startIndex, int length, Font font, StyleFlag flag)

المعلمات

startIndex int

فهرس البداية.

length int

الطول.

font Font

إعداد الخط.

flag StyleFlag

علم إعداد الخط.

GetRichFormattings()

ترجع جميع كائنات Characters التي تمثل مجموعة من الأحرف داخل نص التعليق.

public FontSetting[] GetRichFormattings()

القيمة المعادة

FontSetting[]

جميع كائنات Characters.

أمثلة

FontSetting[] list = comment1.GetRichFormattings();
 عربي