Style

Style class

يمثل نمطًا واحدًا مدمجًا أو محددًا من قبل المستخدم.

لمعرفة المزيد، قم بزيارةالعمل مع الأنماط والموضوعات مقالة توثيقية.

public class Style

الخصائص

اسموصف
Aliases { get; }يحصل على كافة الأسماء المستعارة لهذا النمط. إذا لم يكن النمط يحتوي على أسماء مستعارة، فسيتم إرجاع مجموعة فارغة من السلسلة.
AutomaticallyUpdate { get; set; }يحدد ما إذا كان سيتم إعادة تعريف هذا النمط تلقائيًا بناءً على القيمة المناسبة.
BaseStyleName { get; set; }الحصول على/تعيين اسم النمط الذي يعتمد عليه هذا النمط.
BuiltIn { get; }صحيح إذا كان هذا النمط أحد الأنماط المضمنة في برنامج MS Word.
Document { get; }الحصول على مستند المالك.
Font { get; }الحصول على تنسيق الأحرف للنمط.
IsHeading { get; }صحيح عندما يكون النمط أحد أنماط العناوين المضمنة.
IsQuickStyle { get; set; }يحدد ما إذا كان سيتم عرض هذا النمط في معرض “الأنماط السريعة” داخل واجهة مستخدم MS Word.
LinkedStyleName { get; }يحصل على اسمStyle مرتبطة بهذا. إرجاع سلسلة فارغة إذا لم يتم ربط أي أنماط.
List { get; }الحصول على القائمة التي تحدد تنسيق نمط القائمة هذا.
ListFormat { get; }يوفر الوصول إلى خصائص تنسيق القائمة لنمط الفقرة.
Name { get; set; }الحصول على اسم النمط أو تعيينه.
NextParagraphStyleName { get; set; }الحصول على/تعيين اسم النمط الذي سيتم تطبيقه تلقائيًا على فقرة جديدة تم إدراجها بعد a فقرة منسقة بالنمط المحدد.
ParagraphFormat { get; }الحصول على تنسيق الفقرة للنمط.
StyleIdentifier { get; }الحصول على معرف النمط المحلي المستقل للنمط المدمج.
Styles { get; }الحصول على مجموعة الأنماط التي ينتمي إليها هذا النمط.
Type { get; }الحصول على نوع النمط (فقرة أو حرف).

طُرق

اسموصف
Equals(Style)يقارن مع النمط المحدد. تتم مقارنة أنماط الأنماط للأنماط المضمنة فقط. لا يتم تضمين افتراضيات الأنماط في المقارنة. تتم مقارنة النمط الأساسي والنمط المرتبط ونمط الفقرة التالية بشكل متكرر.
Remove()إزالة النمط المحدد من المستند.

أمثلة

يوضح كيفية إنشاء نمط فقرة واستخدامه بتنسيق القائمة.

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

// إنشاء نمط فقرة مخصص.
Style style = doc.Styles.Add(StyleType.Paragraph, "MyStyle1");
style.Font.Size = 24;
style.Font.Name = "Verdana";
style.ParagraphFormat.SpaceAfter = 12;

// أنشئ قائمة وتأكد من أن الفقرات التي تستخدم هذا النمط ستستخدم هذه القائمة.
style.ListFormat.List = doc.Lists.Add(ListTemplate.BulletDefault);
style.ListFormat.ListLevelNumber = 0;

// قم بتطبيق نمط الفقرة على الفقرة الحالية لمنشئ المستند، ثم قم بإضافة بعض النص.
builder.ParagraphFormat.Style = style;
builder.Writeln("Hello World: MyStyle1, bulleted list.");

// قم بتغيير نمط منشئ المستندات إلى نمط لا يحتوي على تنسيق قائمة واكتب فقرة أخرى.
builder.ParagraphFormat.Style = doc.Styles["Normal"];
builder.Writeln("Hello World: Normal.");

builder.Document.Save(ArtifactsDir + "Styles.ParagraphStyleBulletedList.docx");

يوضح كيفية إنشاء نمط مخصص وتطبيقه.

Document doc = new Document();

Style style = doc.Styles.Add(StyleType.Paragraph, "MyStyle");
style.Font.Name = "Times New Roman";
style.Font.Size = 16;
style.Font.Color = Color.Navy;
// إعادة تعريف النمط تلقائيًا.
style.AutomaticallyUpdate = true;

DocumentBuilder builder = new DocumentBuilder(doc);

// قم بتطبيق أحد الأنماط من المستند على الفقرة التي يقوم منشئ المستند بإنشائها.
builder.ParagraphFormat.Style = doc.Styles["MyStyle"];
builder.Writeln("Hello world!");

Style firstParagraphStyle = doc.FirstSection.Body.FirstParagraph.ParagraphFormat.Style;

Assert.AreEqual(style, firstParagraphStyle);

// قم بإزالة النمط المخصص لدينا من مجموعة أنماط المستند.
doc.Styles["MyStyle"].Remove();

firstParagraphStyle = doc.FirstSection.Body.FirstParagraph.ParagraphFormat.Style;

// أي نص يستخدم نمطًا تمت إزالته يعود إلى التنسيق الافتراضي.
Assert.False(doc.Styles.Any(s => s.Name == "MyStyle"));
Assert.AreEqual("Times New Roman", firstParagraphStyle.Font.Name);
Assert.AreEqual(12.0d, firstParagraphStyle.Font.Size);
Assert.AreEqual(Color.Empty.ToArgb(), firstParagraphStyle.Font.Color.ToArgb());

أنظر أيضا