PreferredWidth

PreferredWidth class

يمثل قيمة ووحدة قياسها التي تُستخدم لتحديد العرض المفضل للجدول أو الخلية.

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

public sealed class PreferredWidth

الخصائص

اسموصف
Type { get; }يحصل على وحدة القياس المستخدمة لقيمة العرض المفضلة هذه.
Value { get; }يحصل على قيمة العرض المُفضّلة. وحدة القياس مُحدّدة فيType الملكية.

طُرق

اسموصف
static FromPercent(double)طريقة إنشاء تقوم بإرجاع مثيل جديد يمثل عرضًا مفضلًا محددًا كنسبة مئوية.
static FromPoints(double)طريقة إنشاء تقوم بإرجاع مثيل جديد يمثل عرضًا مفضلًا يتم تحديده باستخدام عدد من النقاط.
override Equals(object)يحدد ما إذا كان الكائن المحدد يساوي في القيمة الكائن الحالي.
Equals(PreferredWidth)يحدد ما إذا كان المحددPreferredWidth يساوي القيمة الحاليةPreferredWidth .
override GetHashCode()يعمل كدالة تجزئة لهذا النوع.
override ToString()يعيد سلسلة سهلة الاستخدام تعرض قيمة هذا الكائن.

مجالات

اسموصف
static readonly Autoيعيد مثيلًا يمثل قيمة “العرض المفضل غير محدد”.

ملاحظات

يمكن تحديد العرض المفضل كنسبة مئوية أو عدد من النقاط أو قيمة خاصة “لا شيء/تلقائي”.

إن حالات هذه الفئة غير قابلة للتغيير.

أمثلة

يوضح كيفية ضبط الجدول ليتناسب تلقائيًا مع 50% من عرض الصفحة.

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

Table table = builder.StartTable();
builder.InsertCell();
builder.Write("Cell #1");
builder.InsertCell();
builder.Write("Cell #2");
builder.InsertCell();
builder.Write("Cell #3");

table.PreferredWidth = PreferredWidth.FromPercent(50);

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

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

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Table table = builder.StartTable();

// هناك طريقتان لتطبيق فئة "PreferredWidth" على خلايا الجدول.
// 1 - تعيين العرض المفضل المطلق استنادًا إلى النقاط:
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPoints(40);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightYellow;
builder.Writeln($"Cell with a width of {builder.CellFormat.PreferredWidth}.");

// 2 - تعيين عرض مفضل نسبيًا استنادًا إلى النسبة المئوية لعرض الجدول:
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPercent(20);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightBlue;
builder.Writeln($"Cell with a width of {builder.CellFormat.PreferredWidth}.");

builder.InsertCell();

// ستشغل الخلية التي ليس لها عرض مفضل محدد بقية المساحة المتوفرة.
builder.CellFormat.PreferredWidth = PreferredWidth.Auto;

// يؤدي كل تكوين لخاصية "PreferredWidth" إلى إنشاء كائن جديد.
Assert.AreNotEqual(table.FirstRow.Cells[1].CellFormat.PreferredWidth.GetHashCode(),
    builder.CellFormat.PreferredWidth.GetHashCode());

builder.CellFormat.Shading.BackgroundPatternColor = Color.LightGreen;
builder.Writeln("Automatically sized cell.");

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

أنظر أيضا

CellVerticalAlignment Enum PreferredWidthType Enum