CellFormat

CellFormat class

يمثل كافة التنسيقات لخلية الجدول.

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

public class CellFormat

الخصائص

اسموصف
Borders { get; }يحصل على مجموعة من حدود الخلية.
BottomPadding { get; set; }يقوم بإرجاع أو تعيين مقدار المساحة (بالنقاط) التي يجب إضافتها أسفل محتويات الخلية.
FitText { get; set; }إذاحقيقي ، يلائم النص في الخلية، ويضغط كل فقرة على عرض الخلية.
HideMark { get; set; }يعيد أو يحدد إمكانية رؤية علامة الخلية.
HorizontalMerge { get; set; }يحدد كيفية دمج الخلية أفقيًا مع الخلايا الأخرى في الصف.
LeftPadding { get; set; }يقوم بإرجاع أو تعيين مقدار المساحة (بالنقاط) التي يجب إضافتها إلى يسار محتويات الخلية.
Orientation { get; set; }إرجاع أو تعيين اتجاه النص في خلية الجدول.
PreferredWidth { get; set; }يعيد أو يعين العرض المفضل للخلية.
RightPadding { get; set; }يقوم بإرجاع أو تعيين مقدار المساحة (بالنقاط) التي يجب إضافتها إلى يمين محتويات الخلية.
Shading { get; }يعيدShading الكائن الذي يشير إلى تنسيق التظليل للخلية.
TopPadding { get; set; }يقوم بإرجاع أو تعيين مقدار المساحة (بالنقاط) المراد إضافتها فوق محتويات الخلية.
VerticalAlignment { get; set; }يعيد أو يضبط المحاذاة الرأسية للنص في الخلية.
VerticalMerge { get; set; }يحدد كيفية دمج الخلية مع الخلايا الأخرى عموديًا.
Width { get; set; }يحصل على عرض الخلية بالنقاط.
WrapText { get; set; }إذاحقيقي , التفاف النص للخلية.

طُرق

اسموصف
ClearFormatting()يُعيد ضبط تنسيق الخلية الافتراضي. لا يُغيّر عرض الخلية.
SetPaddings(double, double, double, double)يحدد مقدار المساحة (بالنقاط) التي يجب إضافتها إلى اليسار/الأعلى/اليمين/الأسفل من محتويات الخلية.

أمثلة

يوضح كيفية تعديل تنسيق خلية الجدول.

Document doc = new Document(MyDir + "Tables.docx");
Table table = doc.FirstSection.Body.Tables[0];
Cell firstCell = table.FirstRow.FirstCell;

// استخدم خاصية "CellFormat" الخاصة بالخلية لتعيين التنسيق الذي يعدل مظهر تلك الخلية.
firstCell.CellFormat.Width = 30;
firstCell.CellFormat.Orientation = TextOrientation.Downward;
firstCell.CellFormat.Shading.ForegroundPatternColor = Color.LightGreen;

doc.Save(ArtifactsDir + "Table.CellFormat.docx");

يوضح كيفية تعديل تنسيق الصفوف والخلايا في جدول.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Table table = builder.StartTable();
builder.InsertCell();
builder.Write("City");
builder.InsertCell();
builder.Write("Country");
builder.EndRow();
builder.InsertCell();
builder.Write("London");
builder.InsertCell();
builder.Write("U.K.");
builder.EndTable();

// استخدم خاصية "RowFormat" في الصف الأول لتعديل التنسيق
// من محتويات جميع الخلايا في هذا الصف.
RowFormat rowFormat = table.FirstRow.RowFormat;
rowFormat.Height = 25;
rowFormat.Borders[BorderType.Bottom].Color = Color.Red;

//استخدم خاصية "CellFormat" الخاصة بالخلية الأولى في الصف الأخير لتعديل تنسيق محتويات تلك الخلية.
CellFormat cellFormat = table.LastRow.FirstCell.CellFormat;
cellFormat.Width = 100;
cellFormat.Shading.BackgroundPatternColor = Color.Orange;

doc.Save(ArtifactsDir + "Table.RowCellFormat.docx");

يوضح كيفية إنشاء جدول بحدود مخصصة.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.StartTable();

//إعداد خيارات تنسيق الجدول لمنشئ المستندات
// سيتم تطبيقها على كل صف وخلية نضيفها معها.
builder.ParagraphFormat.Alignment = ParagraphAlignment.Center;

builder.CellFormat.ClearFormatting();
builder.CellFormat.Width = 150;
builder.CellFormat.VerticalAlignment = CellVerticalAlignment.Center;
builder.CellFormat.Shading.BackgroundPatternColor = Color.GreenYellow;
builder.CellFormat.WrapText = false;
builder.CellFormat.FitText = true;

builder.RowFormat.ClearFormatting();
builder.RowFormat.HeightRule = HeightRule.Exactly;
builder.RowFormat.Height = 50;
builder.RowFormat.Borders.LineStyle = LineStyle.Engrave3D;
builder.RowFormat.Borders.Color = Color.Orange;

builder.InsertCell();
builder.Write("Row 1, Col 1");

builder.InsertCell();
builder.Write("Row 1, Col 2");
builder.EndRow();

// سيؤدي تغيير التنسيق إلى تطبيقه على الخلية الحالية،
//وأي خلايا جديدة نقوم بإنشائها باستخدام المنشئ بعد ذلك.
// لن يؤثر هذا على الخلايا التي أضفناها مسبقًا.
builder.CellFormat.Shading.ClearFormatting();

builder.InsertCell();
builder.Write("Row 2, Col 1");

builder.InsertCell();
builder.Write("Row 2, Col 2");

builder.EndRow();

// زيادة ارتفاع الصف ليتناسب مع النص الرأسي.
builder.InsertCell();
builder.RowFormat.Height = 150;
builder.CellFormat.Orientation = TextOrientation.Upward;
builder.Write("Row 3, Col 1");

builder.InsertCell();
builder.CellFormat.Orientation = TextOrientation.Downward;
builder.Write("Row 3, Col 2");

builder.EndRow();
builder.EndTable();

doc.Save(ArtifactsDir + "DocumentBuilder.InsertTable.docx");

أنظر أيضا

CellCollection Class CellMerge Enum