Class Comment
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
يحتوي على الكائن الذي يمثل تعليق الخلية.
public class Comment
الوراثة
الأعضاء الموروثة
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; }
قيمة الخاصية
أمثلة
comment1.Author = "Carl.Yang";
الحجم التلقائي
تشير إلى ما إذا كان حجم التعليق يتم ضبطه تلقائيًا وفقًا لمحتواه.
public bool AutoSize { get; set; }
قيمة الخاصية
أمثلة
if(!comment1.AutoSize)
{
//حجم التعليق يتغير مع المحتوى
comment1.AutoSize = true;
}
العمود
يحصل على فهرس العمود للتعليق.
public int Column { get; }
قيمة الخاصية
أمثلة
int column = comment1.Column;
شكل التعليق
يحصل على كائن شكل يمثل الشكل المرتبط بالتعليق المحدد.
public CommentShape CommentShape { get; }
قيمة الخاصية
أمثلة
CommentShape shape = comment1.CommentShape;
int w = shape.Width;
int h = shape.Height;
الخط
يحصل على خط التعليق.
public Font Font { get; }
قيمة الخاصية
أمثلة
Aspose.Cells.Font font = comment1.Font;
font.Size = 12;
الارتفاع
يمثل ارتفاع التعليق، بوحدات البكسل.
public int Height { get; set; }
قيمة الخاصية
أمثلة
comment1.Height = 10;
ارتفاع السنتيمتر
يمثل ارتفاع التعليق، بوحدات السنتيمتر.
public double HeightCM { get; set; }
قيمة الخاصية
أمثلة
comment1.HeightCM = 1.0;
ارتفاع البوصة
يمثل ارتفاع التعليق، بوحدات البوصة.
public double HeightInch { get; set; }
قيمة الخاصية
أمثلة
comment1.HeightInch = 1.0;
ملاحظة HTML
يحصل على سلسلة HTML التي تحتوي على بيانات وبعض التنسيقات في هذا التعليق ويقوم بتعيينها.
public string HtmlNote { get; set; }
قيمة الخاصية
أمثلة
comment1.HtmlNote = "<Font Style='FONT-FAMILY: Calibri;FONT-SIZE: 11pt;COLOR: #0000ff;TEXT-ALIGN: left;'>هذا هو <b>اختبار</b>.</Font>";
ملاحظات
إذا كان هذا تعليقًا متسلسلًا، فلا يمكن تغيير الملاحظة، وإلا فلن تتمكن MS Excel من معالجته كتعليق متسلسل.
هل هو تعليق متسلسل
تشير إلى ما إذا كان هذا التعليق تعليقًا متسلسلًا.
public bool IsThreadedComment { get; }
قيمة الخاصية
أمثلة
if(comment1.IsThreadedComment)
{
//هذا التعليق هو تعليق متسلسل.
}
هل هو مرئي
يمثل ما إذا كان التعليق مرئيًا أم لا.
public bool IsVisible { get; set; }
قيمة الخاصية
أمثلة
if(comment1.IsVisible)
{
//التعليق مرئي
}
الملاحظة
يمثل محتوى التعليق.
public string Note { get; set; }
قيمة الخاصية
أمثلة
comment1.Note = "الملاحظة الأولى.";
ملاحظات
إذا كان هذا تعليقًا متسلسلًا، فلا يمكن تغيير الملاحظة، وإلا فلن تتمكن MS Excel من معالجته كتعليق متسلسل.
الصف
يحصل على فهرس الصف للتعليق.
public int Row { get; }
قيمة الخاصية
أمثلة
int row = comment1.Row;
محاذاة النص الأفقية
يحصل على نوع محاذاة النص الأفقية للتعليق ويقوم بتعيينه.
public TextAlignmentType TextHorizontalAlignment { get; set; }
قيمة الخاصية
أمثلة
if (comment1.TextHorizontalAlignment == TextAlignmentType.Fill)
{
comment1.TextHorizontalAlignment = TextAlignmentType.Center;
}
نوع توجيه النص
يحصل على نوع توجيه النص للتعليق ويقوم بتعيينه.
public TextOrientationType TextOrientationType { get; set; }
قيمة الخاصية
أمثلة
if(comment1.TextOrientationType == TextOrientationType.NoRotation)
{
comment1.TextOrientationType = TextOrientationType.TopToBottom;
}
محاذاة النص الرأسية
يحصل على نوع محاذاة النص الرأسية للتعليق ويقوم بتعيينه.
public TextAlignmentType TextVerticalAlignment { get; set; }
قيمة الخاصية
أمثلة
if (comment1.TextVerticalAlignment == TextAlignmentType.Fill)
{
comment1.TextVerticalAlignment = TextAlignmentType.Center;
}
التعليقات المتسلسلة
يحصل على قائمة التعليقات المتسلسلة.
public ThreadedCommentCollection ThreadedComments { get; }
قيمة الخاصية
أمثلة
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; }
قيمة الخاصية
أمثلة
comment1.Width = 10;
عرض السنتيمتر
يمثل عرض التعليق، بوحدات السنتيمتر.
public double WidthCM { get; set; }
قيمة الخاصية
أمثلة
comment1.WidthCM = 1.0;
عرض البوصة
يمثل عرض التعليق، بوحدات البوصة.
public double WidthInch { get; set; }
قيمة الخاصية
أمثلة
comment1.WidthInch = 1.0;
الطرق
Characters(int, int)
ترجع كائن Characters الذي يمثل مجموعة من الأحرف داخل نص التعليق.
public FontSetting Characters(int startIndex, int length)
المعلمات
startIndex
int
فهرس بداية الحرف.
length
int
عدد الأحرف.
القيمة المعادة
كائن 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()
القيمة المعادة
جميع كائنات Characters.
أمثلة
FontSetting[] list = comment1.GetRichFormattings();