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");

أنظر أيضا