العمل مع سمات المستند
العمل مع سمات المستند
يوضح هذا الدليل كيفية قراءة وتخصيص نظام الألوان والخطوط الذي تشاركه مستندات Word مع تطبيقات Office الأخرى – سمة المستند – باستخدام Theme, ThemeColors، و ThemeFonts in Aspose.Words FOSS لـ .NET. سمة المستند هي اللوحة وتوافق الخطوط التي يشير إليها التنسيق المدرك للثيم في أماكن أخرى من نموذج الكائنات بدلاً من ترميز لون أو اسم خط محدد صراحةً.
كائن السمة
Document.Theme يُعيد مثال Theme للمستند. Theme.Colors هو كائن ThemeColors يحتوي على ألوان السمة الاثني عشر للمستند؛ Theme.MajorFonts وTheme.MinorFonts هما كائنات ThemeFonts تحتفظ بمجموعة خطوط العناوين والنص الأساسي على التوالي.
ألوان السمة
ThemeColors يعرض اثني عشر قابل للكتابة Color خصائص: Dark1, Light1, Dark2, Light2, Accent1 through Accent6, Hyperlink، و FollowedHyperlink. كائنات التنسيق في أماكن أخرى من المستند – Border.ThemeColor, Shading.ForegroundPatternThemeColor / BackgroundPatternThemeColor, Fill.ForeThemeColor / BackThemeColor, Stroke.ForeThemeColor / BackThemeColor, و Font.ThemeColor – احتفظ بـ ThemeColor قيمة تعداد (Dark1, Light1, Dark2, Light2, Accent1-Accent6, Hyperlink, FollowedHyperlink, بالإضافة إلى Text1, Text2, Background1, Background2, و None) التي تحدد which ينطبق خانة لون السمة؛ الفعلية Color القيمة لتلك الخانة تأتي من المقابل ThemeColors خاصية تشغيل Document.Theme.Colors.
خطوط السمة
ThemeFonts يعرِّف ثلاث خصائص string قابلة للكتابة: Latin (لأحرف اللاتينية)، EastAsian، وComplexScript — أسماء الخطوط المستخدمة لكل نص عندما يُؤجّل كائن التنسيق إلى السمة. Font.ThemeFont، ThemeFontAscii، ThemeFontFarEast، ThemeFontOther، وThemeFontBi كلٌ منها يحمل قيمة تعداد ThemeFont (Major، Minor أو None) تحدد ما إذا كان كائن Font معين يُؤجّل إلى Theme.MajorFonts أو Theme.MinorFonts لنطاق نصي معين، بدلاً من تخزين اسم خط صريح خاص به.
نصائح وأفضل الممارسات
- غيّر لونًا عبر جميع الحدود، الظلال، التعبئة، والخطوط المتوافقة مع السمة في تعديل واحد عن طريق تحديث خاصية
ThemeColorsذات الصلة علىDocument.Theme.Colors، بدلاً من التنقل عبر المستند لتحديث كل كائن تنسيق على حدة. - تحقّق ما إذا كانت خاصية
ThemeColorأوThemeFontلكائن التنسيق هيNoneقبل افتراض أنها تُؤجّل إلى السمة —Noneيعني أنها تحملColorصريحًا أو اسم خط خاص بها بدلاً من ذلك. Theme.MajorFontsعادةً ما يوفّر خطوط العناوين وTheme.MinorFontsخطوط النص الأساسي، متطابقًا مع مُختار خطوط السمة الخاص بـ Word.
مشكلات شائعة
| مشكلة | السبب | الإصلاح |
|---|---|---|
تغيير Document.Theme.Colors.Accent1 لا يؤثر على تعبئة الشكل | Fill.ForeThemeColor الخاص بالشكل هو ThemeColor.None، لذا يستخدم لونًا صريحًا بدلاً من فتحة السمة | عيّن Fill.ForeThemeColor إلى قيمة ThemeColor المطلوبة بحيث يُحيل إلى السمة |
الخط المعروض لـ Font لا يتطابق مع Theme.MajorFonts.Latin | الـ Font.ThemeFont (أو المتغير الخاص بالسكريبت) هو ThemeFont.None، لذا يُستخدم اسم الخط نفسه بدلاً من ذلك | قم بتعيين الخاصية ThemeFont ذات الصلة إلى Major أو Minor |
FAQ
كيف أقرأ ألوان سمة المستند؟
اقرأ Document.Theme.Colors، كائن ThemeColors يحتوي على خصائص Color لكل من الفتحات الاثني عشر لألوان السمة — Dark1, Light1, Dark2, Light2, Accent1-Accent6, Hyperlink, وFollowedHyperlink.
كيف يمكنني تغيير لون التمييز في المستند في كل مكان يُستخدم فيه؟
عيّن Document.Theme.Colors.Accent1 (أو أي فتحة تمييز) إلى Color جديد؛ كل كائن تنسيق تكون خاصية ThemeColor الخاصة به تشير إلى تلك الفتحة سيستقبل التغيير.
ما الفرق بين ThemeColors وThemeColor؟
يُعد ThemeColors (على Document.Theme.Colors) هو الكائن الذي يحمل القيم الـ12 الفعلية لـColor للمستند. ThemeColor هو التعداد (enum) المستخدم في أماكن أخرى (Border, Shading, Fill, Stroke, Font) للإشارة إلى إحدى تلك الفتحات بالاسم بدلاً من تخزين اللون مباشرة.
كيف يمكنني تحديد الخط السمة الذي يستخدمه كائن Font؟
عيّن Font.ThemeFont (أو ThemeFontAscii / ThemeFontFarEast / ThemeFontOther / ThemeFontBi الخاصة بالنص) إلى ThemeFont.Major أو ThemeFont.Minor؛ ثم يأتي اسم الخط الفعلي من Document.Theme.MajorFonts أو MinorFonts.
API Reference ملخص
| فئة / تعداد | وصف |
|---|---|
Theme | سمة المستند، عبر Document.Theme؛ MajorFonts، MinorFonts، Colors |
ThemeColors | اثنا عشر فتحة سمة Color: Dark1, Light1, Dark2, Light2, Accent1-Accent6, Hyperlink, FollowedHyperlink |
ThemeFonts | أسماء خطوط السمة حسب النص: Latin, EastAsian, ComplexScript |
ThemeColor | تعداد يحدد فتحة لون السمة؛ يُستخدم بواسطة Border, Shading, Fill, Stroke, Font |
ThemeFont | تعداد يحدد استخدام خط السمة Major/Minor؛ يُستخدم بواسطة Font |
